跳到主要内容

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]

先确认 reload 真的成功,再看是否有重复 Include 引入同名 vhost、systemd 是否加载了不同 ServerRoot。用 apachectl -S 核对默认 vhost 与各 namevhost 的证书路径,通常能定位到遗漏的 vhost。


公有 CA 签发的 TLS 证书目前最长 398 天,Let’s Encrypt 为 90 天。行业已确定逐步缩短有效期,因此应使用 certbot 等工具自动续期并定期 dry-run 演练,不要依赖人工换证。