HSTS头丢失是因mTLS专用location未显式声明add_header——Nginx不继承头部,仅最后一级生效,需在所有响应路径(含proxy_pass、error_page)中用always参数重复配置。

当 Nginx 同时启用 HSTS 和 mTLS(双向 TLS)时,HSTS 响应头突然丢失,通常不是因为 mTLS 本身禁用了 HSTS,而是两者在配置层级、响应路径或条件分支中发生了隐性冲突。排查需聚焦“谁在响应”“响应是否被覆盖”“是否根本没走到加头逻辑”这三个关键点。
确认 HSTS 是否仍由 Nginx 发送(而非后端服务)
mTLS 常用于反向代理场景(如 Nginx 做客户端证书校验后 proxy_pass 给上游),此时需明确:HSTS 头应由 Nginx 主动添加,而不是依赖上游服务返回。若上游(如 Go/Java 应用)也设置了 HSTS,可能因 Nginx 默认不继承响应头而造成“看似有、实则丢”:
- 执行 curl -I https://your-domain.com --cert client.crt --key client.key,确保带客户端证书发起 mTLS 请求
- 检查响应中是否有 Strict-Transport-Security;若没有,说明该请求路径未触发 Nginx 的 add_header 指令
- 对比普通 HTTPS 请求(不带 client cert)的响应头——若普通请求有 HSTS 而 mTLS 请求没有,问题就出在 mTLS 对应的 location 或 server 块中漏配了 add_header
检查 mTLS 相关 location 块是否覆盖了 HSTS 配置
Nginx 的 add_header 不继承、不叠加、只保留最后一级定义。常见错误是:为启用 mTLS 单独写了 location /api 或 location ~ \.grpc$,并在其中配置了 ssl_client_certificate 和 ssl_verify_client on,却忘了在里面重复声明 HSTS:
- 即使顶层 server 块写了
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;,只要请求命中某个子 location 且该 location 里没写 add_header,HSTS 就不会出现 - 特别注意 proxy_pass 类 location:mTLS 验证成功后,Nginx 默认不转发原始响应头,也不会自动补上外层定义的 header,必须显式加
- 正确做法:所有可能返回业务响应的 location(包括 mTLS 专用路径),都应包含带 always 参数的 add_header,例如:
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;
验证 mTLS 握手失败路径是否意外干扰了 HSTS 发送
mTLS 配置不当可能导致部分请求被拒绝在 TLS 层(如 400 Bad Request 或直接断连),但更隐蔽的情况是:Nginx 在 ssl_verify_client failed 时返回的是自定义 error_page(如 495/496 状态码),而这些 error_page 对应的 location 往往没有配置任何 add_header:
- 用 curl 模拟非法客户端证书:
curl -I https://your-domain.com --cert bad.crt --key bad.key - 观察返回状态码(常见为 495 或 496)及响应头——若此处缺失 HSTS,说明 error_page location 未声明 header;虽然这不影响正常流量,但会暴露配置疏漏
- 建议为所有 error_page location 显式添加 HSTS(尤其 495/496),避免安全策略不一致
排除证书链与响应头顺序干扰
虽然 HSTS 是 HTTP 响应头,但 mTLS 场景下若证书链不完整(如缺少中间 CA),某些客户端或工具(如 openssl s_client)可能无法完成握手,导致根本拿不到 HTTP 响应——看起来像“HSTS 丢失”,实则是连接失败:
- 运行:
echo | openssl s_client -connect your-domain.com:443 -servername your-domain.com -cert client.crt -key client.key 2>/dev/null | grep "Verify return code" - 期望返回 Verify return code: 0 (ok);若为 21(unable to verify the first certificate)或 20(unable to get local issuer certificate),说明服务端证书链发送不全,需检查
ssl_certificate是否指向 fullchain.pem(含中间证书) - 只有握手成功后,Nginx 才会进入 HTTP 处理阶段并执行 add_header











