Java中如何获取请求的完整URL？

Question

在Java Web开发中，如何准确获取请求的完整URL是一个常见问题。开发者经常需要从HttpServletRequest对象中提取完整的请求URL，包括协议、域名、端口、路径以及查询参数。虽然request.getRequestURL()方法可以返回请求的基本URL，但它不包含查询参数。若需获取完整的URL，包括查询字符串，应结合request.getRequestURL()与request.getQueryString()方法。此外，在反向代理或负载均衡环境下，获取真实的请求URL可能需要读取X-Forwarded-For等HTTP头信息。因此，如何在不同部署环境下正确拼接出客户端发起的完整URL，是开发和调试过程中必须掌握的技能。

Answer 1

一、基础概念：Java Web开发中URL的组成结构

在Java Web应用中，完整的请求URL通常由以下几个部分组成：

• 协议（Protocol）：如http或https
• 主机名（Host）：例如www.example.com
• 端口（Port）：默认80或443，也可自定义
• 路径（Path）：如 /api/v1/user
• 查询参数（Query String）：如 ?id=123&name=test

通过HttpServletRequest对象可以获取这些信息。

二、基本方法：使用request.getRequestURL()与request.getQueryString()

Java Servlet API提供了如下两个关键方法：

方法名称	描述	示例输出
request.getRequestURL()	返回包括协议、域名、端口和路径的URL	http://example.com:8080/myapp/path
request.getQueryString()	返回查询字符串部分	id=123&name=test

开发者可以通过拼接这两个值来构造完整的URL：

StringBuffer requestURL = request.getRequestURL();
String queryString = request.getQueryString();
String fullURL = (queryString == null) ? requestURL.toString() : requestURL.append("?").append(queryString).toString();

三、进阶处理：反向代理环境下的真实URL获取

当部署在反向代理或负载均衡环境下时，直接读取host头可能导致错误。此时应考虑读取以下HTTP头信息：

• X-Forwarded-Proto
• X-Forwarded-Host
• X-Forwarded-For

例如，获取真实的协议和主机名：

String proto = request.getHeader("X-Forwarded-Proto");
String host = request.getHeader("X-Forwarded-Host");

构建完整URL的逻辑也需相应调整：

String scheme = proto != null ? proto : request.getScheme();
String serverName = host != null ? host : request.getServerName();
int serverPort = request.getServerPort();
String path = request.getRequestURI();
String query = request.getQueryString();

String fullURL = scheme + "://" + serverName +
    (serverPort != 80 && serverPort != 443 ? ":" + serverPort : "") +
    path + (query != null ? "?" + query : "");

四、流程分析：从客户端到服务器端的URL解析流程

下图展示了客户端发起请求后，服务器如何逐步解析并还原完整URL的过程：

graph TD
            A[Client Request] --> B[Reverse Proxy]
            B --> C[Load Balancer]
            C --> D[Web Server]
            D --> E[Application Server]
            E --> F{Check X-Forwarded Headers}
            F -- Yes --> G[Use X-Forwarded Values]
            F -- No --> H[Use Local Values]
            G --> I[Build Full URL]
            H --> I

五、最佳实践：构建通用的URL获取工具类

为了提高代码复用性，建议封装一个工具类来统一处理URL的获取逻辑：

public class URLUtils {
    public static String getFullRequestURL(HttpServletRequest request) {
        String proto = request.getHeader("X-Forwarded-Proto");
        String host = request.getHeader("X-Forwarded-Host");

        String scheme = proto != null ? proto : request.getScheme();
        String serverName = host != null ? host : request.getServerName();
        int serverPort = request.getServerPort();
        String path = request.getRequestURI();
        String query = request.getQueryString();

        return scheme + "://" + serverName +
               (serverPort != 80 && serverPort != 443 ? ":" + serverPort : "") +
               path + (query != null ? "?" + query : "");
    }
}