Nginx高可用架构下请求头丢失本质是多层代理中配置不一致所致，需在所有Nginx节点的http块统一启用underscores_in_headers on，并在每层location中显式用proxy_set_header透传自定义头，同时禁用ignore_invalid_headers并调大large_client_header_buffers以确保完整传递。
高可用架构下 Nginx 请求头丢失，本质不是“高可用”本身导致的，而是多层代理叠加后，每层对请求头的默认处理策略被重复忽略或遗漏。问题往往藏在配置一致性、字段合法性、以及转发链路完整性上。
确保所有 Nginx 节点统一启用下划线支持
高可用通常包含多个 Nginx 实例（如主备、集群或负载均衡层），而 underscores_in_headers 是按 http/server 块生效的指令，默认为 off。只要其中任意一层未开启，带下划线的请求头（如 api_key_id、request_id）就会被静默丢弃。
- 必须在所有参与转发的 Nginx 配置的
http{}块中显式写入：underscores_in_headers on; - 不要只加在某台机器的 server 块里——上游 Nginx 若未开启，下游即使开了也收不到原始字段
- 验证方式：在任一节点用
curl -H "test_header: 1" http://nginx-ip/，再检查日志或后端是否收到$http_test_header
每一层代理都需显式透传关键自定义头
即使开启了下划线支持，Nginx 默认也不会自动把客户端头转发给后端；它只传递少数标准头（如 Host、User-Agent）。自定义头必须逐层手动声明。
- 在每层的
location块中，为每个需要透传的头添加：proxy_set_header Header-Name $http_header_name; - 注意命名转换：HTTP 头
Api-Key对应变量$http_api_key；X-Request-ID对应$http_x_request_id；api_key_value对应$http_api_key_value - 避免漏配：比如 A → B → C 链路，A 到 B 要设
proxy_set_header api_key_id $http_api_key_id;，B 到 C 也得同样配置一次
禁用无效头过滤并校验 header 大小限制
高可用部署常启用 ignore_invalid_headers on（默认值），它会与 underscores_in_headers off 协同作用，进一步屏蔽非常规头名。同时，过大的 header 可能被截断。
- 确认没有全局或局部设置
ignore_invalid_headers on；如有，建议改为off，或至少确保与underscores_in_headers on共存 - 检查
large_client_header_buffers是否足够（默认 4×8k）；若请求头含大量 token 或加密数据，可适当调大，例如：large_client_header_buffers 8 16k; - 通过
error_log /path/to/log warn;并触发请求，观察是否有client sent invalid header line类警告
用端到端测试快速定位丢失环节
别靠猜——在高可用链路中逐跳验证 header 是否存活，是最高效的排查方式。
- 从客户端发起带标记头的请求：
curl -H "X-Trace-ID: abc123" -H "api_key_id: test" https://your-domain/api - 在每一层 Nginx 的
log_format中加入$http_x_trace_id $http_api_key_id，查看 access log 是否记录 - 在中间层 Nginx 的 location 中临时返回头内容（如用 echo 模块或 stub_status），确认该层是否收到
- 最终后端服务打印全部 received headers，比对哪一跳开始缺失
