返回文章
排错2026-06-18•3 分钟阅读•CSR.plus 团队

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

主机名不匹配: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 证书一次性覆盖
改了配置仍报错部署的仍是旧证书重载/重启服务并清理缓存

相关工具与延伸阅读

常见问题

为什么以前证书能用现在不行?

旧浏览器和系统在缺少 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 证书。

相关文章