java：获取请求url地址（附带源码）

在 Java Web 应用中，要拿到客户端发过来的完整请求 URL，通常都是在 Servlet 或 Spring MVC 的控制器里，通过注入 HttpServletRequest 来获取。下面给出几种常见场景的示例。

1. 在 Servlet 中获取

import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

public class UrlDemoServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response) 
            throws IOException {
        // 获取到类似 "http://example.com:8080/app/path/to/servlet"
        StringBuffer url = request.getRequestURL();

        // 如果还想要问号后面的查询串，比如 "?a=1&b=2"
        String queryString = request.getQueryString(); // 可能为 null

        String fullUrl = (queryString == null) 
            ? url.toString() 
            : url.append('?').append(queryString).toString();

        response.getWriter().write("Full URL: " + fullUrl);
    }
}

• request.getRequestURL() 返回 StringBuffer，包含协议、服务器名、端口、上下文路径和 servlet 路径。

• request.getQueryString() 返回 URL 中 ? 后的那部分（不含 ? 本身），如果没有查询参数则为 null。

2. 在 Spring MVC 控制器中获取

import javax.servlet.http.HttpServletRequest;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class UrlDemoController {

    @GetMapping("/demo")
    @ResponseBody
    public String demo(HttpServletRequest request) {
        StringBuffer url = request.getRequestURL();
        String qs  = request.getQueryString();
        return (qs == null) ? url.toString() : url.append('?').append(qs).toString();
    }
}

Spring 会自动把 HttpServletRequest 注入到方法参数里，使用方式与 Servlet 一样。

3. 在过滤器（Filter）里获取

import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;

public class UrlLoggingFilter implements Filter {
    @Override
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)
            throws IOException, ServletException {
        HttpServletRequest request = (HttpServletRequest) req;
        StringBuffer url = request.getRequestURL();
        String qs  = request.getQueryString();
        String fullUrl = (qs == null) ? url.toString() : url.append('?').append(qs).toString();
        System.out.println("Incoming request URL: " + fullUrl);
        chain.doFilter(req, res);
    }
}

过滤器常用于打印日志、鉴权、统一处理。

4. 拿到更精细的各部分

• request.getScheme()：协议（http 或 https）

• request.getServerName()：主机名或 IP

• request.getServerPort()：端口号

• request.getContextPath()：应用上下文路径（部署时的 app 名）

• request.getServletPath()：Servlet 映射路径

• request.getPathInfo()：额外的路径信息

• request.getQueryString()：查询串（不含 ?）

如果你需要在反向代理（Nginx、F5）后还拿到原始请求的主机名和协议，就要结合 X-Forwarded-Proto / X-Forwarded-Host 等头部来重组：

String proto = request.getHeader("X-Forwarded-Proto");
if (proto == null) proto = request.getScheme();

String host  = request.getHeader("X-Forwarded-Host");
if (host == null) host = request.getServerName();

String port  = request.getHeader("X-Forwarded-Port");
if (port == null) port = String.valueOf(request.getServerPort());

String fullUrl = proto + "://" + host + (port.isEmpty() ? "" : ":" + port)
               + request.getRequestURI()
               + (qs == null ? "" : "?" + qs);

5. 客户端（HTTP 客户端库）获取请求 URL

如果你是在客户端代码中（比如用 Apache HttpClient、OkHttp）想拿到自己发出的请求 URL：

• Apache HttpClient

  HttpGet get = new HttpGet("https://api.example.com/data?x=1");
  System.out.println(get.getURI());  // 输出 URI 对象
  

• OkHttp

  Request req = new Request.Builder()
      .url("https://api.example.com/data?x=1")
      .build();
  System.out.println(req.url());  // okio.HttpUrl 对象
  

以上就是在各种常见场景下“Java：获取请求 URL 地址”的做法，按需选用即可。