跳到主要内容

Nginx 报 SSL_CTX_use_PrivateKey_file() failed:证书与私钥不匹配的完整排查与修复

报错现象与根本原因

执行 nginx -t 或 systemctl reload nginx 时出现下面的致命错误:

nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed
(SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)

错误码 0B080074 和函数名 X509_check_private_key 已经把原因写死了:Nginx 成功读到了证书,也成功读到了私钥,但两者不是同一对。OpenSSL 在加载时会用私钥去比对证书中的公钥信息(RSA 比 modulus,ECC 比曲线点),只要不一致就 [emerg] 退出,配置不生效。

生产环境里最常见的五类来源:

  • 文件错配:一台机器跑多个站点,ssl_certificate 指了 A 站点的 fullchain,ssl_certificate_key 指了 B 站点的 privkey。
  • 重签只换一半:CA 重新签发时生成了新密钥对,运维只覆盖了 fullchain.pem,旧的 privkey.pem 没动。
  • 软链断裂或指向旧版本:Let’s Encrypt 的 /etc/letsencrypt/live/ 下是软链,指向 archive/ 中带序号的文件,手工复制或误删后可能指向过期版本。
  • 多 server 块复用:公共 TLS 片段里写死了证书路径,所有 server_name 都加载同一对文件。
  • 证书链文件异常:把私钥内容拼进 fullchain,或链里混入根证书、重复中间证书,导致解析与校验失败。

需要特别注意:reload 失败时 Nginx 主进程会继续用旧配置和旧证书对外服务,浏览器访问一切正常,于是很多人误以为“已经改好了”。判断是否真正生效,必须看 nginx -t 是否通过,以及 s_client 实际返回的证书指纹。

三分钟定位:校验证书与私钥是否配对

不要靠文件名猜,直接比公钥。RSA 证书用 modulus,ECC 与 Ed25519 必须用 pubkey。

# RSA 证书 + RSA 私钥
openssl x509 -noout -modulus -in /etc/nginx/ssl/example.com.fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in /etc/nginx/ssl/example.com.key          | openssl md5

# 通用写法(RSA / ECC / Ed25519 都适用,推荐)
openssl x509 -in cert.pem -noout -pubkey | openssl sha256
openssl pkey -in key.pem  -pubout        | openssl sha256

两条命令输出的哈希必须完全一致,例如都是 (stdin)= 3f7a9c...e1。不一致就是“不配对”,不需要再往下猜。这是整个排查中最关键、也最快的一步。

注意 -modulus 只对 RSA 有意义,对 ECC 证书会输出 Modulus=unavailable;反过来用 openssl rsa -modulus 读 PKCS#8 或 ECC 私钥会直接报错。遇到这种情况统一改用 openssl pkey 即可。

顺手把证书本身的信息打出来,确认域名和有效期没有拿错文件:

openssl x509 -in cert.pem -noout -subject -issuer -dates -ext subjectAltName
openssl pkey -in key.pem -noout -text | head -n 3   # 看密钥类型与位数

还要确认 Nginx 真正加载的是哪个文件,而不是你以为的那个:

nginx -T 2>/dev/null | grep -nE 'server_name|ssl_certificate|ssl_certificate_key'
ls -l /etc/letsencrypt/live/example.com/   # 检查软链指向

nginx -T 会打印 include 展开后的完整配置,多 server 块复用错文件的情况一眼可见。如果 nginx -t 直接失败导致 -T 也不输出,就先注释掉有问题的 server 块再执行。

完整实操:从排查到修复的七步

第 1 步,确认实际加载路径。

nginx -T 2>/dev/null | grep -nE 'server_name|ssl_certificate|ssl_certificate_key'

第 2 步,确认文件类型正确。

head -n 1 /etc/nginx/ssl/example.com.fullchain.pem   # -----BEGIN CERTIFICATE-----
head -n 1 /etc/nginx/ssl/example.com.key             # -----BEGIN PRIVATE KEY----- 或 BEGIN RSA/EC PRIVATE KEY
grep -c 'BEGIN CERTIFICATE' /etc/nginx/ssl/example.com.fullchain.pem   # 通常为 2

如果 key 文件首行是 BEGIN CERTIFICATE,就是把证书填到了私钥位置,这是最常见的低级错误。

第 3 步,公钥比对,哈希不一致即确认不配对。

第 4 步,检查域名与有效期。

openssl x509 -in fullchain.pem -noout -subject -dates -ext subjectAltName

第 5 步,检查权限与安全上下文。

chown root:root /etc/nginx/ssl/example.com.key
chmod 600 /etc/nginx/ssl/example.com.key
chmod 700 /etc/nginx/ssl
restorecon -Rv /etc/nginx/ssl    # SELinux 启用时执行

第 6 步,修复。两条路径:CA 用你提交的 CSR 签发,私钥不变,只替换 fullchain;CA 或面板重新生成了密钥对,则 fullchain 与 privkey 必须一起替换。重新生成密钥与 CSR:

openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
openssl req -new -key 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 -verify -key example.com.key   # 校验 CSR 与 key 匹配

Let’s Encrypt 用户直接续期,并加 deploy hook 保证续期后自动 reload:

certbot renew --dry-run
cat >/etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh <<'EOF'
#!/bin/sh
nginx -t && systemctl reload nginx
EOF
chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh

第 7 步,验证后再 reload。nginx -t 通过才执行 systemctl reload nginx,顺序不能反。注意公共 TLS 证书单张最长有效期 398 天,Let’s Encrypt 为 90 天,续期必须自动化,否则到期换证时又会因“只换了一半”而复现本故障。

Nginx TLS 配置示例

证书路径必须与私钥严格成对,且 ssl_certificate 指向“叶证书 + 中间证书”的拼接文件,顺序不能颠倒:

server {
    listen 443 ssl;
    http2 on;                       # nginx >= 1.25.1;旧版本用 listen 443 ssl http2;
    server_name example.com www.example.com;

    ssl_certificate         /etc/nginx/ssl/example.com.fullchain.pem;  # 叶证书在前,中间证书在后
    ssl_certificate_key     /etc/nginx/ssl/example.com.key;            # 必须与上面配对
    ssl_trusted_certificate /etc/nginx/ssl/example.com.chain.pem;      # 仅供 OCSP stapling 校验

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_session_tickets off;

    ssl_stapling on;
    ssl_stapling_verify on;
    resolver 223.5.5.5 1.1.1.1 valid=300s;
    resolver_timeout 5s;

    add_header Strict-Transport-Security "max-age=31536000" always;
}

三个要点:ssl_certificate 里不要放根证书,否则可能触发 cert already in hash table;ssl_certificate_key 文件权限设为 600、属主 root,Nginx master 以 root 启动即可读取;多站点场景把证书路径写在各自的 server 块里,不要塞进公共 include 片段。

改完执行 nginx -t 检查语法与证书配对,通过后再 reload。若使用容器或配置管理工具,务必把 fullchain 与 privkey 作为一个原子单元分发,避免只同步其中一个文件。

对比表格:五类根因与对应处置

根因 典型表现 验证命令 处置
多站点文件错配 nginx -t 报 key values mismatch,其他站点正常 nginx -T | grep ssl_certificate 按 server 块改正路径
重签只换一半 一直正常,换证后突然 emerg pubkey sha256 比对 fullchain 与 privkey 同时替换
软链指向旧版本 live 目录指向 archive 中的旧序号文件 ls -l /etc/letsencrypt/live/*/ certbot renew –force-renewal 并修复软链
公共片段复用 所有域名返回同一张证书 openssl s_client -servername 证书路径移出公共 include
私钥加密或格式错 PEM_read_bio_PrivateKey failed head -n 1 key.pem 去 passphrase 或换正确文件
密钥位数不足 ca md too weak / key too small openssl pkey -text -noout 重签 2048 位 RSA 或 P-256

这张表覆盖了绝大多数现场情况。实际排查顺序建议自上而下:先确认“Nginx 加载的是哪两个文件”,再确认“这两个文件本身是否配对”,最后确认“文件格式、权限、密钥强度是否合规”。顺序颠倒容易在权限问题上浪费大量时间。

表格中“软链指向旧版本”一类最隐蔽:fullchain.pem 的软链可能被 certbot 更新,而 privkey.pem 因权限或中断未更新,结果就是一半新一半旧。用 ls -l 看两个软链的时间戳是否一致,能快速发现问题。

常见错误排查(含真实报错文本)

1)key values mismatch:本文主题,证书与私钥不配对。按第二节的 pubkey 比对定位,然后同步替换两个文件。

2)私钥位置填了证书:

nginx: [emerg] PEM_read_bio_PrivateKey() failed (SSL: error:0909006C:PEM routines:get_name:no start line:Expecting: ANY PRIVATE KEY)

用 head -n 1 确认文件首行,把 ssl_certificate_key 改回真正的 key 文件。

3)私钥带密码:

SSL_CTX_use_PrivateKey_file() failed (SSL: error:0906406D:PEM routines:PEM_def_callback:problems getting password
 error:0907B068:PEM routines:PEM_read_bio_PrivateKey:bad password read)

Nginx 不支持交互式输入口令,需要去掉加密:openssl pkey -in enc.key -out plain.key,随后 chmod 600 plain.key。

4)证书链重复或顺序错误:

SSL_CTX_use_certificate_chain_file() failed (SSL: error:0B07C065:x509 certificate routines:X509_STORE_add_cert:cert already in hash table)

用 openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout 列出链中所有证书,去掉重复项与根证书,只保留叶证书和中间证书。

5)权限或 SELinux 拦截:

nginx: [emerg] cannot load certificate key "/etc/nginx/ssl/example.com.key":
BIO_new_file() failed (SSL: error:8000000D:system library::Permission denied)

执行 chown root:root、chmod 600,SELinux 环境再跑 restorecon -Rv /etc/nginx/ssl。

6)漏配证书:nginx: [emerg] no "ssl_certificate" is defined for the "listen ... ssl" directive,说明某个 listen 443 ssl 的 server 块缺少证书指令,检查 include 是否被注释。

效果验证

先确认配置与进程状态,再验证握手结果,最后比对线上证书与本地私钥:

nginx -t && systemctl reload nginx
systemctl status nginx --no-pager

# 本地回环带 SNI 验证
openssl s_client -connect 127.0.0.1:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -dates -fingerprint -sha256

# 线上证书公钥 vs 本地私钥公钥,两者必须一致
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -pubkey | openssl sha256
openssl pkey -in /etc/nginx/ssl/example.com.key -pubout | openssl sha256

# 剩余有效期检查,30 天内返回非 0
openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/example.com.fullchain.pem

curl -sI https://example.com | grep -i strict-transport-security

把上述公钥哈希写入监控脚本,每 5 分钟比对一次“线上返回证书”与“磁盘私钥”,就能在证书被误替换时第一时间告警。到期时间可用 openssl x509 -enddate -noout -in cert.pem 提取并接入 Prometheus textfile collector。

进一步可用 testssl.sh --fast https://example.com 检查协议版本、加密套件与证书链完整性,或用 SSL Labs 获取评级。验证通过后建议清理旧证书备份文件,避免下次误用;同时在变更流程中把 fullchain 与 privkey 绑定为一个发布单元,从根源上杜绝“只换一半”。

常见问题

说明 Nginx 加载的不是你比对的那两个文件。用 nginx -T 查看 include 展开后每个 server 块的真实路径,重点排查公共 TLS 片段里写死的路径、/etc/letsencrypt/live 软链指向,以及 reload 是否失败导致主进程仍在使用旧配置。

取决于签发方式。CA 使用你提交的 CSR 签发,公钥来自原私钥,私钥可继续使用,只替换 fullchain 即可;若 CA 或控制面板重新生成了密钥对,必须把 privkey 一并替换,否则就会出现本文报错。

用 openssl x509 -noout -pubkey 与 openssl pkey -pubout 各取公钥做 sha256 比对。不要用 -modulus,ECC 证书会输出 Modulus=unavailable,对 ECDSA 私钥执行 openssl rsa -modulus 也会直接报错。

不需要。正确顺序是叶证书在前、中间证书在后,根证书由客户端本地信任库提供。放入根证书或重复的中间证书容易触发 cert already in hash table,还会增大握手包体积。

公共信任的 TLS 证书单张最长 398 天,Let’s Encrypt 免费证书为 90 天。行业计划未来继续缩短,因此必须配置自动续期和 deploy hook,续期后自动执行 nginx -t 并 reload。

是。reload 失败时 Nginx 主进程保留旧配置继续服务,浏览器看到的仍是旧证书。判断依据是 nginx -t 是否通过、error.log 是否仍有 emerg,以及 s_client 取回的证书指纹是否已更新。