SSL证书不匹配域名怎么解决?从根因、Nginx/Apache配置到OpenSSL验证的完整排查指南
1) SSL证书不匹配域名的直接原因是证书的SAN(Subject Alternative Name)中没有包含浏览器地址栏中的主机名,CN仅在旧客户端兼容时参考;用 `openssl x509 -checkhost www.example.com` 返回 `does match` 才算匹配。2) 先执行 `openssl s_client -connect example.com:443 -servername www.example.com -showcerts` 看线上返回的 subjectAltName,缺 www 就用 `certbot certonly --nginx -d example.com -d www.example.com --expand` 重签。3) Nginx 1.19.4+ 可在默认 server 写 `ssl_reject_handshake on` 拦截未知 SNI;Apache 2.4 要确保 443 默认 VirtualHost 不返回其他域名证书。4) 通配符 `*.example.com` 只覆盖一级子域,不覆盖 `a.b.example.com`;多域名 SAN 证书建议把裸域和 www 都写入。5) 验证用 `curl -vI --resolve` 与 `openssl s_client -verify_hostname` 双查,浏览器仍报错时优先检查 CDN 边缘证书和 default_server。
SSL证书不匹配域名是怎么回事?先看6个根本原因
浏览器那句报错的本质,是客户端在 TLS 握手完成后按 RFC 6125 第 6.4.4 节做身份校验:只比对证书 subjectAltName 里的 DNS/IP 条目。CN 早在 Chrome 58(2017 年)就被弃用,CA/Browser Forum 基线要求也规定所有 FQDN 必须写进 SAN,CN 仅作旧客户端兜底。所以”证书看着没问题却报错”,绝大多数是 SAN 里压根没有你访问的那个名字。
# 同一问题在不同客户端的措辞,可据此反查方向
Chrome / Edge : NET::ERR_CERT_COMMON_NAME_INVALID
Firefox : SSL_ERROR_BAD_CERT_DOMAIN
curl 8.x : curl: (60) SSL: no alternative certificate subject name matches target host name
openssl : verify error:num=62:hostname mismatch
先看清服务端到底发了哪张证书——-servername 会触发 SNI,这是复现”多站点串证”的关键,OpenSSL 1.1.1+ 起稳定支持:
openssl s_client -connect www.example.com:443
-servername www.example.com /dev/null
| openssl x509 -noout -subject -ext subjectAltName
# 期望输出:X509v3 Subject Alternative Name:
# DNS:www.example.com, DNS:example.com
| 根本原因 | 典型现象 | 一条命令定位 |
|---|---|---|
| SAN 缺失 | 裸域正常,www 或 api 子域报错 | openssl x509 -noout -ext subjectAltName -in cert.pem |
| SNI 选错虚拟主机 | 直接访问 IP 或未知域名拿到别的站点证书 | s_client -connect IP:443 -servername 不存在.example |
| CDN / 负载均衡回源 | 浏览器看边缘正常,回源链路报错 | dig +short www.example.com |
| 通配符层级不够 | a.example.com 正常,a.b.example.com 报错 |
核对 SAN 中通配符位置 |
| IDN 未用 punycode | 中文域名报错 | idn2 中文.example |
| 端口 / 协议混淆 | 443 正常,8443、465、993 报错 | s_client -connect host:465 -servername host |
1. SAN 缺失最常见。Let’s Encrypt 的 certbot 不会自动补 www:-d example.com 只签一个名字。要一次写入两个 SAN,用 certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com(已存在 lineage 时加 --expand,否则 certbot 默认只续期不扩域名)。据 Let’s Encrypt 文档,单张证书最多 100 个名字。
2. SNI 选错虚拟主机。Nginx 在同一 443 端口有多个 server 块时,未声明 listen 443 ssl default_server; 的那个”第一个”会兜住所有未知 SNI;Apache 则取配置文件里最先加载的 SSL VirtualHost,或显式标 <VirtualHost _default_:443>。二者默认行为不同,这正是迁移后证书”错位”的高发点。
3. CDN / 证书卸载。dig 看到 CNAME 指向 CDN 后,边缘证书与回源证书是两套:控制台显示”部署中”时边缘仍返回旧证书,通常等 1–10 分钟;若回源用了旧域名证书,源站日志里会持续出现 hostname mismatch。
4. 通配符层级。按 RFC 6125,*.example.com 只匹配最左一个标签,既不覆盖 example.com 本身,也不覆盖 a.b.example.com,需要单独签或改用 *.b.example.com。
5. IDN 与 punycode。中文域名必须在 SAN 中写 A-label:idn2 中文.example 输出 xn--fsqu00a.example,浏览器只按 punycode 比对。
6. 端口与协议。443 通不代表 8443、465(SMTPS)、993(IMAPS)用的是同一张证书;直接用 https://IP 访问也会触发名称不匹配,需改用域名或申请带 IP SAN 的证书(公网 CA 支持有限,内网多用自签或私有 CA)。
排查前要确认哪些信息?域名、解析、端口与 SNI 四件事
看到 NET::ERR_CERT_COMMON_NAME_INVALID 或 curl 报 SSL: no alternative certificate subject name matches target host name 'www.example.com',先别急着重新签发证书。据 RFC 6125 与 RFC 6066(SNI 扩展),浏览器验证的是「你实际请求的主机名」与「本次 TLS 握手返回的证书 SAN 列表」是否匹配——中间任何一环错位,都会表现为“ssl证书不匹配域名”。所以排查第一步是把这四件事各自钉死。
1)锁定浏览器实际访问的主机名。裸域 example.com 和 www.example.com 在证书里是两个独立的名字,Let’s Encrypt 文档明确说明:证书只包含签发时提交的标识符,www 不会自动覆盖裸域,反之亦然。按 F12 → Security → View certificate,看“颁发给(CN)”与“使用者可选名称(SAN)”;命令行等价操作:
# -I 只发 HEAD,-v 打印 TLS 握手细节;某些站点对 HEAD 返回 405 属正常,握手信息仍可见
curl -vI https://www.example.com 2>&1 | grep -Ei 'subject|issuer|SSL certificate|CN='
# 对照测试:末尾点(FQDN 绝对名)、大小写、非标准端口都会被区别对待
curl -vI https://www.example.com.:443
curl -vI https://example.com:8443
2)核对 DNS 的 A / AAAA / CNAME。AAAA 记录常被遗忘:域名迁移后 IPv6 仍指向旧服务器,浏览器走 Happy Eyeballs 优先 IPv6,就会拿到另一张证书。CNAME 指向 CDN 时,最终证书由 CDN 边缘节点决定。
dig +short A www.example.com @8.8.8.8
dig +short AAAA www.example.com @8.8.8.8
dig +short CNAME www.example.com
# 强制走 IPv6 复现问题(如果 AAAA 指向旧机器,这里会拿到不同的证书)
curl -6 -vI https://www.example.com
3)确认谁在监听 443、哪个 server 块被命中。Nginx 在没有 default_server 时,把配置文件里第一个监听该端口的 server 块当作默认虚拟主机;SNI 缺失或不匹配就落到它身上。据 Nginx 官方文档,ssl_certificate 无默认值,必须显式配置。
ss -lntp | grep -E ':443|:8443' # 看 PID/进程名,确认不是另一个 Nginx 或 HAProxy
nginx -T | grep -nE 'server_name|ssl_certificate|default_server|listen .*443'
apachectl -S # 输出 443 虚拟主机排序,第一项即默认主机
4)直接读文件证书 vs 读线上返回证书——这是最关键的一刀。“文件里的证书正确”不等于“线上下发的是这张证书”,中间可能被负载均衡、旧进程、缓存证书覆盖。
# 本地文件:看主体、签发者、有效期、SAN
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem
-noout -subject -issuer -dates -ext subjectAltName
# 主机名匹配检查(-checkhost 自 OpenSSL 1.1.0 起提供,建议用 1.1.1 LTS 及以上)
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem
-noout -checkhost www.example.com # 匹配输出 "does match",否则 "does NOT match"
# 线上真正返回的证书:-servername 触发 SNI,不带它拿到的是默认站点的证书
echo | openssl s_client -connect 203.0.113.10:443 -servername www.example.com -showcerts 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
| 检查对象 | 命令 | 典型误判 |
|---|---|---|
| 本地证书文件 | openssl x509 -in fullchain.pem -noout -ext subjectAltName |
文件对,但服务未 reload,线上仍是旧证书 |
| 线上返回证书 | openssl s_client -servername ... -showcerts |
漏掉 -servername,拿到 default_server 的证书 |
| IPv6 路径 | curl -6 -vI |
AAAA 指向旧服务器,只有 IPv6 用户报错 |
| 非标准端口 | ss -lntp | grep 8443 |
443 正常,但反代到 8443 的那一跳证书过期 |
真实报错样本,可用来反向定位阶段:
curl: (51) SSL: no alternative certificate subject name matches target host name 'www.example.com'说明握手成功但 SAN 不含该名字(第 4 步问题);而curl: (60) SSL certificate problem: unable to get local issuer certificate属于链不完整,需用fullchain.pem而非cert.pem。浏览器侧ERR_CERT_COMMON_NAME_INVALID同理,但 Chrome 自 58 起已完全不看 CN,只认 SAN——这也是 Mozilla 在 Server Side TLS 指南中要求必须配置 SAN 的原因。
把这四项的结果并排写下来(访问主机名 / 解析 IP / 监听进程与 server 块 / 线上 SAN),矛盾点通常立刻显现:多数“证书不匹配域名”的真实原因是 www 与裸域混用、AAAA 残留、或 SNI 未命中 default_server,而非证书本身签错。
如何一步步修复 SSL 证书不匹配域名?6 个编号步骤
修复 SSL 证书不匹配域名的正确顺序是”先取证、再定位、再改配置”,因为绝大多数误判都发生在没确认线上实际返回哪张证书的情况下就急着重签。下面 6 个步骤按依赖关系排列,跳步容易返工。
- 记录报错原文与全部目标域名。浏览器记下
NET::ERR_CERT_COMMON_NAME_INVALID,命令行记下 curl 的no alternative certificate subject name matches target host name。然后把裸域example.com、www.example.com、api.example.com、以及直接用 IP 访问的入口分别列成清单——据 RFC 6125,证书身份校验只看 SAN(subjectAltName),CN 早已被主流客户端忽略,漏列一个域名就等于留下一个未修的口子。IP 访问本身无法被域名证书覆盖,需单列说明。 - 用 OpenSSL 定位线上真正生效的证书。
-servername用于模拟 SNI,必须显式指定,否则取到的是默认站点证书,这也是”本地文件明明有 www、线上却没有”的常见原因(OpenSSL 文档明确该参数仅在 TLS 扩展协商时发送):
# 取线上证书并打印主题、签发者、有效期与 SAN 列表
echo | openssl s_client -connect example.com:443
-servername www.example.com -showcerts 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 期望输出包含:DNS:example.com, DNS:www.example.com
SAN 里缺 www,走步骤 3 重签;SAN 里已有 www 但浏览器仍报错,说明请求被 SNI 分流到了别的站点或 CDN 边缘节点,跳到步骤 5、6。
- 重签或补 SAN。Let’s Encrypt 官方文档给出的扩域做法是加
--expand(Certbot 2.x 仍有效,会自动复用账号与验证方式):
# 把 www 追加进已有证书;--expand 表示在现有证书上扩充域名
sudo certbot certonly --nginx -d example.com -d www.example.com --expand
# 仅测试签发流程,不消耗速率限制
sudo certbot certonly --nginx -d example.com -d www.example.com --expand --dry-run
商业证书走 CSR 路线,OpenSSL 1.1.1+ 才支持 -addext:
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout example.com.key -out example.com.csr
-subj '/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# 校验 CSR 内的 SAN 是否写对
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
| 方式 | 适用场景 | 关键参数/默认值 | 注意点 |
|---|---|---|---|
Certbot --expand |
已有 Let’s Encrypt 证书需加域名 | 默认 90 天有效,续期窗口 30 天 | 每周同一组域名重复签发上限 5 次 |
| OpenSSL 生成 CSR | OV/EV 商业证书、内网 CA | rsa:2048,-sha256 |
私钥务必 chmod 600 |
- 部署 fullchain 与私钥并校验语法。必须用
fullchain.pem(叶子证书+中间证书),只配cert.pem会在部分安卓与 Java 客户端上出现链不完整告警:
# Nginx
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 含中间证书
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; # 权限 600
# 校验并平滑重载
sudo nginx -t && sudo systemctl reload nginx
# Apache (httpd 2.4 / Apache 2.4)
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
# 校验并重载
sudo apachectl configtest && sudo systemctl reload apache2
- 修正默认 SNI 站点。未知 SNI 会落到第一个 443 虚拟主机,从而返回错误证书。Nginx 1.19.4+ 可直接拒绝握手;更早版本用
return 444;兜底:
server {
listen 443 ssl default_server; # Nginx 1.19.4+
ssl_reject_handshake on; # 直接终止,不暴露任何证书
server_name _;
}
# 低版本替代写法
# listen 443 ssl default_server;
# return 444;
Apache 则要把 <VirtualHost _default_:443> 放在配置文件最前面,并保证其证书覆盖所有可能被访问的 Host。
- 更新 CDN/负载均衡证书并复测。在控制台上传新 fullchain 与私钥,同时绑定裸域和 www,生效通常 1–10 分钟。若回源走 HTTPS,回源证书也必须覆盖回源 Host(常见坑:回源 Host 填了 IP 却用域名证书);也可改为 HTTP 回源并用安全组限制源站。最终用
curl -vI https://www.example.com确认SSL certificate verify ok,再对清单中每个域名重复步骤 2 的openssl s_client命令,确认 SSL 证书不匹配域名的问题在每个入口都已消失。
Nginx、Apache 与 Certbot 的配置命令示例(含版本参数)
证书装好了,浏览器仍报 NET::ERR_CERT_COMMON_NAME_INVALID?十有八九是配置里出现了 ssl证书不匹配域名 的典型原因:server_name 和证书 SAN 对不上,或者请求落到了默认 server 上。下面直接给出三个组件的可复制配置,以及验证命令。
Nginx 1.24 / 1.26 最小可用片段怎么写?关键在于 server_name 必须逐条对应证书 SAN;如果缺少 default_server,Nginx 会把配置中第一个 listen 443 的 server 当作默认 server,于是用 IP 或未知域名访问时,就会拿到那张不匹配的证书。
# /etc/nginx/conf.d/example.conf —— Nginx 1.24 / 1.26 通用
server {
listen 443 ssl; # 1.25.1 起禁止再写 listen 443 ssl http2;
http2 on; # 仅 ≥1.25.1 支持;1.24 及以下仍用 listen 443 ssl http2;
server_name example.com www.example.com; # 必须与证书 SAN 完全一致
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 含中间证书
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3; # Nginx 1.23.4+ 默认值即为这两项
ssl_session_cache shared:SSL:10m; # 默认 none;10m 约容纳 4 万个会话
}
未知域名打进来怎么办?用一个专门的默认 server 兜底。Nginx 1.19.4 起支持在 TLS 握手阶段直接拒绝,连证书都不回:
server {
listen 443 ssl default_server;
ssl_reject_handshake on; # Nginx ≥ 1.19.4,握手即断开,不泄露任何域名
}
# 若版本 < 1.19.4:TLS 握手早于 HTTP 处理,return 444 也仍需配一张证书,
# 只能用不含业务域名的自签证书降低泄露面
server {
listen 443 ssl default_server;
server_name _;
ssl_certificate /etc/nginx/ssl/dummy.pem;
ssl_certificate_key /etc/nginx/ssl/dummy.key;
return 444; # 不回响应直接关连接
}
Apache 2.4.57 呢?据 Apache HTTP Server 文档,2.4.8 起 SSLCertificateFile 会读取 fullchain 中的中间证书,无需再用已废弃的 SSLCertificateChainFile。用 apachectl -S 确认哪个 443 vhost 排在第一位,因为排序靠前的 vhost 会接住所有未匹配的 SNI。
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
</VirtualHost>
# apachectl -S 输出示例(第一行即默认 443 vhost)
# *:443 is a NameVirtualHost
# default server www.example.com (/etc/httpd/conf.d/ssl.conf:56)
Certbot 2.x 常用四条命令:
certbot certificates # 查到期时间与 SAN 列表
certbot renew --dry-run --deploy-hook 'systemctl reload nginx' # 演练续期并热加载
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
certbot certonly --manual --preferred-challenges dns -d '*.example.com' -d example.com # 通配符只能 DNS-01
| 验证方式 | 关键参数 | 支持通配符 | 需占用 80 端口 | 适用场景 |
|---|---|---|---|---|
| webroot | --webroot -w <目录> |
否 | 是(HTTP-01) | 已有运行中的 Web 服务 |
| standalone | --standalone |
否 | 是 | 无 Web 服务,可临时占用端口 |
| DNS-01 | --preferred-challenges dns |
是 | 否 | 通配符、内网、80 被封 |
下单前如何自查 CSR?OpenSSL 1.1.1 / 3.x 可直接写入 SAN,商业 CA 下单时务必把裸域和 www 都填进 SAN,只填 CN 是当前最常见的 ssl证书不匹配域名 来源,因为 Chrome 68 起已完全忽略 CN:
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr
-subj "/CN=example.com"
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
上线前怎么绕过 DNS 直连源站验证?下面两条命令分别从 HTTP 层和 TLS 层校验主机名,OpenSSL 3.x 的 -verify_hostname 会在 SAN 不匹配时直接返回 Verify return code: 62 (Hostname mismatch):
curl -vI https://www.example.com --resolve www.example.com:443:203.0.113.10
openssl s_client -connect 203.0.113.10:443 -servername www.example.com
-verify_hostname www.example.com </dev/null
单域名、多域名、通配符和 CDN 证书怎么选?参数对比表
证书类型选错,是 ssl 证书不匹配域名 报错最常见的“上游原因”之一——不是配置写错,而是这张证书从头到尾就不包含用户访问的那个主机名。先看四类证书与 CDN 托管方案的边界:
| 方案 | 覆盖主机名 | 2026 年参考价格(元/年) | 有效期 / 续期 | 适用场景 |
|---|---|---|---|---|
| 单域名 DV | example.com 或 www.example.com 其中之一 | 0(Let’s Encrypt)– 300 | 90 天自动;商业证书受 CA/B Forum 200 天上限约束 | 个人博客、单入口 |
| 多域名 SAN DV | 裸域 + www + api,最多可至 100 个 SAN | 100 – 800 | 90 天 / 200 天 | 中小企业多子域 |
| 通配符 DV | *.example.com 及 example.com | 300 – 1500 | 90 天 / 200 天 | 子域多且层级固定 |
| OV / EV 组织验证 | 多域名 SAN | 800 – 8000 | 200 天 | 金融、政企、需展示组织信息 |
| CDN 托管证书 | 按 CDN 绑定的域名 | 0 – 2000(含流量/套餐) | 自动 | 已接入 CDN / WAF |
只有 example.com 和 www 两个入口,买哪种最省钱?优先多域名 SAN DV:一张证书放两个 SAN,价格通常低于通配符。只有一级子域超过 10 个、且层级固定时,*.example.com 才划算。
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
通配符真的能“一证通吃”吗?不能。*.example.com 只匹配一层标签,不覆盖 a.b.example.com,也不覆盖裸域 example.com——后者是最常见的踩坑点,签发时必须显式加上裸域。据 Let’s Encrypt 文档,通配符只能通过 DNS-01 挑战签发,因为它要验证你对整个域区的控制权:
# 同时签发裸域与通配符,缺一不可;--manual 需按提示添加 TXT 记录
certbot certonly --manual --preferred-challenges dns
-d example.com -d '*.example.com'
# 或使用 acme.sh + DNS API 自动续期(示例为阿里云 DNS)
export Ali_Key="你的AccessKeyId"
export Ali_Secret="你的AccessKeySecret"
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
# 核对最终 SAN 列表,确认访问的主机名在列
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -text
| grep -A1 "Subject Alternative Name"
# 期望输出:DNS:example.com, DNS:*.example.com
买 OV/EV 能不能绕过不匹配?不能。据 RFC 9525(2024 年发布,取代 RFC 6125),客户端只依据 SAN 扩展做主机名校验,Subject 中的 O= 组织名完全不参与匹配。OV/EV 证书若 SAN 里没列 api.example.com,浏览器照样报 NET::ERR_CERT_COMMON_NAME_INVALID。组织验证解决的是“你是谁”,不是“这个域名归不归你”。
接了 CDN 之后改了源站证书为什么还报错?因为浏览器看到的是边缘证书。先用一条命令定位证书到底由谁签发:
# 同时打印证书主题、签发者与响应头中的 CDN 标识
curl -vI https://www.example.com 2>&1 | grep -E "subject:|issuer:|server:"
# 若返回 server: cloudflare / ali-swift 等,说明边缘证书由 CDN 提供
# 此时修复源站证书无效,需在 CDN 控制台重新签发或上传证书,
# 或临时关闭代理(DNS 记录改灰云)直连源站做对比验证
价格与有效期要注意什么?2026 年商业 DV 常见 100–800 元/年,OV 约 800–3000 元/年,EV 约 2000–8000 元/年。据 CA/B Forum SC-081 ballot,自 2026-03-15 起公共 TLS 证书最长有效期降至 200 天,2027-03-15 起进一步降至 100 天——采购前务必确认 CA 提供 ACME 自动续期,否则 ssl 证书不匹配域名 的问题会在某天凌晨变成“证书过期”故障。Mozilla 服务器端 TLS 建议同样要求启用自动化续期,而非人工年检。
把浏览器、curl、Java 的报错逐条拆开看,绝大多数“ssl证书不匹配域名”的场景都能在 5 分钟内定位。先记住一句话:现代客户端只认 SAN(subjectAltName)扩展,CN 早在 RFC 6125 之后就不再作为匹配依据——Chrome 从 58 版起、Java 从 8u181 起都已如此。所以证书详情里写“证书颁发给 example.com”但 SAN 缺失时,照样报错。
Chrome / Edge:NET::ERR_CERT_COMMON_NAME_INVALID。点开“证书无效”→“使用者”会看到“此证书所匹配的网站名称无效”,并提示“证书颁发给 *.example.com”。这不是网络问题,是名称校验失败。处理方式只有两条:把当前主机名补进 SAN,或换一张覆盖该层级的证书。
Firefox:SSL_ERROR_BAD_CERT_DOMAIN。错误页会并列显示“证书颁发给”和“已请求”两行,直接对照即可。如果请求的是 a.b.example.com、证书是 *.example.com,那是通配符只覆盖一级标签(RFC 6125 §6.4.3),不是浏览器 bug,必须签 *.b.example.com 或写全名。
curl 的两个高频报错:
# 报错 1:SAN 里没有目标主机名
# curl: (60) SSL: no alternative certificate subject name matches target host name 'www.example.com'
# 报错 2:老版本/单 CN 证书
# curl: (60) SSL: certificate subject name 'example.com' does not match target host name 'www.example.com'
# 先用 --resolve 把域名钉到目标 IP,排除 DNS 解析到别的服务器
curl -v --resolve www.example.com:443:203.0.113.10 https://www.example.com/
# 直接看服务端真实下发的证书 SAN(-servername 触发 SNI,OpenSSL 1.1.1+ 传主机名时默认发送)
openssl s_client -connect 203.0.113.10:443 -servername www.example.com /dev/null
| openssl x509 -noout -subject -ext subjectAltName
# -k 只用于对比验证“确实是证书问题而非连接问题”,生产环境禁止长期使用
curl -k https://www.example.com/ -o /dev/null -w '%{http_code}n'
Java:java.security.cert.CertificateException: No subject alternative names matching IP address 10.0.0.5 present,或 No name matching example.com found。Java 8/11/17 全量按 SAN 严格校验,用 IP 访问就必须签发 IP SAN(IP:10.0.0.5),否则只能改用域名。keytool 可直接拉取对端证书查看:
keytool -printcert -sslserver example.com:443 | grep -A3 "SubjectAlternativeName"
Nginx 返回了别的域名的证书:这是 SNI 未命中,落到 default_server 上。典型触发是同一 IP 上存在多条 listen 443 ssl 却没有显式声明默认站点:
# 列出所有 443 监听与 server_name,确认是否有重复/遗漏
nginx -T 2>/dev/null | grep -nE "listen .*443|server_name"
# 方案 A:显式指定该块为默认,承接未知 SNI
server { listen 443 ssl default_server; server_name _; ssl_reject_handshake on; } # nginx ≥ 1.19.4
# 方案 B:开启 SNI 后重新验证,对比有无 -servername 的差异
openssl s_client -connect 203.0.113.10:443 /dev/null | openssl x509 -noout -subject
别把 unable to verify the first certificate 当成域名不匹配。它几乎总是 fullchain 缺中间证书:Nginx 的 ssl_certificate、Apache 的 SSLCertificateFile 必须指向包含 leaf + 中间证书的 fullchain 文件(Let’s Encrypt 的 fullchain.pem),而不是 cert.pem。用下面这条命令数证书数量,正常应为 2 张及以上:
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | grep -c "BEGIN CERTIFICATE"
| 报错文本 | 出现位置 | 根因 | 处理方向 |
|---|---|---|---|
NET::ERR_CERT_COMMON_NAME_INVALID |
Chrome / Edge | SAN 不含当前主机名 | 补 SAN 或换证书 |
SSL_ERROR_BAD_CERT_DOMAIN |
Firefox | 同上,或通配符层级不足 | 核对“颁发给 / 已请求” |
no alternative certificate subject name matches… |
curl (OpenSSL) | SAN 缺失或不含该名 | --resolve 排除 DNS 后重签 |
No subject alternative names matching IP address… |
Java 8/11/17 | 用 IP 访问但无 IP SAN | 签 IP SAN 或改域名 |
unable to verify the first certificate |
curl / 移动端 SDK | 链不完整,缺中间证书 | 部署 fullchain |
据 Mozilla Server Side TLS 指南,服务端应启用 TLS 1.2/1.3 并下发完整证书链,否则即使域名匹配,也会在部分客户端上被判定为不可信。排查顺序建议固定为:openssl s_client -servername 看实际下发的 SAN → 对比请求主机名 → 再查 SNI 路由与证书链长度。
如何验证修复生效?浏览器、OpenSSL 与在线工具交叉检查
修完之后别急着宣布”搞定了”。证书链、SNI、IPv6 和 CDN 边缘节点这四层里任何一层没对上,浏览器仍会报 NET::ERR_CERT_COMMON_NAME_INVALID。下面这套交叉检查顺序,目的是让”证书不匹配域名”的隐患在用户之前被你自己发现。
第一步:用 OpenSSL 做主机名校验(最权威的单点检查)。OpenSSL 1.1.1 起支持 -verify_hostname,它会把 RFC 6125 的主机名匹配规则真正跑一遍,而不只是验证链是否可信:
# -servername 触发 SNI;-verify_hostname 执行主机名匹配;-CAfile 指定系统信任库
# 适用于 OpenSSL 1.1.1 / 3.x,Debian/Ubuntu 默认信任库路径如下(RHEL 系为 /etc/pki/tls/certs/ca-bundle.crt)
openssl s_client -connect www.example.com:443
-servername www.example.com
-verify_hostname www.example.com
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null
# 通过的标准是同时出现两行:
# Verification: OK
# Verify return code: 0 (ok)
# 若返回 62 (hostname mismatch),说明 SAN 里确实没有这个域名,回到 Nginx/Apache 配置重查
第二步:脱离网络,直接检查证书文件。这一步能区分”证书内容错”和”服务端没加载对证书”:
# 检查域名匹配,期望输出:fullchain.pem: does match
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -checkhost www.example.com
# 检查 IP 型 SAN(-checkip 需 OpenSSL 1.1.0+)
openssl x509 -in fullchain.pem -noout -checkip 203.0.113.10
# 确认有效期,重点看 notAfter;Let's Encrypt 证书有效期为 90 天
openssl x509 -in fullchain.pem -noout -dates
第三步:curl 绕过 DNS,锁定具体节点。--resolve 让你在 DNS 尚未生效或 CDN 回源场景下精确测试某一台后端:
# 强制把域名解析到指定 IP,-vI 只看响应头与 TLS 握手信息;退出码 0 表示校验全通过
curl -vI https://www.example.com --resolve www.example.com:443:203.0.113.10
# 关键输出:SSL certificate verify ok. / subjectAltName: host "www.example.com" matched cert's "www.example.com"
# 必须分别测 IPv4 与 IPv6:-4 和 -6,旧证书常只残留在 AAAA 记录对应的节点上
curl -6 -vI https://www.example.com
第四步:浏览器与在线工具交叉验证。Chrome DevTools → Security → View certificate 查看 SAN 列表是否覆盖裸域、www 与 API 子域;再用 Qualys SSL Labs 或 SSL Shopper 检查 “Certificate names” 字段。据 RFC 6125 第 6.4.4 节,证书 SAN 扩展是主机名匹配的最终依据,CN 仅在无 SAN 时才被回退使用——这也是现代浏览器对仅填 CN 的证书直接报错的原因。据 Let’s Encrypt 文档,其签发的证书一律把域名写入 SAN,因此”CN 对了但 SAN 缺项”多发生在手工签发或证书拼接错误。
第五步:把检查变成巡检。人工验证只做一次,剩下的交给定时任务:
# 每天演练一次续期,不写盘(certbot 1.x+,可安全用于生产)
0 3 * * * certbot renew --dry-run --quiet
# 每 6 小时检查远端证书是否在 30 天内到期(2592000 秒);返回 0 表示仍有余量
0 */6 * * * openssl s_client -connect www.example.com:443 -servername www.example.com /dev/null | openssl x509 -checkend 2592000 -noout || echo "证书即将到期" | mail -s alert ops@example.com
# CDN 场景:抓边缘节点的证书 SHA-256 指纹,与源站比对,防止边缘仍挂着旧证书
openssl s_client -connect www.example.com:443 -servername www.example.com /dev/null
| openssl x509 -noout -fingerprint -sha256
| 检查手段 | 能发现的问题 | 通过判据 | 适用版本/前提 |
|---|---|---|---|
s_client -verify_hostname |
SAN 不含该域名、SNI 未生效 | Verify return code: 0 (ok) |
OpenSSL 1.1.1 / 3.x |
x509 -checkhost / -checkip |
证书文件本身错配、IP SAN 缺失 | does match |
OpenSSL 1.1.0+ |
curl --resolve |
单节点证书错误、IPv6 漏配 | 退出码 0 + verify ok |
curl 7.21.3+ |
| 浏览器 / SSL Labs | 链不完整、中间证书缺失 | 无警告、链完整 | — |
四类工具结论一致,才能确认这次 ssl 证书不匹配域名的问题真正闭环;只要有一项不一致,优先怀疑 SNI 分流或 CDN 边缘未刷新——这两处最容易出现”源站已修好、用户仍报错”的情况。
不匹配是主机名校验失败,浏览器报 ERR_CERT_COMMON_NAME_INVALID;过期是有效期校验失败,通常报 ERR_CERT_DATE_INVALID。前者要改 SAN、SNI 或 CDN 证书,后者续期并 reload 即可。
通配符只覆盖一个 DNS 标签,`*.example.com` 匹配 a.example.com,不匹配 a.b.example.com。需要为 a.b.example.com 单独签 SAN,或签 `*.b.example.com`(需能控制该 DNS 区)。
先执行 `openssl s_client -connect 源站IP:443 -servername 你的域名 -showcerts`,看返回的 subjectAltName;若 SAN 正确,查 default_server、CDN 边缘证书和负载均衡监听器。`nginx -T` 可确认是否有重复 443 server 抢先匹配。
可以,一张证书写多个 `-d`:`certbot certonly –nginx -d example.com -d www.example.com`,有效期 90 天。按 Let's Encrypt 文档,注册域名证书限额为每 7 天 50 张、重复证书每周 5 张,生产环境应配置 `certbot renew –dry-run` 和 deploy-hook。
只有裸域+www 选多域名 DV 最省事;一级子域很多选通配符 DV;需要展示组织信息或合规选 OV/EV,但 OV/EV 也不能替代 SAN。价格参考:DV 0-800 元/年、OV 800-3000 元/年、EV 2000-8000 元/年,以 CA 报价为准。
不是,它通常表示服务器只发了叶子证书,缺少中间 CA,客户端无法构建完整链。把 fullchain.pem(叶子+中间)部署到 Nginx/Apache,或用 `openssl s_client -showcerts` 检查证书链数量;域名不匹配的报错会明确写 `no alternative certificate subject name matches`。
先用无痕窗口和 `curl –resolve` 直连源站复测,区分浏览器缓存与边缘节点;CDN 证书部署通常 1-10 分钟生效,多节点可能更久。若源站通过而域名访问不通过,优先查 CDN 控制台证书绑定、CNAME 和回源 Host。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。