证书没过期、链也没问题,客户端却报“域名不匹配”:一次 nginx 默认 server 抢答的复盘

一次 TLS 故障复盘:新域名证书签发部署都正常,部分请求却拿到另一张不相关的证书。根因是 nginx 没有匹配到 SNI 对应的 server 块,回退到了默认 server 的证书。记录症状、排查路径和预防做法。

本文目录
证书没过期、链也没问题,客户端却报“域名不匹配”:一次 nginx 默认 server 抢答的复盘

故障现场长这样:新上线的 api.example.com 证书刚签好,文件落盘了,nginx 配置也写了 ssl_certificate 指向新证书。自己的浏览器一测,绿的。准备收工,结果监控探针开始报 x509: certificate is valid for static.example.com, not api.example.com。

更迷惑的是,报错的不是全部请求——办公室里大部分人访问都正常,只有几条探针和一台老客户端一直炸。

症状核对

遇到“域名不匹配”类报错,先把三件事分开确认,别急着怀疑证书签错了:

  • 证书文件本身对不对:openssl x509 -in api.pem -noout -text | grep -A1 "Subject Alternative Name",确认 SAN 里确实有 api.example.com。
  • 服务器实际下发的是哪张证书:openssl s_client -connect api.example.com:443 -servername api.example.com,看 subject= 和 SAN。
  • 不带 SNI 时下发什么:openssl s_client -connect api.example.com:443,注意这次故意不加 -servername。
证书没过期、链也没问题,客户端却报“域名不匹配”:一次 nginx 默认 server 抢答的复盘:a new certificate version moving from its source to several edge appliances while the previous working version remains ready for rollback
证书没过期、链也没问题,客户端却报“域名不匹配”:一次 nginx 默认 server 抢答的复盘:a new certificate version moving from its source to several edge appliances while the previous working version remains ready for rollback查看原图

当时的结果很有意思:带 SNI 的请求拿到的是正确的新证书,不带 SNI 的请求拿到的是 static.example.com 的旧证书。破案方向一下子清楚了——问题不在证书,在 nginx 的 server 选择。

根因:默认 server 抢答

nginx 在同一个 listen 443 ssl 上托管多个站点时,靠 TLS 握手里的 SNI 扩展决定用哪个 server 块、用哪张证书。这是关键细节:证书是在握手最早期就要发出去的,nginx 等不到 HTTP 请求头里的 Host,只能看 SNI。

这台机器上 api.example.com 的 server 块因为一次配置合并时被注释掉了,而 static.example.com 的 server 块恰好是 listen 顺序里的第一个,成了事实上的默认 server。于是:

  • 现代浏览器、新版 curl 都发 SNI,但 SNI 匹配不到 api 的块,nginx 就回退到默认 server 的证书——理论上应该报错,可实际上……浏览器拿到错的证书确实该报错。这也是当时排查绕了弯路的地方:真正正常的同事走的是另一条链路(SLB 上有独立的证书绑定),直连源站的探针才踩到这个坑。
  • 老客户端不发 SNI,nginx 无从选择,同样落到默认 server。

也就是说,"有人正常、有人报错"不一定意味着链路缓存或玄学,可能只是不同请求走了不同入口,而入口之间的 TLS 配置不一致。

证书没过期、链也没问题,客户端却报“域名不匹配”:一次 nginx 默认 server 抢答的复盘:a browser-side endpoint independently inspecting the live TLS connection after deployment and comparing the observed endpoint artifact
证书没过期、链也没问题,客户端却报“域名不匹配”:一次 nginx 默认 server 抢答的复盘:a browser-side endpoint independently inspecting the live TLS connection after deployment and comparing the observed endpoint artifact查看原图

修复与验证

修复本身很简单:恢复 api.example.com 的 server 块,nginx -t 通过后 reload。但验证要做两层,别只看浏览器:

# 带 SNI,确认拿到的是 api 的证书
openssl s_client -connect 1.2.3.4:443 -servername api.example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -ext subjectAltName

# 直连源站 IP 验证,绕开 CDN / SLB,确认源站本身没问题

两个要点:一是连源站 IP 而不是域名,排除前面代理层的干扰;二是顺手确认默认 server 的行为——很多团队会故意给默认 server 配一个明显“废”的返回(比如直接 return 444 或一张自签名证书),这样 SNI 匹配失败时立刻暴露,而不是悄悄拿错证书蒙混。

这类故障为什么容易漏

  1. 多入口掩盖问题。 CDN、SLB、源站各持有一张证书,任何一层配错,症状都是"部分用户报错"。排查时按"探针走的路径"逐层 s_client,不要假设所有请求走同一条路。
  2. 配置合并、批量下发容易丢块。 server 块被模板覆盖、被注释、文件名排序变了导致加载顺序变化,都可能改变默认 server 的人选。
  3. 只在浏览器验证。 浏览器走的是"最健全"的路径,SNI、AIA 补链样样齐全,天然掩盖配置残缺。
证书没过期、链也没问题,客户端却报“域名不匹配”:一次 nginx 默认 server 抢答的复盘:an operator tracing a failed certificate delivery path while a parallel known-good route keeps serving users until recovery is verified
证书没过期、链也没问题,客户端却报“域名不匹配”:一次 nginx 默认 server 抢答的复盘:an operator tracing a failed certificate delivery path while a parallel known-good route keeps serving users until recovery is verified查看原图

预防措施

  • 改 nginx 配置后,验证清单里固定加一条:对每一个托管域名直连源站跑一次带 SNI 的握手,核对下发的证书域名。脚本化之后成本几乎为零。
  • 显式指定默认 server(listen 443 ssl default_server;)并给它一个"宁可报错也不误导"的行为,别把这个位置交给文件加载顺序这种玄学决定。
  • 如果证书部署和配置下发都走自动化,把"握手验证到正确证书"作为部署闭环的最后一步,而不是"文件推送成功"就算完。CertbotX 这类工具把签发、部署到 Agent 或 CDN、部署记录审计串在一起,至少能保证"每个入口拿到的是同一张该拿的证书",但 server 块级的配置正确性仍然要靠上面的握手验证兜底——自动化管不了 nginx 配置文件里的一行注释。

局限

这个复盘针对的是 nginx 基于 SNI 的虚拟主机场景。如果前面挂着 CDN 或云 SLB,证书绑定逻辑在厂商控制台里,排查思路相同(逐层核对实际下发的证书),但修复动作完全不同,别照搬。

参考文档:

← 返回资讯中心