主机名不匹配:SSL 通用名称与 SAN 错误

主机名不匹配(ERR_CERT_COMMON_NAME_INVALID)表示证书没有覆盖你正在访问的域名。现代浏览器只比对证书的"主题备用名称(SAN)"字段,不再使用旧的"通用名称(CN)"。example.com 的证书不覆盖 www.example.com,二者是不同的主机名。修复方法几乎总是按实际提供的域名(含 www)重新签发并写入正确的 SAN 列表,而不是改服务器配置。
主机名如何校验
浏览器把你访问的域名与证书里的 SAN 条目逐一比对,要求至少有一个完全匹配(含通配符规则)。CN 字段自 RFC 9525(2023)起已被正式弃用,浏览器不再用它判断主机名。因此旧式"仅 CN"证书在现代浏览器上会直接失败。
RFC 9525 §6.3: the CN-ID MUST NOT be used for identity matching. Chrome 58 (2017) removed the CN fallback.
通配符与多域名(SAN)证书的区别
通配符 *.example.com 只覆盖一级子域名(如 www.example.com),不覆盖 example.com 本身,也不覆盖 a.b.example.com 这类更深层级。SAN(多域名)证书可以显式列出多个互不相关的主机名。若同时需要 example.com 与 www.example.com,应申请包含两者的 SAN 证书,或用通配符加裸域名组合。
正确的修复方向
用实际提供服务的域名重新签发证书并部署完整链。可用 openssl x509 -in cert.pem -noout -text | grep -A1 "Subject Alternative Name" 检查服务器实际给出的 SAN。不要用 URL 重写或跳转来"回避"——证书必须覆盖访客真正连接的主机名,否则任何客户端都会报错。
第 1 步:确认报错的主机名
从错误页读取你实际访问的完整域名(含子域)。确保它不是拼写错误,也不是被错误重定向到了另一个主机。
第 2 步:查看证书当前的 SAN
用 证书解码器 或上面的 openssl 命令,列出证书里真实的 SAN 列表,确认缺失的是哪个主机名。
第 3 步:按正确主机名重新签发
用 CSR 生成器 生成涵盖所有需要主机名(含 www)的 CSR,提交 CA 签发 SAN 证书。内部服务可改用私有 CA 批量签发。
第 4 步:部署完整链并复检
部署新证书加中级链,再用 SSL 站点检测 复检主机名是否通过。必要时把 www 与主域名做 301 重定向,统一入口。
排错清单
| 现象 | 可能原因 | 处理办法 |
|---|---|---|
| ERR_CERT_COMMON_NAME_INVALID | 证书 SAN 不含当前主机名 | 按实际域名重新签发并写 SAN |
| example.com 正常但 www 报错 | 二者是不同主机名 | SAN 同时包含两者或做重定向 |
| *.example.com 不覆盖裸域名 | 通配符不含裸域名 | 将裸域名加入 SAN 或用重定向 |
| 旧证书在新浏览器失败 | 仅 CN 无 SAN | 重新签发带 SAN 的证书 |
| 多个子域逐一报错 | 未用 SAN 多域名证书 | 改用 SAN 证书一次性覆盖 |
| 改了配置仍报错 | 部署的仍是旧证书 | 重载/重启服务并清理缓存 |
相关工具与延伸阅读
- CSR 生成器:生成含多 SAN 的证书签名请求
- 证书解码器:查看证书 SAN 与有效期
- SSL 站点检测:复检主机名是否通过
- SSL 证书指南:从选型到部署的完整教程
- 相关文章:《修复"您的连接不是私密连接"》、《修复不完整证书链》、《修复 SSL 握手失败》
常见问题
为什么以前证书能用现在不行?
旧浏览器和系统在缺少 SAN 时会回退到 CN 字段。现代浏览器依据 RFC 9525(2023)只认 SAN,所以没有 SAN 的旧证书现在会失败。
www 前缀真的有影响吗?
有。example.com 与 www.example.com 是不同的主机名。请用同时覆盖两者的 SAN 证书或通配符,或将其中一个 301 重定向到另一个。
通配符证书能覆盖所有子域吗?
只能覆盖一级子域(*.example.com 覆盖 www.example.com),不覆盖裸域名 example.com,也不覆盖 a.b.example.com。更深层需要单独写入 SAN。
用服务器重定向能解决不匹配吗?
重定向可以改变"用户访问哪个主机名",但不能改变"证书覆盖哪个主机名"。证书必须覆盖访客最终连接的主机名;重定向只是统一入口的辅助手段。
免费 SSL/TLS 工具
数秒内验证并检查你的证书。
相关证书信息
进一步了解如何选择和购买 SSL 证书。