跳到主要内容

NET::ERR_CERT_COMMON_NAME_INVALID 排查指南:SAN 匹配规则、证书重签与真实报错对照

NET::ERR_CERT_COMMON_NAME_INVALID(Chrome/Edge 内部错误码 -200)是 Chromium 网络栈在 TLS 握手完成后、校验证书“身份是否匹配当前主机名”时抛出的错误。它和“证书过期”(ERR_CERT_DATE_INVALID)、“证书不受信任”(ERR_CERT_AUTHORITY_INVALID)是三件不同的事:证书链本身可能完全合法有效,只是它不为你要访问的这个域名作担保。

一、这个错误到底在报什么

触发链路大致如下:

  1. 浏览器向 a.example.com:443 发起连接,SNI 扩展里带上 a.example.com。
  2. 服务器(或它前面的 LB / CDN / Ingress)返回一张证书。
  3. Chromium 先验证签名链与有效期,再执行主机名校验:把请求的主机名与证书的 subjectAltName 逐条比对。
  4. 没有任何一条匹配 → 握手失败,页面显示 NET::ERR_CERT_COMMON_NAME_INVALID。

最常见的五种成因:

  • 证书签发时只写了 example.com,实际访问的是 a.example.com;
  • 用了通配符 *.example.com,但访问的是二级子域 a.b.example.com;
  • 服务器上部署了错误的证书(默认站点证书、上一个项目的证书、自签的 localhost 证书);
  • 直接用 IP 访问,而证书的 SAN 里没有 IP: 条目;
  • 请求被企业代理 / 杀毒软件重签,但代理根证书未进信任库。

二、CN 已经失效:判定只看 SAN

很多老教程会让你“把 Common Name 改成要访问的域名”,这在今天完全无效。按 CA/Browser Forum Baseline Requirements,自 2017 年起 CN 已变为可选字段;RFC 6125 也明确建议客户端优先(并最终只)使用 subjectAltName 做身份匹配。

  • Chrome 58+、Firefox 48+:完全忽略 CN,只看 SAN。CN 写对了但 SAN 里没有该域名,一样报 NET::ERR_CERT_COMMON_NAME_INVALID。
  • OpenSSL 1.1.0+ 的 X509_check_host():默认优先 SAN;只有当证书完全没有 SAN 时才回退到 CN。
  • Java、Go、Node.js、Python 的现代 TLS 实现同样以 SAN 为准。

所以正确的修复动作永远是:让目标域名出现在 SAN 列表里,而不是去改 CN。

三、5 分钟定位:证书到底覆盖了哪些域名

先别改配置,先拿到“服务器实际返回的那张证书”。

3.1 抓取线上证书并打印 SAN

openssl s_client -connect a.example.com:443 -servername a.example.com -showcerts </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

输出示例(说明证书只覆盖了主域,没有覆盖子域):

subject=CN = example.com
issuer=C = US, O = Let's Encrypt, CN = R3
notBefore=...
notAfter=...
X509v3 Subject Alternative Name:
    DNS:example.com, DNS:www.example.com

-servername 不能省。省略它,SNI 为空,服务器会返回默认站点的证书,你排查的就不是同一个东西了。

3.2 一行命令直接判定匹配与否

openssl s_client -connect a.example.com:443 -servername a.example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -checkhost a.example.com

输出 Hostname a.example.com does match certificate 表示匹配,does NOT match 表示不匹配。

3.3 用 curl 交叉验证(顺带看到 SNI 与链)

curl -vI https://a.example.com 2>&1 | grep -E "subject:|subjectAltName|SSL certificate|issuer:"

匹配时 curl 会打印 subjectAltName: host "a.example.com" matched cert's "a.example.com";不匹配时打印 subjectAltName does not match a.example.com。

3.4 本地证书文件的离线校验

openssl verify -CAfile fullchain.pem -verify_hostname a.example.com cert.pem
openssl x509 -in cert.pem -noout -checkhost a.example.com
openssl x509 -in cert.pem -noout -text | grep -A1 "Subject Alternative Name"

3.5 在浏览器里看

地址栏左侧锁图标 → 连接安全 → 证书 → “使用者备用名称”(Subject Alternative Name)。Chrome 新版在“详细信息”里也能直接看到“证书有效范围”。

四、证书类型与域名覆盖能力对比

证书形态 典型 SAN 内容 覆盖 example.com 覆盖 a.example.com 覆盖 a.b.example.com 适用场景
单域名证书 DNS:example.com 是 否 否 纯主站
单域名证书(指定子域) DNS:a.example.com 否 是 否 单一子域服务
通配符证书 DNS:*.example.com 否 是 否 数量不定的一级子域
通配符 + 主域(双 SAN) DNS:example.com, DNS:*.example.com 是 是 否 大多数 SaaS / 多租户一级子域
多域名证书(SAN/UCC) DNS:example.com, DNS:a.example.com, DNS:b.example.com 是 是 否 域名集合固定、跨主域
多域名 + 通配符混合 DNS:*.example.com, DNS:*.b.example.com, DNS:example.com 是 是 是(需 *.b.example.com) 多级子域
IP 证书 IP:203.0.113.10 — — — 直接用 IP 访问的内网/设备

几条必须记住的硬规则:

  • *.example.com 不覆盖 example.com 本身,也不覆盖 a.b.example.com(通配符只匹配一级标签)。
  • 通配符只能出现在最左侧标签,a.*.example.com 是非法的。
  • 用 IP 访问时,证书必须有 IP: 类型的 SAN,DNS: 条目再多也没用。
  • 中文域名(IDN)在 SAN 里以 punycode 形式存储(xn--fiqs8s.example.com),浏览器会自动转换输入,但自研客户端不一定。

五、分场景修复

场景 A:证书确实缺域名 → 重新签发

用 certbot 追加域名(必须把原有域名一起写上,否则会把旧域名“签丢”):

certbot certonly --webroot -w /var/www/html 
  -d example.com -d www.example.com -d a.example.com

# 查看现有证书覆盖了哪些域名
certbot certificates

# 续期演练,确认新增域名也能通过校验
certbot renew --dry-run

场景 B:通配符不够用 → 换多 SAN 或分层通配符

要覆盖 a.b.example.com,有两条路:

  • 在 SAN 里显式列出 a.b.example.com(数量可控时推荐);
  • 再签一张 *.b.example.com 的通配符证书,并按 SNI 分流。

通配符证书只能通过 DNS-01 验证签发,certbot 需加 --manual --preferred-challenges dns 或配置 DNS 插件。

场景 C:Kubernetes / cert-manager

apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: example-tls
spec:
  secretName: example-tls
  dnsNames:
    - example.com
    - "*.example.com"
    - a.b.example.com      # 通配符覆盖不到,必须显式列出
  issuerRef:
    name: letsencrypt-prod
    kind: ClusterIssuer
kubectl get certificate,certificaterequest,order,challenge -A
kubectl describe certificate example-tls
kubectl get secret example-tls -o go-template='{{index .data "tls.crt"}}' | base64 -d 
  | openssl x509 -noout -ext subjectAltName

若 kubectl describe certificate 显示 Certificate is up to date 但浏览器仍报错,多半是 Ingress 引用了别的 Secret,或 ingress.spec.tls[].hosts 与实际 dnsNames 不一致。

场景 D:服务器返回了错误的证书

证书本身没问题,是“接错了”。按下面顺序查:

# nginx:看每个 443 server 块的 server_name 与 ssl_certificate 配对
nginx -T 2>/dev/null | grep -nE "server_name|ssl_certificate |listen .*443"

# Apache:确认哪个 VirtualHost 接住了这个域名
apachectl -S
apachectl -t -D DUMP_VHOSTS
  • nginx 里必须有一个 listen 443 ssl default_server; 兜底块,否则未知 SNI 会命中第一个 server 块,返回那张不相关的证书。
  • Cloudflare 免费版 Universal SSL 只覆盖 example.com 与 *.example.com;a.b.example.com 开启橙色云朵后必然报这个错,需要 Advanced Certificate Manager 或改为 DNS only。
  • SLB / ALB / Nginx Ingress 的 SNI 分流规则(如 HAProxy 的 req_ssl_sni)写错,也会把请求导到错误的证书。

场景 E:用 IP 访问或内网环境

必须签一张带 IP: SAN 的证书。自签示例:

openssl req -x509 -newkey rsa:2048 -nodes -days 365 
  -keyout key.pem -out cert.pem 
  -subj "/CN=internal" 
  -addext "subjectAltName=IP:10.0.0.10,DNS:internal.example.com"

-addext 需要 OpenSSL 1.1.1+;改用配置文件时务必写 subjectAltName,只写 commonName 在浏览器里照样报错。

六、真实报错信息对照表

客户端 报错原文 根因 处理
Chrome / Edge NET::ERR_CERT_COMMON_NAME_INVALID(错误码 -200) 主机名不在 SAN 中 重签证书或改用正确域名访问
Firefox SSL_ERROR_BAD_CERT_DOMAIN 同上 同上
curl(旧版 OpenSSL) curl: (60) SSL: certificate subject name 'example.com' does not match target host name 'a.example.com' CN 不匹配且无 SAN 补 SAN
curl(新版) curl: (60) SSL: no alternative certificate subject name matches target host name 'a.example.com' SAN 无匹配项 补 SAN
openssl verify verify error:num=62:hostname mismatch 同上 补 SAN
Python requests SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: Hostname mismatch, certificate is not valid for 'a.example.com'. (_ssl.c:1006)') 同上 补 SAN
Node.js Error: Hostname/IP does not match certificate's altnames: Host: a.example.com. is not in the cert's altnames: DNS:example.com 同上 补 SAN
Go x509: certificate is valid for example.com, not a.example.com 同上 补 SAN
Java java.security.cert.CertificateException: No subject alternative names matching IP address 10.0.0.10 present / No name matching a.example.com found IP 访问缺 IP SAN,或域名不在 SAN 重签含 IP:/DNS: 的证书
Postman / Insomnia SSL Error: Hostname/IP does not match certificate's altnames 同上 同上

排查时容易忽略的两点:

  • 公司代理 / 杀毒软件的 HTTPS 中间人。如果证书签发者是公司自己的 CA(如 Zscaler、Fortinet),说明流量被重签,此时错误说明代理根证书没装进系统信任库,而不是你服务器的问题。
  • 主机名带尾点。https://a.example.com./ 在部分客户端(尤其自研脚本、老版本 OpenSSL)不会被归一化,会直接判定不匹配。

七、上线前验证与持续监控

改完证书不要只刷新浏览器,跑一遍下面这组检查:

DOMAIN=a.example.com
echo | openssl s_client -connect $DOMAIN:443 -servername $DOMAIN 2>/dev/null 
  | openssl x509 -noout -checkhost $DOMAIN
curl -sSI https://$DOMAIN/ | head -n 1
openssl s_client -connect $DOMAIN:443 -servername $DOMAIN -showcerts </dev/null 2>/dev/null 
  | openssl x509 -noout -dates -ext subjectAltName

多域名批量自检(Python,逐个域名做真实握手校验):

import socket, ssl

HOSTS = ["example.com", "www.example.com", "a.example.com", "a.b.example.com"]
ctx = ssl.create_default_context()

for host in HOSTS:
    try:
        with socket.create_connection((host, 443), timeout=5) as sock:
            with ctx.wrap_socket(sock, server_hostname=host) as tls:
                sans = [v for k, v in tls.getpeercert()["subjectAltName"] if k == "DNS"]
        print(f"{host:28} OK        SAN={sans}")
    except ssl.SSLCertVerificationError as e:
        print(f"{host:28} MISMATCH  {e.verify_message}")
    except Exception as e:
        print(f"{host:28} ERROR     {e}")

把它接进 CI 或每日巡检。注意 Prometheus blackbox_exporter 的 probe_ssl_earliest_cert_expiry 只能看有效期,域名匹配建议用上面的脚本或 curl -sS --fail 做端到端断言。证书续期后自动 reload 也要复验:nginx -s reload 之后再跑一次 -checkhost,避免 reload 失败导致旧证书继续服务。

八、FAQ

Q1:CN 和 SAN 我都写对了,为什么还报错?

优先怀疑三件事:① 服务器还在返回旧证书(reload 没生效、Secret 没挂载更新);② 中间有代理/CDN 用另一张证书终结 TLS;③ 你连的其实是另一个环境(hosts、DNS 缓存、CDN 回源)。用 openssl s_client -servername 抓一次实际证书即可确认。

Q2:通配符证书能覆盖 a.b.example.com 吗?

不能。*.example.com 只匹配一级标签。要么把 a.b.example.com 显式加进 SAN,要么再签 *.b.example.com。

Q3:只改 CN 行不行?

不行。Chrome 58+、Firefox 48+ 已完全忽略 CN。证书必须把域名写进 SAN。

Q4:命令行 curl 正常,浏览器却报 NET::ERR_CERT_COMMON_NAME_INVALID?

说明两者走的网络路径不同:浏览器可能走了系统代理、企业 VPN、或访问的是 IP/别名域名;也可能是浏览器缓存了旧证书。用无痕窗口 + chrome://net-internals/#events 或开发者工具 Security 面板确认实际收到的证书。

Q5:证书过期会报这个错吗?

不会。过期报 ERR_CERT_DATE_INVALID,不受信任报 ERR_CERT_AUTHORITY_INVALID,域名不匹配才是 ERR_CERT_COMMON_NAME_INVALID。

Q6:内网用 IP 访问,怎么才能不报错?

签一张带 IP:10.0.0.10 的 SAN 证书(自建 CA 或内部 CA 签发),并把根证书导入所有客户端的信任库。DNS: 条目再多也替代不了 IP:。

Q7:一个 IP 上多个域名共用 443,怎么区分?

靠 SNI。服务器侧必须按 SNI 选择证书(nginx 的 server_name、Apache 的 ServerName、HAProxy 的 req_ssl_sni)。客户端不支持 SNI 时只能拿到默认证书,必然不匹配。

Q8:能不能临时绕过这个错误?

调试可以:Chrome 在错误页键盘输入 thisisunsafe,curl 用 -k。但绝不能把 -k 或 verify=False 写进生产代码或 CI 脚本——那等于关掉整条链路的身份校验。

Q9:Let’s Encrypt 一张证书最多能放多少域名?

单张证书最多 100 个 SAN 条目。域名很多时按业务拆分多张证书,配合 SNI 分流。