Nginx转发X-Response-Time等自定义响应头需显式配置proxy_pass_header X-Response-Time;，因默认仅传递标准响应头；须确保后端已设置该头，且未被proxy_hide_header或缓存配置覆盖。
要在 Nginx 中转发带有响应时间的 Header（比如 X-Response-Time），关键不是“生成”该 Header，而是确保它能从上游服务传递到客户端——因为响应时间通常由后端应用（如 Spring Boot、Node.js）在处理完请求后注入响应头中。Nginx 默认会过滤掉部分非标准响应头，所以需显式启用透传。
确认上游已输出 X-Response-Time
首先确保后端服务在响应中确实设置了该 Header，例如：
- Spring Boot：通过 Filter 或 Interceptor 添加
response.setHeader("X-Response-Time", "127ms") - Express.js：
res.set('X-Response-Time', '89ms') - 若未设置，Nginx 无法转发一个不存在的 Header
启用响应头透传（proxy_pass_header）
Nginx 默认只传递有限的响应头（如 Content-Type、Server）。要让 X-Response-Time 不被丢弃，必须在 location 或 upstream 块中明确声明：
- 添加
proxy_pass_header X-Response-Time; - 该指令必须出现在
proxy_pass所在的 location 块内 - 可同时透传多个自定义响应头，如：
proxy_pass_header X-Trace-ID; proxy_pass_header X-Env;
避免响应头被覆盖或清除
以下配置可能意外清空或屏蔽自定义响应头，需检查并调整：
- 不要使用
proxy_hide_header X-Response-Time;（会主动隐藏） - 避免全局
underscores_in_headers on;干扰（该指令仅影响请求头解析，与响应头无关） - 若启用了缓存（proxy_cache），需确认
proxy_cache_use_stale或add_header没有覆盖原始响应头
验证是否生效
部署后，用 curl 测试实际响应头：
curl -I http://your-domain.com/api/test- 观察返回中是否包含
X-Response-Time: xxxms - 若无，检查 Nginx error log 是否报类似
upstream sent no more response headers的警告
