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)是三件不同的事:证书链本身可能完全合法有效,只是它不为你要访问的这个域名作担保。
一、这个错误到底在报什么
触发链路大致如下:
- 浏览器向
a.example.com:443发起连接,SNI 扩展里带上a.example.com。 - 服务器(或它前面的 LB / CDN / Ingress)返回一张证书。
- Chromium 先验证签名链与有效期,再执行主机名校验:把请求的主机名与证书的
subjectAltName逐条比对。 - 没有任何一条匹配 → 握手失败,页面显示
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 分流。