跳到主要内容

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 只增补信任锚,不会删除应用自带的证书;风险主要来自新增了不该信任的根证书。导入自签根前请确认来源可信,并做好变更记录。