先说结论: 排查 HTTPS 连接失败,第一条命令用 openssl s_client -connect 域名:443 -servername 域名 -verify_hostname 域名 </dev/null,然后只看两处:verify error:num=… 那一行和最后的 Verify return code。10 是证书过期,18 是自签名,19 是链上有不受信任的根,20 和 21 是服务器没发中间证书,62 是证书上的域名对不上。如果连 Verify return code 都没打印就报了 error:0A…,说明握手本身没完成,常见的是 wrong version number(连到了不说 TLS 的端口)、sslv3 alert handshake failure(没带 SNI 或双方没有共同的协议和算法)、legacy sigalg disallowed(对方只支持很老的 TLS 版本)。另外有两个默认行为要记住:s_client 默认不检查域名,也不会因为证书校验失败而中断连接。
下文的输出来自 OpenSSL 3.0.15,Python 的报错来自 Python 3.12(链接 OpenSSL 3.5.9)。测试用的是 badssl.com,这个站专门提供各种「坏掉」的证书,方便复现。
openssl s_client -connect example.com:443 -servername example.com </dev/null几个参数的作用:
-connect 主机:端口:建立 TCP 连接的地址。-servername:TLS 握手里发送的 SNI。OpenSSL 1.1.1 起,s_client 默认会用 -connect 里的主机名作为 SNI;显式写上,是为了用 IP 连接、或者需要指定另一个域名时不出错。</dev/null:给 s_client 一个空的标准输入,握手完成后自动退出,不会停在那里等你输入。正常站点的关键输出:
Certificate chain
0 s:CN = example.com
1 s:C = US, O = SSL Corporation, CN = Cloudflare TLS Issuing ECC CA 3
2 s:C = US, O = SSL Corporation, CN = SSL.com TLS Transit ECC CA R2
3 s:C = US, O = SSL Corporation, CN = SSL.com TLS ECC Root CA 2022
...
Verify return code: 0 (ok)Certificate chain 下面是服务器发来的证书,0 号是站点自己的证书,往下依次是签发它的中间证书。s: 是证书主体,i: 是签发者,每一张的 i: 应该等于下一张的 s:。
把 badssl.com 的几个子域名挨个跑一遍:
for h in expired wrong.host self-signed untrusted-root incomplete-chain; do
echo "=== $h"
openssl s_client -connect $h.badssl.com:443 -servername $h.badssl.com </dev/null 2>&1 \
| grep -E 'verify error|Verify return code'
done=== expired
verify error:num=10:certificate has expired
Verify return code: 10 (certificate has expired)
=== wrong.host
Verify return code: 0 (ok)
=== self-signed
verify error:num=18:self-signed certificate
Verify return code: 18 (self-signed certificate)
=== untrusted-root
verify error:num=19:self-signed certificate in certificate chain
Verify return code: 19 (self-signed certificate in certificate chain)
=== incomplete-chain
verify error:num=20:unable to get local issuer certificate
verify error:num=21:unable to verify the first certificate
Verify return code: 21 (unable to verify the first certificate)逐个说明:
10 证书过期。 看过期时间:
openssl s_client -connect expired.badssl.com:443 -servername expired.badssl.com </dev/null 2>/dev/null \
| openssl x509 -noout -dates输出里的 notAfter=Apr 12 23:59:59 2015 GMT 就是到期时间。如果服务器证书明明没过期却报 10,先检查本机时间:客户端时钟不准,同样会判定证书过期或「尚未生效」(错误码 9)。
wrong.host 显示 0 (ok),这是 s_client 的坑。 证书本身是有效的 *.badssl.com,但 wrong.host.badssl.com 有两级子域名,通配符只匹配一级,浏览器和程序都会拒绝它。s_client 默认只验证证书链,不比对域名,所以报 ok。加上 -verify_hostname 才会检查:
openssl s_client -connect wrong.host.badssl.com:443 -servername wrong.host.badssl.com \
-verify_hostname wrong.host.badssl.com </dev/null 2>&1 | grep -E 'verify error|Verify return code'verify error:num=62:hostname mismatch
Verify return code: 62 (hostname mismatch)所以本文开头那条命令里一定要带 -verify_hostname。macOS 自带的 openssl 其实是 LibreSSL 3.3.6,它不认这个参数,会直接报 unknown option -verify_hostname;在 Mac 上排查,建议另装 OpenSSL 3,或者用后面 Python 的方法。
18 自签名、19 链上的根不受信任。 18 是服务器只发了一张自己签自己的证书;19 是证书链最顶上那张根证书不在本机的信任列表里。19 在企业网络里很常见:出口设备做 TLS 检查时会用自己的根证书重新签发网站证书,没装这个根证书的机器就会报 19。
20、21 证书链不全。 服务器只发了站点证书,没发中间证书,客户端拼不出到根证书的路径。这是最容易出现「浏览器能打开、程序报错」的一种:浏览器可能会自己去下载缺失的中间证书,或者之前访问别的网站时缓存过,而 curl、Python、Java 这类客户端一般不会。修复方法在服务端:Nginx 的 ssl_certificate 要指向包含中间证书的完整链文件(例如 Let's Encrypt 的 fullchain.pem),而不是只有站点证书的 cert.pem。
仔细看过期证书的完整输出:
depth=0 OU = Domain Control Validated, OU = PositiveSSL Wildcard, CN = *.badssl.com
verify error:num=10:certificate has expired
notAfter=Apr 12 23:59:59 2015 GMT
verify return:1verify return:1 表示「虽然有错,继续握手」。这是为了方便调试:就算证书有问题,你也能看到完整的证书链。但如果你用 s_client 写监控脚本、靠退出码判断成败,就会被它骗过去。加 -verify_return_error,校验失败时握手直接中止。
这几种情况连 Verify return code 都到不了,看 error: 那一行。
连到了不说 TLS 的端口:wrong version number。
openssl s_client -connect example.com:80 -servername example.com </dev/nullerror:0A00010B:SSL routines:ssl3_get_record:wrong version number:ssl\record\ssl3_record.c:355:80 端口说的是明文 HTTP,客户端把服务端回来的 HTTP/1.1 400 ... 当成 TLS 记录去解析,版本号字段自然对不上。程序里看到 WRONG_VERSION_NUMBER,第一反应应该是:端口对吗?http:// 和 https:// 写反了吗?中间有没有设备把 TLS 流量转到了明文端口?
没带 SNI:handshake failure,alert 40。
openssl s_client -connect example.com:443 -noservername </dev/nullerror:0A000410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure:ssl\record\rec_layer_s3.c:1605:SSL alert number 40很多 CDN 上同一个 IP 承载成千上万个域名,不带 SNI,服务端不知道该出示哪张证书,就直接拒绝握手。用 IP 直接访问 HTTPS、或者用很老的客户端库时会遇到。alert number 40 本身只表示「握手失败」,SNI 缺失是最常见的原因之一,另一类常见原因是双方没有共同支持的协议版本或加密套件。
对方只支持很老的协议:legacy sigalg disallowed。
openssl s_client -connect tls-v1-0.badssl.com:1010 -servername tls-v1-0.badssl.com </dev/nullerror:0A00014D:SSL routines:tls_process_key_exchange:legacy sigalg disallowed or unsupported:ssl\statem\statem_clnt.c:2255:这个服务端只支持 TLS 1.0,签名用的是 SHA-1。OpenSSL 3 默认的安全等级不接受这种签名。要确认是不是这个原因,可以临时把安全等级调到 0:
openssl s_client -connect tls-v1-0.badssl.com:1010 -servername tls-v1-0.badssl.com \
-cipher 'DEFAULT:@SECLEVEL=0' </dev/null 2>&1 | grep -E 'Protocol :|Cipher :' Protocol : TLSv1
Cipher : ECDHE-RSA-AES256-SHA能连上,就说明问题出在对方的协议太旧。这条命令只用来确认原因,不要把降低安全等级当成长期方案,正确的做法是升级对方的服务端配置。
很多时候你看到的不是 s_client 的输出,而是程序里的异常。下面这段代码对同样的站点各握手一次:
import socket, ssl
import certifi # pip install certifi;在 Linux 上也可以去掉 cafile,直接用系统的根证书
def check(host, port=443):
ctx = ssl.create_default_context(cafile=certifi.where())
try:
with socket.create_connection((host, port), timeout=10) as raw:
with ctx.wrap_socket(raw, server_hostname=host) as s:
print(f"{host}:{port} OK {s.version()}")
except Exception as e:
print(f"{host}:{port} {type(e).__name__}: {e}")
for h in ["expired", "wrong.host", "self-signed", "untrusted-root", "incomplete-chain"]:
check(f"{h}.badssl.com")
check("tls-v1-0.badssl.com", 1010)
check("example.com", 80)输出(为了排版,去掉了每行末尾的 (_ssl.c:1011)):
expired.badssl.com:443 SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: certificate has expired
wrong.host.badssl.com:443 SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: Hostname mismatch, certificate is not valid for 'wrong.host.badssl.com'.
self-signed.badssl.com:443 SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: self-signed certificate
untrusted-root.badssl.com:443 SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: self-signed certificate in certificate chain
incomplete-chain.badssl.com:443 SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate
tls-v1-0.badssl.com:1010 SSLError: [SSL: SSLV3_ALERT_HANDSHAKE_FAILURE] ssl/tls alert handshake failure
example.com:80 SSLError: [SSL: WRONG_VERSION_NUMBER] wrong version number冒号后面那段文字和 s_client 的 verify error 是同一套说法,对照第二节就能定位。Python 默认会检查域名,所以 wrong.host 在这里直接报 Hostname mismatch。TLS 1.0 的站点在这台机器上报的是对方发来的 handshake failure,和 s_client 的提示不同,原因是两边的 OpenSSL 版本和默认配置不一样,结论相同:对方协议太旧。
openssl x509 -checkend 秒数 判断证书在指定秒数内是否到期,用退出码表示结果,很适合放进定时任务:
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null \
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null \
| openssl x509 -noout -checkend 2592000; echo "exit=$?"subject=CN = example.com
issuer=C = US, O = SSL Corporation, CN = Cloudflare TLS Issuing ECC CA 3
notBefore=Sep 26 22:49:11 2026 GMT
notAfter=Dec 25 22:56:35 2026 GMT
X509v3 Subject Alternative Name:
DNS:example.com, DNS:*.example.com
Certificate will not expire
exit=02592000 秒是 30 天,退出码 0 表示 30 天内不会到期,1 表示会。对过期证书跑 -checkend 0,得到的是 Certificate will expire 和退出码 1。-ext subjectAltName 能直接看到证书覆盖了哪些域名,排查 62 号错误时很有用。
现象 | 错误码或关键字 | 先查什么 |
|---|---|---|
证书过期 | 10 certificate has expired | 证书到期时间、本机时钟 |
证书尚未生效 | 9 certificate is not yet valid | 本机时钟 |
域名对不上 | 62 hostname mismatch | 证书的 SAN 列表、通配符层级 |
自签名 | 18 | 是否测试环境证书 |
根证书不受信任 | 19 | 企业 TLS 检查设备、本机信任列表 |
证书链不全 | 20 / 21 | 服务端是否配置了完整链 |
握手前就失败 | wrong version number | 端口、协议是否写对 |
握手被拒 | alert handshake failure、alert 40 | SNI、协议版本、加密套件 |
对方协议太旧 | legacy sigalg disallowed | 对方服务端配置 |
排查顺序可以固定下来:先看握手有没有完成,再看 Verify return code,最后用 x509 看证书的时间和域名。三步走完,绝大多数 TLS 报错都能定位到具体原因。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。