Nginx默认不拦截非X-Accel-前缀的自定义响应头（如X-My-Header），若未透传，主因是被proxy_hide_header显式隐藏或后端未发送；应删掉proxy_hide_header相关行，而非使用已废弃的proxy_pass_header。
要让 Nginx 强制透传被默认拦截的自定义响应头（比如 X-My-Header），关键不是用 proxy_pass_header，而是正确使用 proxy_hide_header 和 add_header 的组合，或更直接地——**取消隐藏**。
理解 Nginx 默认行为：哪些头被自动隐藏？
Nginx 默认会过滤掉部分响应头，防止后端泄露敏感信息。被拦截的常见头包括：Server、X-Powered-By、X-Accel-Redirect、X-Accel-Expires、X-Accel-Limit-Rate 等。但注意：所有以 X-Accel- 开头的头都会被无条件屏蔽，且无法通过 proxy_pass_header 恢复。
而你自定义的头（如 X-Trace-ID、X-Backend-Version）只要不带 X-Accel- 前缀，默认不会被拦截 —— 如果没透传，大概率是后端根本没发，或被 proxy_hide_header 显式隐藏了。
正确启用自定义头透传的两种方式
✅ 推荐方式一：显式取消隐藏（最可靠）
- 在
location或server块中添加：proxy_hide_header X-My-Header; - ⚠️ 注意：这不是“隐藏”，而是“取消隐藏”——因为 Nginx 默认不隐藏它；写这一行实际是告诉 Nginx “别管这个头，允许透传”。
- 如果之前配置了全局
proxy_hide_header X-My-Header;（即想隐藏），现在只需删掉或注释掉即可恢复透传。
✅ 推荐方式二：用 add_header + $sent_http_* 变量（适用于需二次加工场景）
- 若需修改或补全头内容，可这样透传并覆盖：
add_header X-My-Header $sent_http_x_my_header always; -
$sent_http_x_my_header是 Nginx 内部变量，代表上游响应中的原始头值（小写下划线转短横线，如X-My-Header→$sent_http_x_my_header）。 -
always参数确保即使上游返回非 2xx 状态码也透传。
为什么 proxy_pass_header 基本无效？
proxy_pass_header 是一个已废弃且几乎不生效的指令（Nginx 0.7+ 中仅保留语法兼容，实际被忽略）。官方文档明确说明：它不能用于恢复被 proxy_hide_header 隐藏的头，也不能绕过 X-Accel- 的硬性拦截。
所以：不要写 proxy_pass_header X-My-Header;，写了也没用。
验证是否生效的实操步骤
- 重启 Nginx：
nginx -t && nginx -s reload - 用 curl 检查响应头：
curl -I http://your-domain.com/api/test - 确认后端确实返回了该头（先绕过 Nginx 直连后端测试）
- 检查 Nginx error log 是否有警告，例如：
upstream sent too big header（可能因头过大触发缓冲区限制，需调大proxy_buffer_size）
不复杂但容易忽略：重点不在“加什么”，而在“删什么”或“不拦什么”。看清默认规则，少走弯路。
