需显式启用 Nginx 透传非标自定义 Header：清空 proxy_hide_header 默认屏蔽，用 proxy_pass_header 放行目标头，含下划线头须开启 underscores_in_headers on，并避免 proxy_set_header 覆盖或相关模块干扰。
要透传后端负载均衡节点下发的非标准业务自定义 Header（如 X-Trace-ID、X-App-Version、X-Backend-Node 等），仅靠默认 Nginx 配置是不够的——Nginx 默认会过滤掉大部分非 RFC 标准头，尤其是含下划线或大小写混合的自定义头。关键在于显式启用透传，并确保整个链路（上游 → Nginx → 下游）不丢失。
确认并启用 proxy_pass_header 透传指定头
proxy_pass_header 并非用于“添加”头，而是解除 Nginx 对特定响应头的屏蔽，允许其从 upstream 响应中原样传递给客户端。它必须与 proxy_hide_header 配合使用（后者默认会隐藏很多非标头）：
- 先用
proxy_hide_header清空默认屏蔽列表（可选但推荐）：proxy_hide_header "";—— 注意：空字符串表示清空所有隐式屏蔽（Nginx 1.17.6+ 支持；旧版本需逐个取消） - 再用
proxy_pass_header显式放行目标头：proxy_pass_header X-Trace-ID;proxy_pass_header X-App-Version; - 若头名含下划线（如
X_Backend_Node），需确保 Nginx 编译时启用了--with-http underscores_in_headers，并在配置中设置：underscores_in_headers on;（否则会被直接丢弃）
避免 proxy_set_header 覆盖或干扰
如果在 location 中误用了 proxy_set_header 重写同名请求头，可能影响后端行为；更关键的是，某些模块（如 ngx_http_realip_module）或全局 underscores_in_headers off 设置会静默丢弃带下划线的头。检查点包括：
- 确认没有在该 location 或 http/server 块中设置
proxy_set_header X-Trace-ID ...—— 这会覆盖后端返回的值 - 检查是否有
underscores_in_headers off;（尤其在 http 块），它会导致X_Backend_Node类头被直接忽略 - 禁用可能干扰的模块，例如临时注释
real_ip_header相关配置，排除 IP 伪造逻辑对 header 解析的影响
验证透传是否生效（三步定位法）
不要只看浏览器开发者工具——它可能因缓存或跨域限制隐藏响应头。建议分层验证：
-
查 Nginx error.log：开启
error_log /path/to/error.log debug;，搜索http proxy header相关日志，确认 Nginx 是否收到并尝试发送该头 -
用 curl -v 直连 Nginx：
curl -v https://your.domain/api/test—— 观察响应头中是否出现目标字段（注意大小写和拼写） -
抓包比对 upstream 原始响应：在 upstream 服务器上用
tcpdump或strace -e trace=sendto,recvfrom -p $(pidof your_app)，确认后端确实发出了该头，且内容正确
兼容性与替代方案（当 proxy_pass_header 不适用时）
某些场景下 proxy_pass_header 不起作用（如使用 sub_filter 或流式响应），可考虑：
- 用
add_header+ 变量捕获（需 Nginx ≥ 1.7.5）：proxy_buffering off;add_header X-Trace-ID $upstream_http_x_trace_id always;—— 利用内置变量映射响应头 - 若后端通过 Set-Cookie 下发，注意
proxy_pass_header Set-Cookie是默认开启的，无需额外配置 - 对于 gRPC 或 HTTP/2 流式响应，优先使用
$upstream_http_*变量 +add_header，更稳定可靠
