跳到主要内容

NET::ERR_CERT_INVALID 排查指南:证书格式无效的 5 类根因与修复实操

一、问题背景:握手成功、解析失败的 NET::ERR_CERT_INVALID

NET::ERR_CERT_INVALID 是 Chromium 内核浏览器(Chrome、Edge、Opera 及多数国产双核浏览器)在 TLS 握手完成后抛出的证书解析类错误。它常被误认为“证书不受信任”,但触发点完全不同,先看三个高频错误码的区别:

  • NET::ERR_CERT_AUTHORITY_INVALID:证书能正常解析,但签发者不在信任库(自签名、缺根证书)。
  • NET::ERR_CERT_DATE_INVALID:证书能解析,但不在有效期内(过期或系统时间错误)。
  • NET::ERR_CERT_INVALID:浏览器根本无法把服务器返回的字节流解析成合法 X.509 证书,或用它校验握手签名时失败。

关键差异在于:前两者用户通常还能点“高级 → 继续前往”强行访问(除非被 HSTS 拦截),而 NET::ERR_CERT_INVALID 往往连绕过按钮都不给,因为浏览器无法判断这张证书代表谁。对运维而言,这意味着问题出在文件本身而不是信任关系,排查方向应锁定在证书文件内容、编码格式、私钥匹配三件事上,而不是去折腾 CA 根证书。

触发链路是:客户端发 ClientHello → 服务端返回 Certificate 消息(叶证书 + 中间证书)→ 浏览器调用 BoringSSL 的 X509 解析器 → 解析或验签失败。常见失败点包括:PEM 结构被破坏(缺 BEGIN/END 行、被编辑器加了 BOM、换行符被改成 CRLF);文件里放的其实是私钥或 CSR;证书与私钥算法或密钥对不匹配,导致 CertificateVerify 签名校验失败;二进制 DER 证书被当成 PEM 直接写进配置。

还有一个时效性背景必须说明:CA/Browser Forum 已将公开信任 TLS 证书的最长有效期限制为 398 天(2020 年 9 月起生效,此前为 825 天),Let’s Encrypt 等免费 CA 默认签发 90 天证书。有效期缩短意味着续期部署频率显著提高,而“手工复制粘贴 + 聊天工具传输”恰恰是产生格式损坏的主要来源,这也是该错误在自动化程度低的站点上反复出现的原因。

二、根因分类:五类“证书格式无效”对照表

把 NET::ERR_CERT_INVALID 拆开看,90% 的现场问题都能归入下面五类。先用这张表定位,再进入实操。

类别 典型成因 关键特征 快速判定命令
PEM 结构损坏 编辑器加 BOM、换行被改成 CRLF、复制被截断 首行不是 BEGIN CERTIFICATE head -1 cert.pem
文件类型错位 ssl_certificate 指向了私钥或 CSR 首行为 BEGIN PRIVATE KEY / BEGIN CERTIFICATE REQUEST grep -m1 BEGIN cert.pem
密钥不匹配 续期后只换了证书没换私钥 Nginx 启动失败或握手签名校验失败 公钥哈希比对(见第四节)
算法错配 ECC 私钥配 RSA 证书 RSA 工具报 Not an RSA key openssl x509 -text | grep "Public Key Algorithm"
编码错误 DER 二进制直接配置 file 显示 data,含大量不可打印字符 file cert.pem

需要特别说明第二类:Nginx 的 ssl_certificate 必须指向证书,ssl_certificate_key 指向私钥,两者写反是新手最常见的错误。写反后 Nginx 启动时会直接报 PEM_read_bio_X509_AUX ... no start line,因为私钥文件的第一行是 -----BEGIN PRIVATE KEY-----,X509 解析器读不到证书头。

第三类的隐蔽性最强:证书本身完全合法,openssl x509 能正常解析,但私钥对不上,握手时服务端无法生成正确的 CertificateVerify 签名,部分客户端直接归入 NET::ERR_CERT_INVALID 而不是给出更明确的提示。这种情况在证书续期时最容易出现——运维只把新的 fullchain.pem 覆盖上去,却忘了私钥也换了。

第四类源于双证书部署:站点同时配置了 RSA 和 ECDSA 两套证书,但把 ECDSA 私钥配到了 RSA 证书上。此时 Nginx 会报 key values mismatch,用 openssl rsa -noout -modulus 处理 ECC 私钥则会报 Not an RSA key,容易被误判成文件损坏。

第五类在 Windows 环境尤其常见:用记事本另存 PEM 会追加 CRLF 甚至 BOM(字节 EF BB BF),文件在 Linux 上看内容“没变”,但首行前多了三个不可见字节,X509 解析器直接失败。

三、实操第一步:用 OpenSSL 三步验证证书文件完整性

不要靠肉眼判断,直接上命令。以下三步按顺序执行,任何一步失败就停在那里排查。

# 步骤 1:文件类型与 PEM 段结构
file /etc/nginx/ssl/fullchain.pem
head -1 /etc/nginx/ssl/fullchain.pem
tail -1 /etc/nginx/ssl/fullchain.pem
grep -c -- "-----BEGIN CERTIFICATE-----" /etc/nginx/ssl/fullchain.pem

# 步骤 2:检查 BOM 与不可见字符
head -c 3 /etc/nginx/ssl/fullchain.pem | xxd
grep -nP "[^x00-x7F]" /etc/nginx/ssl/fullchain.pem | head

# 步骤 3:解析证书本体
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -subject -issuer -dates -serial

期望输出类似:

subject=CN = example.com
issuer=C = US, O = Let's Encrypt, CN = R11
notBefore=Mar  1 00:00:00 2025 GMT
notAfter=May 30 23:59:59 2025 GMT
serial=03A1B2C3...

判定要点:

  • file 应输出 PEM certificate;若输出 data 或 ASCII text, with CRLF line terminators,说明是 DER 二进制或换行符异常。
  • head -1 必须精确等于 -----BEGIN CERTIFICATE-----,前面多一个空格、一个 BOM 都会失败。
  • head -c 3 | xxd 若输出 efbb bf,说明带 UTF-8 BOM,用 sed -i '1s/^xEFxBBxBF//' cert.pem 去掉。
  • grep -c 的结果:只配叶证书时为 1,配置 fullchain 时应 ≥ 2。若为 0,说明文件里根本没有证书。
  • notAfter - notBefore 应 ≤ 398 天(公开信任证书),Let’s Encrypt 为 90 天。若超过 398 天,说明这张证书来自内部 CA 或旧规范,现代浏览器可能拒绝。

如果 openssl x509 报错,错误信息本身就是诊断线索:

  • unable to load certificate ... error:0909006C:PEM routines:get_name:no start line:文件不是 PEM 或首行损坏。
  • error:0D0680A8:asn1 encoding routines:asn1_check_tlen:wrong tag:内容被截断或混入了非 Base64 字符。
  • error:0906D06C:PEM routines:PEM_read_bio:no start line:常见于文件为空或只有换行。

顺带确认证书链拼接顺序是否正确——叶证书必须在最前面,中间证书在后,根证书不要放(放了不会报错,但会增大握手体积):

cat example.com.crt intermediate.crt > fullchain.pem
awk '/BEGIN CERTIFICATE/{n++} {print > "part"n".pem"}' fullchain.pem
openssl x509 -in part1.pem -noout -subject   # 应为你的域名

四、实操第二步:核对私钥匹配与算法一致性

文件能解析不代表能握手,第二步必须验证“证书里的公钥”和“私钥”是同一对。用公钥哈希比对,RSA 和 ECDSA 通用:

# 通用方法(推荐,RSA / ECDSA 都适用)
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -pubkey | openssl sha256
openssl pkey -in /etc/nginx/ssl/privkey.pem -pubout | openssl sha256

# RSA 专用方法
openssl x509 -in cert.pem -noout -modulus | openssl sha256
openssl rsa -in privkey.pem -noout -modulus | openssl sha256

两次输出的哈希值完全一致,才算匹配。不一致就是典型的 key values mismatch。

接着核对算法,避免 ECC 私钥配 RSA 证书:

openssl x509 -in cert.pem -noout -text | grep -E "Public Key Algorithm|Public-Key"
openssl pkey -in privkey.pem -noout -text | head -2

期望看到 Public Key Algorithm: id-ecPublicKey 配 ASN1 OID: prime256v1,或 rsaEncryption 配 Public-Key: (2048 bit)。两边算法必须一致。

还要检查私钥是否被加密。执行 grep -m1 "BEGIN.*PRIVATE KEY" privkey.pem,如果输出 BEGIN ENCRYPTED PRIVATE KEY,说明私钥带 passphrase,Nginx 启动时会提示输入密码或直接失败。用下面的命令解密(会提示输入原密码):

openssl pkey -in privkey.pem -out privkey.dec.pem
chmod 600 privkey.dec.pem

常见误判提醒:对 ECC 私钥执行 openssl rsa -noout -modulus -in privkey.pem 会报 Not an RSA key 或 unable to load Private Key,这不是文件损坏,而是命令用错了,改用 openssl pkey -pubout。

最后做一次端到端匹配验证,让 OpenSSL 自己告诉你结果:

openssl x509 -in cert.pem -noout -pubkey > cert.pub
openssl pkey -in privkey.pem -pubout -out key.pub
diff cert.pub key.pub && echo "MATCH"

输出 MATCH 才能进入部署环节。这一步建议写进 CI 或续期脚本的 post-hook,Let’s Encrypt 的 certbot 可以用 --deploy-hook 挂上校验脚本,从源头杜绝“只换证书不换私钥”。

五、实操第三步:安全传输与服务器端部署

大量 NET::ERR_CERT_INVALID 是在“传输”这一环产生的。微信、QQ、钉钉等 IM 工具会把 .pem 当文本预览并重新编码,可能插入 BOM、把 LF 改成 CRLF、追加空行,甚至改扩展名。浏览器网页里 Ctrl+C 复制证书正文同样不可靠。

正确做法是打包后走 scp/sftp/rsync,并在两端做哈希校验:

# 源端打包并计算哈希
tar czf cert-bundle.tgz fullchain.pem privkey.pem
sha256sum fullchain.pem privkey.pem | tee cert.sha256

# 传输
scp -C cert-bundle.tgz root@203.0.113.10:/tmp/
# 或
rsync -avz --checksum fullchain.pem privkey.pem root@203.0.113.10:/etc/nginx/ssl/

# 目标端解包并校验
cd /tmp && tar xzf cert-bundle.tgz
sha256sum -c cert.sha256

两端哈希一致才算传输无损。随后处理权限与 SELinux 上下文,这两项也是“文件明明存在却加载失败”的高频原因:

chown root:root /etc/nginx/ssl/*.pem
chmod 644 /etc/nginx/ssl/fullchain.pem
chmod 600 /etc/nginx/ssl/privkey.pem
restorecon -Rv /etc/nginx/ssl      # CentOS / RHEL 必须执行
ls -lZ /etc/nginx/ssl/

Nginx 的 master 进程以 root 读取证书,worker 以 nginx 用户运行,因此证书 644、私钥 600 是安全且可用的组合。若在 CentOS 上忘记 restorecon,会看到 BIO_new_file() failed (SSL: error:0200100D:system library:fopen:Permission denied),用 ls -lZ 对比 /etc/nginx/ssl 与 /etc/nginx 的 context 即可确认。

部署顺序建议:先把新文件传到临时目录并校验 → 备份旧文件 → 替换 → nginx -t → nginx -s reload → 用 openssl s_client 验证线上实际下发的证书。这样即使新证书有问题,也能在 reload 之前回滚,不会出现“配置已 reload 但 worker 起不来”的尴尬。

六、配置示例:Nginx 与 Apache 的正确写法

Nginx 单证书配置(含 TLS 1.3 与 HSTS):

server {
    listen 443 ssl;
    http2 on;                                   # Nginx 1.25.1+;旧版写 listen 443 ssl http2;
    server_name example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 叶证书 + 中间证书
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;     # 私钥,勿与上一行写反

    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;

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

RSA + ECDSA 双证书(Nginx 1.11.0+ 支持同一 server 块内重复出现):

ssl_certificate     /etc/nginx/ssl/fullchain.rsa.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.rsa.pem;
ssl_certificate     /etc/nginx/ssl/fullchain.ecdsa.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.ecdsa.pem;

Apache 2.4.8 及以上:

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile    /etc/httpd/ssl/fullchain.pem
    SSLCertificateKeyFile /etc/httpd/ssl/privkey.pem
    # 2.4.8 起证书链并入 SSLCertificateFile,SSLCertificateChainFile 已废弃
    SSLProtocol -all +TLSv1.2 +TLSv1.3
</VirtualHost>

配置层面的三条铁律:第一,ssl_certificate 与 SSLCertificateFile 指向的必须是证书文件,内容以 BEGIN CERTIFICATE 开头;第二,指向私钥的那一行必须单独存在且路径不同,写反必然报 no start line;第三,证书文件里要包含中间证书,否则部分客户端会报 unable to get local issuer certificate,虽然错误码不同,但同样导致页面打不开。

改完配置先 nginx -t,输出 syntax is ok 与 test is successful 再 reload。Apache 用 apachectl configtest,输出 Syntax OK 才生效。

七、对比表格:错误配置与正确配置速查

项目 错误做法 典型现象 / 报错 正确做法
配置指令 ssl_certificate 指向 privkey.pem nginx: [emerg] PEM_read_bio_X509_AUX … no start line ssl_certificate 指证书,ssl_certificate_key 指私钥
证书链 只配叶证书,缺中间证书 curl: (60) unable to get local issuer certificate 配 fullchain.pem(叶 + 中间)
文件编码 用记事本或聊天工具另存 首行带 BOM 或 CRLF,解析失败 scp/rsync 传输并 sha256sum 比对
密钥配对 续期只替换 crt,不换 key X509_check_private_key:key values mismatch 证书与私钥同批替换并做哈希校验
算法一致性 ECC 私钥配 RSA 证书 Not an RSA key / 握手签名校验失败 算法一致,或 RSA+ECDSA 双证书并行
文件权限 私钥 644 或属主不是 root BIO_new_file() failed … Permission denied 私钥 600、属主 root,SELinux 执行 restorecon

再看 RSA 与 ECDSA 两种证书的选型差异,这直接影响你是否需要部署双证书:

维度 RSA 2048 ECDSA P-256
证书体积 约 1.2 KB 约 0.8 KB
握手签名速度 较慢 快约 3-5 倍
兼容性 全平台通吃 Android 4.x 及更老系统不支持
部署方式 单证书即可 建议与 RSA 双证书并存
有效期上限 398 天(公开信任) 398 天(公开信任)

实践建议:面向公众的站点用双证书,老客户端回落 RSA,新浏览器走 ECDSA;内网或客户端可控的服务可以只用 ECDSA。无论哪种,fullchain.pem 与 privkey.pem 都必须成对管理,建议在文件名里带上算法后缀,避免手工替换时张冠李戴。

八、常见错误排查:真实报错逐条对照

下面这些报错都来自实际生产环境,按出现频率排序,可直接对照定位。

1. Nginx 启动即失败,指向证书文件:

nginx: [emerg] PEM_read_bio_X509_AUX("/etc/nginx/ssl/fullchain.pem") failed
(SSL: error:0909006C:PEM routines:get_name:no start line:Expecting: TRUSTED CERTIFICATE)

含义:这个文件的第一行不是证书头。用 head -1 确认,多半是指向了私钥、CSR,或文件带 BOM。

2. 证书与私钥不匹配:

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

含义:证书里的公钥和私钥不是一对。执行第四节的公钥哈希比对,重新配对。

3. 权限或 SELinux 拦截:

nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed
(SSL: error:0200100D:system library:fopen:Permission denied:fopen('/etc/nginx/ssl/fullchain.pem','r'))

含义:Nginx 进程读不到文件。检查 ls -lZ 的属主与 SELinux context,执行 restorecon -Rv /etc/nginx/ssl。

4. Apache 密钥不匹配:

AH02565: Certificate and private key example.com:443:0 from /etc/httpd/ssl/fullchain.pem
and /etc/httpd/ssl/privkey.pem do not match

含义同上,替换为匹配的一对即可。

5. 缺少中间证书:

curl: (60) SSL certificate problem: unable to get local issuer certificate

含义:服务端只下发了叶证书。把中间证书拼进 fullchain.pem 后 reload。

6. 证书文件被截断:

unable to load certificate
140736...:error:0D0680A8:asn1 encoding routines:asn1_check_tlen:wrong tag

含义:Base64 内容不完整或混入了非 Base64 字符。用 tail -1 确认 END 行存在,必要时重新下载。

7. 老算法被客户端拒绝:

curl: (35) error:0A00018E:SSL routines::ca md too weak

含义:证书使用了 SHA-1 签名,现代 OpenSSL 3.x 与浏览器均拒绝。必须向 CA 重新签发 SHA-256 证书。

排查顺序建议固定为:nginx -t 看报错 → openssl x509 解析文件 → 公钥哈希比对 → openssl s_client 验证线上链。四步走完,99% 的 NET::ERR_CERT_INVALID 都能定位到具体文件或具体配置行。

九、效果验证:从本机到浏览器的四层确认

修复后不要只看“页面能打开”,按下面四层逐级验证。

第一层,配置语法:

nginx -t && nginx -s reload
# 期望:syntax is ok / test is successful

第二层,本机握手与证书内容:

openssl s_client -connect 127.0.0.1:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

确认 subject 是目标域名、issuer 是预期 CA、notAfter 在未来 398 天以内(Let’s Encrypt 为 90 天内)。

第三层,证书链与协议协商:

openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1 
  | grep -E "Verify return code|Protocol|Cipher"
# 期望:Verify return code: 0 (ok)

# 确认下发了完整链(应 ≥ 2)
openssl s_client -showcerts -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | grep -c "BEGIN CERTIFICATE"

若 Verify return code 非 0,说明链仍不完整或根证书不被信任,回到第八节第 5 条处理。

第四层,端到端 HTTPS 请求:

curl -vI https://example.com --resolve example.com:443:203.0.113.10 2>&1 
  | grep -E "SSL certificate verify|subject:|issuer:|HTTP/"
# 期望:SSL certificate verify ok. 且 HTTP/2 200

最后在浏览器侧确认:F12 → Security 面板应显示 “This page is secure (valid HTTPS)”;或在 chrome://net-internals/#events 中搜索 CERT,确认没有 CERT_INVALID 事件。对外站点再跑一次 SSL Labs 评级,A 或 A+ 即可认为证书链、协议版本、密钥强度全部达标。建议把上述命令写成巡检脚本,在每次续期部署后自动执行。

常见问题

前者是浏览器无法把服务器返回的字节流解析成合法 X.509 证书,或证书与私钥不匹配导致签名校验失败,属于文件本身的问题;后者是证书能正常解析,但签发者不在信任库,属于信任链问题。前者通常连“继续访问”按钮都不提供,排查方向应锁定文件格式与密钥配对。

肉眼看不到 BOM、CRLF、尾部空行和不可见字符,也看不出是否混入了私钥段。用 head -c 3 检查是否输出 efbbbf,用 grep -c 统计 BEGIN CERTIFICATE 段数,只有 openssl x509 -in 文件名 -noout 能成功解析,才算真正完整。

可以。Nginx 1.11.0 及以上支持在同一个 server 块中重复写 ssl_certificate 与 ssl_certificate_key 对,服务端会根据客户端 ClientHello 的签名算法扩展自动选择。老客户端回落 RSA,新客户端走 ECDSA,握手更快且兼容性不受影响。

这类客户端会把 .pem 当文本预览并重新编码,可能插入 BOM、把 LF 改成 CRLF、追加空行甚至改扩展名,导致首行不再是 BEGIN CERTIFICATE。应使用 scp、sftp 或 rsync 传输,并在两端用 sha256sum 比对哈希,确认文件无损。

不会。过期报的是 NET::ERR_CERT_DATE_INVALID,两者错误码不同。但续期时如果只替换了证书没替换私钥,或手工粘贴出错,就可能从过期问题演变成格式无效问题,所以续期后务必做一次公私钥哈希比对。

不需要停机重启。执行 nginx -t 校验语法后,用 nginx -s reload 即可,master 进程会重新加载证书并平滑切换 worker。但 reload 前必须确认新证书和私钥都已就位且匹配,否则 worker 起不来,会保留旧配置继续服务。