Apache AH01909 完全解决:证书名称与 ServerName 不匹配的根因、修复与验证
AH01909 是什么:告警文本、触发时机与真实影响
AH01909 是 mod_ssl 在配置解析阶段抛出的告警,完整文本形如:
[Tue Mar 12 10:21:33.123456 2024] [ssl:warn] [pid 2311:tid 139876543210] AH01909: shop.example.com:443:0 server certificate does NOT include an ID which matches the server name
拆开看是三段信息:shop.example.com 是该 VirtualHost 的 ServerName;443 是监听端口;后半句说明加载的证书里没有任何一个标识(SAN 扩展中的 dNSName,或在 SAN 缺失时回退到 Subject CN)能匹配这个名字。
触发时机很关键。它出现在 Apache 启动或 graceful reload 的 post_config 阶段,由 mod_ssl 遍历全部 SSL vhost,把 server_hostname 与证书标识列表逐一比对。这是“配置期静态检查”,不需要真实客户端握手就会打印。级别是 warn,Apache 照常启动并监听 443,所以很多人直接忽略,直到用户反馈“网站证书报错”。
为什么必须处理:RFC 6125 之后的现代客户端(Chrome 58+、Firefox、Safari、Go、Java 11+、curl 7.50+)已不再回退 CN,只认 SAN。一条 AH01909 基本等价于“该 vhost 的证书对这个域名无效”,浏览器给出 NET::ERR_CERT_COMMON_NAME_INVALID,curl 报 curl: (60) SSL: no alternative certificate subject name matches target host name。
还要与 AH02032 区分:AH02032: Hostname example.com:443 provided via SNI and hostname shop.example.com provided via HTTP are different 属于请求期错误,表示 SNI 与 Host 头指向不同 vhost。两者常成对出现:先有 AH01909 说明配置错位,再有 AH02032 说明请求落到了错误的 vhost 上。
根因拆解:ServerName 与证书标识对不上的五种典型情况
归纳起来只有一句话:证书标识集合与 ServerName 没有交集。实际排障中,绝大多数问题落在下面五类。
一、ServerName 形态错误。写成 ServerName https://example.com(带协议)、ServerName example.com:443(带端口,部分版本比较时不做剥离)、ServerName example.com.(末尾根点)、大小写混写,或直接写 IP。规范写法是不带协议、不带端口、不带末尾点的纯主机名,端口由 <VirtualHost *:443> 决定。
二、证书覆盖范围不符。证书只有 www.example.com,ServerName 却是裸域 example.com;通配符 *.example.com 只覆盖一级子域,既不含 example.com,也不含 a.b.example.com;用 IP 访问而证书没有 IP SAN。
三、vhost 复用证书。复制 ssl.conf 后忘改 SSLCertificateFile,A 站点的 vhost 加载了 B 站点的证书;或在一个 443 vhost 里堆多个 ServerAlias,却只配了一张单域名证书。
四、默认 443 vhost 兜底失败。第一个(或显式标记的)443 vhost 是无 SNI 客户端和未匹配 SNI 的兜底。若它的 ServerName 与自身证书不符,同样打印 AH01909,而且会让不带 SNI 的老客户端、部分监控探针、负载均衡健康检查拿到错误证书。
五、配置未生效。证书已换新但只跑了 apachectl -t 没 reload;reload 失败回滚到旧配置;或前面还有一层 Nginx/CDN 终止了 TLS,Apache 上看到的告警与实际对外证书无关。
排查顺序建议先二后一:先看证书 SAN 有什么,再看 ServerName 写了什么,最后才怀疑 vhost 顺序与缓存。
三分钟定位:apachectl -S 加 openssl 联合排查
第一步,列出全部 vhost 绑定与默认服务器:
apachectl -S
# 或
httpd -S
# 只看 vhost 树,同时校验语法
apachectl -t -D DUMP_VHOSTS
典型输出:
VirtualHost configuration:
*:443 is a NameVirtualHost
default server default.invalid (/etc/httpd/conf.d/000-default-ssl.conf:3)
port 443 namevhost default.invalid (/etc/httpd/conf.d/000-default-ssl.conf:3)
port 443 namevhost example.com (/etc/httpd/conf.d/example-ssl.conf:5)
port 443 namevhost shop.example.com (/etc/httpd/conf.d/shop-ssl.conf:5)
ServerRoot: "/etc/httpd"
关注三件事:default server 指向哪个文件;每个 namevhost 的 ServerName 拼写;行号对应的配置文件路径。复用证书的问题往往一眼可见:两个 vhost 指向同一个 SSLCertificateFile。
第二步,逐个证书导出 SAN:
openssl x509 -in /etc/pki/tls/certs/shop.example.com.crt -noout
-subject -issuer -dates -ext subjectAltName
OpenSSL 1.1.1 以下没有 -ext,改用:
openssl x509 -in /etc/pki/tls/certs/shop.example.com.crt -noout -text
| grep -A1 'Subject Alternative Name'
第三步,从线上实际握手取证书,排除“文件改了没 reload”的假象:
openssl s_client -connect 127.0.0.1:443 -servername shop.example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -dates -ext subjectAltName
连 127.0.0.1 并显式带 -servername,等于在服务器本地模拟 SNI 路由,能精确验证某个域名最终拿到哪张证书。把 -servername 去掉再跑一次,得到的就是默认 vhost 的证书,用于验证第四类根因。
完整修复步骤:从备份到 reload 的可执行命令
步骤 1:备份并记录现状。
tar czf /root/httpd-ssl-$(date +%F).tar.gz /etc/httpd/conf.d /etc/httpd/conf/httpd.conf
apachectl -S > /root/vhosts-before.txt 2>&1
步骤 2:对齐 ServerName。把每个 443 vhost 的 ServerName 改成证书 SAN 中确实存在的纯主机名;证书未覆盖的域名从 ServerAlias 中删除,或补进证书 SAN。
步骤 3:需要重签时生成含 SAN 的 CSR。
openssl req -new -newkey rsa:2048 -nodes
-keyout /etc/pki/tls/private/example.com.key
-out /etc/pki/tls/certs/example.com.csr
-subj '/C=CN/ST=Beijing/L=Beijing/O=Example Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl req -in /etc/pki/tls/certs/example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
CSR 中的 SAN 必须与最终证书一致,多数 CA 以 CSR 的 SAN 为准。注意证书有效期上限:公有 CA 签发的 TLS 证书最长 398 天(CA/B Forum 规定),Let’s Encrypt 为 90 天,必须配置自动续期而不是手工换证。
步骤 4:部署证书并验证链。Apache 2.4.8 起 SSLCertificateChainFile 已废弃,中间证书直接拼进 fullchain 交给 SSLCertificateFile:
cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile /etc/pki/tls/certs/ca-bundle.crt fullchain.pem
步骤 5:语法检查与 reload。
apachectl configtest # 必须输出 Syntax OK
systemctl reload httpd # Debian/Ubuntu: systemctl reload apache2
步骤 6:复查日志。
journalctl -u httpd --since '5 min ago' | grep -i 'AH01909|AH02032'
无输出即表示配置期检查通过。若仍有输出,说明还有 vhost 未对齐,回到步骤 2 逐个处理,不要靠重启掩盖问题。
配置示例:单站点、多站点 SNI 与默认 443 vhost
先放一个兜底 vhost,文件命名保证它被最先加载(如 000-default-ssl.conf),其证书必须覆盖自身 ServerName,否则它自己就会触发 AH01909:
# /etc/httpd/conf.d/000-default-ssl.conf
Listen 443 https
<VirtualHost *:443>
ServerName default.invalid
DocumentRoot /var/www/empty
SSLEngine on
SSLCertificateFile /etc/pki/tls/certs/default.invalid.crt
SSLCertificateKeyFile /etc/pki/tls/private/default.invalid.key
<Directory /var/www/empty>
Require all denied
</Directory>
</VirtualHost>
正式站点每个域名一个 vhost,各用各的证书:
# /etc/httpd/conf.d/example-ssl.conf
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
DocumentRoot /var/www/example
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305
SSLHonorCipherOrder off
ErrorLog logs/example-ssl-error_log
CustomLog logs/example-ssl-access_log combined
</VirtualHost>
再看一个典型错误写法,ServerName 带协议前缀,且证书只覆盖 shop.example.com,必然报 AH01909:
# 错误示例
<VirtualHost *:443>
ServerName https://shop.example.com
SSLCertificateFile /etc/pki/tls/certs/shop.example.com.crt
</VirtualHost>
要点:ServerAlias 只能列出证书 SAN 中真实存在的域名;TLS 1.3 的套件不通过 SSLCipherSuite 配置,改它不会影响 1.3 握手;多站点场景下 vhost 顺序决定默认兜底,不要依赖“碰巧第一个”。
方案对比:单域名、SAN、通配符与独立 vhost 怎么选
证书类型直接决定 ServerName 能写什么,选型错误是 AH01909 的长期来源:
| 证书类型 | 覆盖范围 | 典型场景 | 优点 | 限制与坑 |
|---|---|---|---|---|
| 单域名 DV | 1 个 FQDN | 单站点 | 便宜、签发快 | www 与裸域需 SAN 或两张证书 |
| 多域名 SAN | 多个 FQDN,可跨主域 | 多品牌、多站点 | 一张证书管多域 | 追加域名需重签,单证书 SAN 数量有上限 |
| 通配符 | *.example.com 一级子域 | 大量同级子域 | 新增子域免重签 | 不覆盖 example.com,不覆盖 a.b.example.com |
| 自签 | 任意 | 默认 vhost、内网 | 免费、完全可控 | 公共客户端不信任 |
排查手段也有取舍,建议组合使用:
| 手段 | 作用 | 输出要点 | 局限 |
|---|---|---|---|
| apachectl -S | vhost 与 ServerName 映射、默认 vhost | default server / namevhost / 文件行号 | 不显示证书内容 |
| apachectl -t -D DUMP_VHOSTS | 语法校验 + vhost 树 | 端口、配置路径 | 不显示证书内容 |
| openssl x509 -ext subjectAltName | 读文件里证书的 SAN | DNS:example.com, DNS:www.example.com | 需 OpenSSL 1.1.1+ |
| openssl s_client -servername | 模拟 SNI 实际握手 | 返回证书 subject/SAN | 需端口可达 |
| curl -vI | 端到端验证 | SSL certificate verify ok | 依赖本地 CA 库 |
结论:域名集合稳定的多站点优先“每站点独立 vhost + 独立证书”;子域数量大且同级时用通配符并额外给裸域配 SAN;不要为了省事把一个 443 vhost 当万能容器,那正是 AH01909 与 AH02032 的高发写法。
常见错误排查:真实报错与对应处置
1. AH01909 反复出现。按前文的五类根因逐条核对,重点是 apachectl -S 中是否有两个 vhost 指向同一证书文件。
2. AH02032 与 AH01909 同时出现。报错 AH02032: Hostname example.com:443 provided via SNI and hostname shop.example.com provided via HTTP are different。说明请求的 SNI 与 Host 头不一致,通常是反向代理或 CDN 回源时改了 Host 头。处置:在代理层统一 SNI 与 Host,或为回源单独建 vhost。
3. curl 报 curl: (60) SSL: no alternative certificate subject name matches target host name 'example.com'。客户端视角的 AH01909,直接确认证书 SAN 是否包含该域名,注意裸域与 www 是两个独立标识。
4. AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate!开启 OCSP Stapling 但 SSLCertificateFile 里没有中间证书。处置:改用 fullchain,或补 SSLStaplingTrustedFirst on 并确认链完整。
5. AH02572: Failed to configure at least one certificate and key for example.com:443证书与私钥不配对,或路径权限不足。用 openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in priv.key | openssl md5 比对,两个 md5 必须一致。
6. curl: (60) unable to get local issuer certificate链不全。浏览器可能靠 AIA 自动补链而 curl 不会,务必部署完整 fullchain。
7. reload 后告警仍在。检查是否有多个 Include 引入了同一域名的重复 vhost、systemd 加载了不同 ServerRoot、或 reload 实际失败被回滚,查看 journalctl -u httpd -n 50 确认。
效果验证与持续监控
修复后先做配置级验证:
apachectl configtest
# 输出 Syntax OK 才继续
systemctl reload httpd
再做握手级验证,-verify_hostname 会真正校验证书是否覆盖目标域名:
openssl s_client -connect example.com:443 -servername example.com
-verify_hostname example.com </dev/null
输出中必须看到 Verify return code: 0 (ok)。多站点批量校验可以写循环:
for h in example.com www.example.com shop.example.com; do
echo "== $h"
openssl s_client -connect $h:443 -servername $h </dev/null 2>/dev/null
| openssl x509 -noout -checkhost $h -dates
done
期望每个域名都输出 Hostname ... does match certificate,并给出 notAfter 日期。
应用层验证:
curl -sSI https://example.com | head -n1
curl -vI https://shop.example.com 2>&1 | grep -E 'subject:|issuer:|SSL certificate verify'
最后确认告警归零,并把它变成监控项:
journalctl -u httpd --since '1 hour ago' | grep -c AH01909
# 期望输出 0
持续运维建议:把 AH01909/AH02032 的日志计数接入告警;对证书到期做提前 30 天提醒,公有 CA 证书最长 398 天、Let’s Encrypt 仅 90 天,靠人工换证迟早出事,用 certbot renew --dry-run 定期演练续期;新站点上线前把 apachectl -S 输出与证书 SAN 做一次人工比对,比事后排查便宜得多。
常见问题
它是 warn 级别,Apache 仍会正常启动并监听 443,但意味着该 vhost 的证书不覆盖其 ServerName。现代浏览器只认 SAN,客户端会直接报证书名称不匹配,因此生产环境必须处理,不能当作无害提示忽略。
不建议。端口应由 VirtualHost 的 *:443 决定,ServerName 写成纯主机名最稳妥。带协议前缀、带端口或带末尾根点都可能导致 mod_ssl 比对失败,从而误报 AH01909。
通配符只匹配一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com。解决办法是把裸域加入证书 SAN,或为裸域单独签发一张证书并配置独立 vhost。
只有在证书 SAN 覆盖全部域名时才可行。否则每个域名应建独立 vhost 并各自加载对应证书,同时保证默认兜底 vhost 的 ServerName 与其证书一致,避免无 SNI 客户端拿到错误证书。[/sg_faq_question]
公有 CA 签发的 TLS 证书目前最长 398 天,Let’s Encrypt 为 90 天。行业已确定逐步缩短有效期,因此应使用 certbot 等工具自动续期并定期 dry-run 演练,不要依赖人工换证。