curl: (60) SSL certificate problem: unable to get local issuer certificate
一、错误含义:curl 60 到底在说什么
curl: (60) SSL certificate problem: unable to get local issuer certificate 的含义非常明确:客户端已经拿到了服务器证书,但在本地信任库中找不到签发它的根证书(issuer),因此无法构建出完整的证书链。关键词是 local issuer——问题几乎总是出在客户端信任库,或者出在服务端没有下发中间证书,而不是私钥错误或域名不匹配。
最常见的四类触发场景:
- 精简版 Linux 镜像(slim / alpine / distroless)没有安装
ca-certificates,/etc/ssl/certs是空的; - PHP、Java、Python 各自维护独立信任库,与系统 CA 不同步;
- 服务端只下发了叶子证书,漏发中间证书,导致链不完整;
- 企业内网自签名 CA 或 TLS 解密代理的根证书没有导入客户端。
先分清几个长得像、但根因完全不同的报错:
| 报错信息 | 真实含义 | 首要排查方向 |
|---|---|---|
unable to get local issuer certificate(verify error:num=20) |
本地找不到签发者证书 | 客户端 CA 库缺失,或服务端缺中间证书 |
unable to verify the first certificate(num=21) |
链里只有叶子证书 | 服务端未配置 fullchain |
self signed certificate in certificate chain(num=19) |
链中出现自签名根 | 把企业根 CA 导入客户端 |
certificate has expired(num=10) |
证书已过期 | 续签,与信任库无关 |
curl: (77) error setting certificate verify locations |
CA 文件路径不存在 | 修正 openssl.cafile / curl.cainfo 路径 |
二、三步定位:客户端信任库问题,还是服务端证书链问题
第 1 步:检查服务端下发的证书链。
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
看输出中 Certificate chain 下面的条目:如果只有 0 s: 一张证书,说明服务端只发了叶子证书,链不完整;正常应该出现 2~3 张(叶子 + 中间证书,根证书通常不下发)。再看验证结果:
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1 | grep -E "Verify return code|verify error"
Verify return code: 0 (ok) 表示链完整可验证;出现 verify error:num=20 或 num=21 就是服务端问题,跳到第五节。
第 2 步:检查客户端 CA 文件是否存在。
ls -l /etc/ssl/certs/ca-certificates.crt /etc/pki/tls/certs/ca-bundle.crt
curl -V
curl -V 输出的第一行会写明编译时使用的 CA 路径与 ca-certificates 版本,很多“装了包还是报错”的案例就是 curl 走的是另一份 CA 文件。
第 3 步:交叉验证。
curl -vI https://example.com 2>&1 | grep -E "CAfile|subject:|issuer:|SSL certificate"
curl --cacert /etc/ssl/certs/ca-certificates.crt -I https://example.com
如果加了 --cacert 就成功、不加就失败,说明证书本身没问题,是默认信任库路径或内容不对;如果两者都失败,且 openssl 显示链里只有一张证书,则是服务端缺中间证书。
三、Linux 修复:安装并刷新 CA 根证书库
Debian / Ubuntu
sudo apt-get update
sudo apt-get install -y ca-certificates
sudo update-ca-certificates --fresh
RHEL / CentOS / Rocky / AlmaLinux / Fedora
sudo dnf install -y ca-certificates # CentOS 7 使用 yum install -y ca-certificates
sudo update-ca-trust force-enable
sudo update-ca-trust extract
Alpine(容器里最常踩的坑)
apk add --no-cache ca-certificates
update-ca-certificates
Dockerfile 最佳实践(不要省略这一步,slim 镜像默认没有 CA)
RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates
&& rm -rf /var/lib/apt/lists/*
导入内网自建根 CA:Debian 系放到 /usr/local/share/ca-certificates/corp-root.crt(必须是 .crt 后缀),然后 update-ca-certificates;RHEL 系放到 /etc/pki/ca-trust/source/anchors/corp-root.pem,然后 update-ca-trust extract。
最后验证:curl -I https://example.com 返回 HTTP/2 200 即修复完成。
四、各语言运行时修复:PHP / Python / Node.js / Java / Go
PHP(系统 CA 装了但 PHP 仍报错,是因为 php.ini 里的 cafile 指向了空路径)
php --ini
php -i | grep -E "Loaded Configuration|openssl.cafile|curl.cainfo"
curl -fsSL https://curl.se/ca/cacert.pem -o /etc/ssl/certs/cacert.pem
# php.ini 中写入绝对路径
openssl.cafile=/etc/ssl/certs/cacert.pem
curl.cainfo=/etc/ssl/certs/cacert.pem
重启 php-fpm / Apache 后,php -i | grep cafile 必须显示真实路径。Composer 场景可执行 composer config --global cafile /etc/ssl/certs/cacert.pem。
Python
python3 -c "import ssl; print(ssl.get_default_verify_paths())"
python3 -c "import certifi; print(certifi.where())"
export SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt
export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt
macOS 上用 python.org 安装包的用户几乎必踩此坑,直接双击运行 /Applications/Python 3.x/Install Certificates.command 即可。
Node.js
export NODE_EXTRA_CA_CERTS=/usr/local/share/ca-certificates/corp-root.crt
node -e "require('https').get('https://example.com', r => console.log(r.statusCode))"
Java / JVM(JVM 不读系统 CA,必须用 keytool 导入)
keytool -importcert -noprompt -trustcacerts -alias corp-root
-file corp-root.crt
-keystore $JAVA_HOME/lib/security/cacerts -storepass changeit
keytool -list -keystore $JAVA_HOME/lib/security/cacerts | grep corp-root
Go:读取 SSL_CERT_FILE / SSL_CERT_DIR 环境变量;使用 scratch 或 distroless 基础镜像时,需要显式 COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/。
五、服务端修复:补全证书链(缺中间证书)
当 openssl 输出 verify error:num=21 unable to verify the first certificate,说明 Nginx / Apache 只配置了域名证书,没有拼接中间证书。正确做法是生成 fullchain:
cat your_domain.crt intermediate.crt > fullchain.pem
# Nginx
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/private.key;
nginx -t && systemctl reload nginx
注意两点:顺序必须是叶子证书在前、中间证书在后;根证书不要下发(部分客户端会因此报 self signed certificate in certificate chain)。校验命令:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | grep -E "^ *[0-9]+ s:"
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1 | grep "Verify return code"
六、方案对比:临时绕过还是根治
| 方案 | 命令 / 配置 | 适用场景 | 风险与备注 |
|---|---|---|---|
| 安装系统 CA 包 | apt install ca-certificates + update-ca-certificates |
Linux 主机、容器镜像 | 无,首选方案 |
| 显式指定 CA 文件 | curl --cacert /path/ca.pem |
单次调试、脚本内固定 | 路径需随部署维护 |
| 环境变量注入 | SSL_CERT_FILE / CURL_CA_BUNDLE / REQUESTS_CA_BUNDLE |
CI、容器、Serverless | 仅对识别该变量的程序生效 |
| 导入企业根 CA | update-ca-trust extract / keytool -importcert |
内网自签、TLS 解密代理 | 需管控私钥与证书分发 |
| 补全服务端证书链 | cat leaf.crt intermediate.crt > fullchain.pem |
所有对外 HTTPS 服务 | 无,服务端首选方案 |
| 跳过验证 | curl -k / --insecure |
仅限本地临时排查 | 高,等同放弃中间人防护,禁止上生产 |
| 代码内关闭校验 | CURLOPT_SSL_VERIFYPEER=false、verify=False、NODE_TLS_REJECT_UNAUTHORIZED=0 |
不推荐任何场景 | 极高,会长期潜伏在生产代码里 |
七、故障排查:真实报错对照
| 真实报错 | 根因 | 修复动作 |
|---|---|---|
curl: (60) SSL certificate problem: unable to get local issuer certificate |
本地 CA 库缺失或过期,或服务端缺中间证书 | 安装 ca-certificates 并 update;用 openssl s_client -showcerts 确认链长度 |
curl: (77) error setting certificate verify locations: CAfile: /etc/ssl/certs/ca-certificates.crt CApath: none |
CA 文件路径不存在(常见于 PHP 里配置了错误路径) | 确认文件真实存在,修正 curl.cainfo / openssl.cafile |
PHP Warning: curl_exec(): SSL certificate problem: unable to get local issuer certificate |
php.ini 未配置 cafile | 下载 cacert.pem 并写入两个 ini 项,重启 php-fpm |
GuzzleHttpExceptionRequestException: cURL error 60: SSL certificate problem: unable to get local issuer certificate |
同上,Guzzle 复用 curl 配置 | 配置 verify => /etc/ssl/certs/cacert.pem,不要设成 false |
ssl.SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1007) |
Python 的 OpenSSL 信任库未初始化 | 设置 SSL_CERT_FILE 或运行 Install Certificates.command |
requests.exceptions.SSLError: HTTPSConnectionPool(host='example.com', port=443): Max retries exceeded with url: / (Caused by SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1007)'))) |
requests 未使用 certifi 或环境变量未生效 | export REQUESTS_CA_BUNDLE=$(python3 -m certifi) |
Error: unable to get local issuer certificate / code: 'UNABLE_TO_GET_ISSUER_CERT_LOCALLY' |
Node 未加载额外根 CA | export NODE_EXTRA_CA_CERTS=/path/corp-root.crt |
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target |
JVM cacerts 中没有该根证书 | 用 keytool 导入到 $JAVA_HOME/lib/security/cacerts |
verify error:num=20:unable to get local issuer certificate(openssl 输出) |
本地 openssl 无对应根证书 | 同第一节,安装或导入根 CA |
verify error:num=21:unable to verify the first certificate(openssl 输出) |
服务端未下发中间证书 | 配置 fullchain.pem 后重载 Nginx/Apache |
排查顺序建议固定为:openssl s_client -showcerts 看链 → curl -vI 看 CAfile → --cacert 做对照实验 → 定位到客户端或服务端,再动手改配置。
八、FAQ
Q1:生产环境能一直用 curl -k 吗?
不能。-k 会关闭证书链校验与主机名校验,等于放弃对中间人攻击的防护。它只适合在本地确认“排除证书问题后接口是否通”这一件事,确认完必须改回正常校验并修复信任库。
Q2:浏览器访问正常,为什么 curl 报 60?
浏览器有内置信任库,并且会在服务端漏发中间证书时通过证书里的 AIA 字段自动下载中间证书补齐链路;curl、PHP、Java 默认不会这样做。所以“浏览器正常”不能证明服务端证书链是完整的。
Q3:已经 apt install ca-certificates 了还是报错?
三种可能:一是容器多阶段构建时只把二进制拷进新镜像,没拷 CA 文件;二是 PHP/Java 使用自己的信任库,不读系统 CA;三是 curl -V 显示的实际 CA 路径与你安装的位置不一致,用 --cacert 指向正确文件即可验证。
Q4:怎么快速判断是缺中间证书还是缺根证书?
看 openssl s_client -showcerts 输出:链里只有一张证书 → 服务端缺中间证书;链里有 2~3 张但本地仍报 num=20 → 客户端缺根证书。前者改服务端,后者改客户端。
Q5:公司网络有 SSL 解密代理,怎么处理?
向安全团队索取代理根 CA,按第三节方式导入系统信任库,同时按第四节分别导入 PHP、Java、Node 的信任库。切勿在代码里关闭校验来“绕过”代理。
Q6:自签名证书能不能直接配到 curl 里?
可以,用 curl --cacert corp-root.crt https://internal.example.com,注意必须是签发该服务器证书的根 CA(或中间 CA),而不是服务器自己的叶子证书。
Q7:更新时间不对会不会报这个错?
不会。系统时间错误通常报 certificate is not yet valid 或 certificate has expired,而不是 unable to get local issuer certificate。两者要分开排查。
Q8:更新 CA 库会不会影响现有服务?
update-ca-certificates 只增补信任锚,不会删除应用自带的证书;风险主要来自新增了不该信任的根证书。导入自签根前请确认来源可信,并做好变更记录。