排查Nginx多层反向代理Header重复累加，需定位错误透传或重写的代理层，重点检查X-Forwarded-For等字段是否被多次追加，并通过curl、日志和map指令精准识别与修复。
排查 Nginx 多层反向代理中请求头字段重复累加，核心在于定位哪一层代理错误地透传或重写了同名 Header（如 X-Forwarded-For、X-Real-IP、Host 等），并确保每层只做一次追加或覆盖。
确认哪些 Header 出现了重复累加
用 curl -v 或浏览器开发者工具查看原始请求和响应的完整 Header。重点关注：
-
X-Forwarded-For：多个 IP 用逗号分隔（如192.168.1.10, 10.0.0.5, 10.0.0.3），层数越多越长，说明中间有代理重复追加 -
X-Forwarded-Proto或X-Forwarded-Port：出现多次同名字段（HTTP/2 允许重复，但 HTTP/1.1 严格应合并，Nginx 默认会合并，若看到多行则可能被上游或下游非标准处理） - 自定义 Header（如
X-Request-ID）：被多层代理都设置，导致值重复或覆盖异常
检查每层 Nginx 的 proxy_set_header 配置
Nginx 默认不会自动追加 X-Forwarded-For，只有显式配置 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 才会追加。问题往往出在：
- 某层用了
$proxy_add_x_forwarded_for（它会在原有值后追加$remote_addr），而上游已提供完整链路，导致重复 - 某层错误使用
$http_x_forwarded_for或硬编码字符串，造成叠加 - 同一配置块中多次出现
proxy_set_header X-Forwarded-For ...，后定义的会覆盖前一个，但若逻辑分支多（如 if 块），可能意外触发多次设置
✅ 正确做法：最外层（接入层）用 $proxy_add_x_forwarded_for；内层（如服务网关到应用）建议用 $remote_addr 覆盖，或直接不设（由上一层保证），避免层层叠加。
启用 Nginx 日志记录原始与透传 Header
在 http 或 location 块中添加自定义日志格式，捕获关键 Header：
log_format header_debug '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_x_forwarded_for" "$http_x_real_ip" '
'"$upstream_http_x_forwarded_for" "$upstream_http_x_real_ip"';然后在 access_log 中使用该格式。对比 $http_x_forwarded_for（客户端来）和 $upstream_http_x_forwarded_for（发给上游的），就能看出本层是否做了不当修改。
用 map 指令做 Header 预处理（推荐用于统一清理）
在 http 块中用 map 提前标准化 X-Forwarded-For，避免每层手动判断：
map $http_x_forwarded_for $xff_clean {
"" $remote_addr;
~^(.+),\s*$remote_addr$ $1;
default $http_x_forwarded_for;
}
# 然后在 location 中：
proxy_set_header X-Forwarded-For $xff_clean;这样可确保即使上游已带值，本层也不会重复追加自己的地址。
不复杂但容易忽略：只要有一层没按规范配置，整条链路的 Header 就可能失真。建议从最外层开始逐级抓包验证，配合日志和 map 清洗，基本能准确定位并修复重复累加问题。
