Docker部署Nginx调用API时X-Forwarded-For请求头过长错误

问题根因 #

172.18.0.1是Docker默认bridge网桥的网关IP，出现重复填充是因为Nginx配置中每次转发请求时都追加当前客户端IP（即Docker网关IP），而非正确处理原始客户端IP或重置该头部。当请求被多次转发（或配置错误导致循环追加），X-Forwarded-For字段会不断积累该IP，最终超过Nginx默认的large_client_header_buffers限制，触发400错误。

针对性解决方案 #

场景1：Nginx作为反向代理转发外部请求到API #

修改反向代理配置，仅在接收外部请求时设置X-Forwarded-For，避免重复追加：

server {
    listen 80;
    server_name your-app-domain;

    location /assets/ {
        # 重置头部，仅保留原始客户端IP
        proxy_set_header X-Forwarded-For $remote_addr;
        # 配置其他必要代理头部
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Host $http_host;

        proxy_pass http://your-api-backend:port; # 替换为实际API地址
    }
}

若存在多层代理（如前端已有一层Nginx），可改为proxy_set_header X-Forwarded-For "$remote_addr, $http_x_forwarded_for"，但需确保仅最外层代理负责追加原始IP，内层代理直接转发该头部。

场景2：Nginx作为Docker内部主动调用API的客户端 #

若Nginx是主动发起请求到外部API，需检查是否存在请求循环，并显式重置X-Forwarded-For：

location /api-call {
    # 清空X-Forwarded-For，避免携带Docker网关IP
    proxy_set_header X-Forwarded-For "";
    proxy_set_header Host $http_host;
    proxy_pass https://target-api-domain.com/assets/6/meters.json?gridserver=true;
}

临时应急方案（治标不治本） #

若需快速恢复服务，可临时调大Nginx头部缓冲区大小：

http {
    # 将缓冲区从默认4k调整为8k（可按需增大）
    large_client_header_buffers 4 8k;
}

验证步骤 #

1. 重载Nginx配置：docker exec -it your-nginx-container nginx -s reload
2. 发起测试请求，检查API端日志，确认X-Forwarded-For字段无重复IP
3. 查看Nginx错误日志（/var/log/nginx/error.log），确认“client sent too long header line”错误不再出现

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