Spring Boot 3 Webflux中X-Forwarded-Host带端口返回400问题排查

我基于spring-boot-starter-webflux搭建了Spring Boot 3服务，核心端点代码如下：

@RestController
public class TestController {

    @GetMapping("/test")
    public String test() {
        return "test";
    }
}

服务运行在8080端口时，携带X-Forwarded-Host: localhost的curl请求可正常返回200：

% curl -v -H "X-Forwarded-Host: localhost" http://localhost:8080/test
*   Trying 127.0.0.1:8080...
* Connected to localhost (127.0.0.1) port 8080 (#0)
> GET /test HTTP/1.1
> Host: localhost:8080
> User-Agent: curl/7.86.0
> Accept: */*
> X-Forwarded-Host: localhost
>
< HTTP/1.1 200 OK
< Content-Type: text/plain;charset=UTF-8
< Content-Length: 4
<
test%

但当X-Forwarded-Host值包含端口（如localhost:8080）时，请求直接返回400错误：

% curl -v -H "X-Forwarded-Host: localhost:8080" http://localhost:8080/test
*   Trying 127.0.0.1:8080...
* Connected to localhost (127.0.0.1) port 8080 (#0)
> GET /test HTTP/1.1
> Host: localhost:8080
> User-Agent: curl/7.86.0
> Accept: */*
> X-Forwarded-Host: localhost:8080
>
< HTTP/1.1 400 Bad Request
< content-length: 0
<

针对这个现象，以下是两个疑问的解答：

1. X-Forwarded-Host头是否允许包含端口？ #

HTTP标准中的Host头确实支持host:port格式（非标准端口时必填），但X-Forwarded-Host作为反向代理传递客户端原始请求Host的自定义头，规范上要求仅传递主机名或IP地址，端口信息应通过X-Forwarded-Port头单独传递。不过实际场景中部分反向代理会直接将带端口的完整Host值写入X-Forwarded-Host，这会与部分Web框架的校验规则冲突。

2. 是Spring Boot的Bug还是Nginx配置错误？ #

这既不是Spring Boot的Bug，也不算Nginx的配置错误，而是两者的约定不一致导致的：

• Spring Boot 3的WebFlux模块默认对X-Forwarded-Host的格式做严格校验，不允许包含端口号，检测到不符合格式的值时直接返回400。
• 如果Nginx配置中把带端口的完整Host值（比如直接使用$host变量）赋值给X-Forwarded-Host，就会触发这个校验失败。

解决办法 #

有两种可行的处理方式：

• 调整Nginx配置：让X-Forwarded-Host仅传递纯主机名，端口通过X-Forwarded-Port单独传递。示例配置：

  proxy_set_header X-Forwarded-Host $hostname;
  proxy_set_header X-Forwarded-Port $server_port;
  

  若需保留原始请求的端口，可通过变量提取纯主机名部分赋值给X-Forwarded-Host。
• 放松Spring WebFlux的Host校验：在配置文件中添加如下配置，关闭严格的Host格式校验：

  server:
    forward-headers-strategy: framework
    http:
      host-header: relaxed
  

内容的提问来源于stack exchange，提问作者Mark