跳到主要内容
错误排查

Laravel HTTPS 证书报错怎么解决?cURL error 60 与反向代理排查指南

laravel https 证书报错 — Laravel HTTPS 证书报错怎么解决?cURL error 60 与反向代理排查指南
核心结论

Laravel 里的 HTTPS 证书报错多数不是证书本身失效,而是 PHP 的 cURL 找不到可信 CA 包(curl.cainfo 未配)或反向代理没有透传 X-Forwarded-Proto;把 php.ini 的 curl.cainfo 指向最新 cacert.pem,并在 bootstrap/app.php 里 trustProxies(at: '*') 即可解决大部分 cURL error 60 与 http 链接问题。 定位第一步永远是看 cURL 错误编号:60=CA 不受信、51=对端证书校验失败、77=CA 路径读不到、35=TLS 握手失败,编号不同处理路径完全不同。 Guzzle 7.x 默认 verify=true,Laravel 10/11 可用 Http::globalOptions(['verify' => '/etc/ssl/certs/cacert.pem']) 在 AppServiceProvider 全局覆盖,禁止把 verify=false 硬编码进主分支。 服务端证书链必须用 fullchain.pem 而不是 cert.pem,Let's Encrypt 证书在 /etc/letsencrypt/live/域名/ 下,90 天有效期,剩余 30 天由 certbot 自动续期,可用 certbot renew --dry-run 预演。 验证三件套:openssl s_client -connect 域名:443 -servername 域名 -CAfile /etc/ssl/certs/cacert.pem 输出 Verify return code: 0 (ok)、curl --cacert 指定包返回 200、tinker 里 Http::get('https://api.example.com')->status() 返回 200。

Laravel 项目里 HTTPS 证书报错到底是什么原因造成的?

先问一个关键问题:是 Laravel 去调别人的 HTTPS,还是别人来访问 Laravel?

这两件事的根因完全不同,排查顺序也不能混。据 OpenSSL 官方文档,TLS 握手失败在客户端侧表现为“证书校验不通过”,在服务端侧表现为“应用生成的 URL 协议错了”,后者根本不会产生任何证书错误。

角色 典型触发点 真实报错 / 现象 根因归属
Laravel 作为客户端 Http facade、Guzzle 7.x、Composer、SMTP cURL error 60: SSL certificate problem: unable to get local issuer certificate 本机 CA 信任库缺失
Laravel 作为服务端 route()、asset() 生成 http:// 浏览器 Mixed Content 拦截、登录态丢失 反向代理未传 X-Forwarded-Proto

为什么 Windows 上的 PHP 一装好就报 cURL error 60?

因为 PHP 官方 Windows 包(8.2.x / 8.3.x)的 php.ini 里这一行默认是注释掉的:;curl.cainfo=。cURL 扩展没有 CA 根证书包,就无法验证任何公网证书。Debian/Ubuntu 则由 ca-certificates 包提供 /etc/ssl/certs/ca-certificates.crt;而 php:8.2-fpm-alpine 这类精简镜像常常根本没装。注意 cURL error 77 是另一种含义——路径写错或文件不可读。

# 1) 确认 PHP 实际读取的 CA 配置(无输出=未配置,就是 error 60 的直接原因)
php -i | grep -i "curl.cainfo|openssl.cafile"

# 2) 下载并固定到项目外路径(Mozilla 维护的 CA 包,curl 官方推荐来源)
mkdir -p /usr/local/share/ca && cd /usr/local/share/ca
curl -fsSLO https://curl.se/ca/cacert.pem && chmod 644 cacert.pem

# 3) 写入 php.ini(Windows 用 D:phpextrassslcacert.pem 这类绝对路径,勿留注释符)
# curl.cainfo = /usr/local/share/ca/cacert.pem
# openssl.cafile = /usr/local/share/ca/cacert.pem

# 4) Alpine 精简镜像的补法
apk add --no-cache ca-certificates && update-ca-certificates

# 5) 复验:能打印出证书链即修复
php -r '$c=curl_init("https://api.github.com"); curl_setopt($c,CURLOPT_RETURNTRANSFER,1); curl_exec($c); echo curl_error($c) ?: "OKn";'

浏览器打得开,Guzzle 却报 unable to verify the first certificate,为什么?

这是证书链不完整。Nginx 只写了 ssl_certificate /path/cert.pem; 而没换成 fullchain.pem。桌面浏览器会通过 AIA 自动下载中间证书补齐,人工访问看着正常;Guzzle 7.x + OpenSSL 3.x 严格校验则直接失败。据 Let’s Encrypt 文档,服务端必须下发“叶子证书 + 中间证书”,只发叶子证书即为配置错误。

# 检查服务端是否下发了完整链:正常应看到 2 张及以上证书
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts /dev/null | grep -c "BEGIN CERTIFICATE"

# Nginx 正确写法(certbot 产出的 fullchain.pem 已含中间证书)
ssl_certificate     /etc/letsencrypt/live/api.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/api.example.com/privkey.pem;

为什么挂了 ALB / SLB 之后,route() 还是生成 http:// 链接?

请求经 AWS ALB、阿里云 SLB 或 Nginx 反代到 PHP-FPM 时,Laravel 读到的是明文连接,$request->isSecure() 返回 false,asset() 与 route() 就生成 http://。同时若 SESSION_SECURE_COOKIE=true,浏览器不会回传 Cookie,登录态直接丢失,现象极像“证书失效”。解法是信任代理并透传协议头:

# Nginx 侧必须透传(缺这一行后面全白搭)
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;

# Laravel 11+:bootstrap/app.php
->withMiddleware(fn ($middleware) => $middleware->trustProxies(at: '*'))

# Laravel 10 及以前:app/Http/Middleware/TrustProxies.php
protected $proxies = '*';
protected $headers = Request::HEADER_X_FORWARDED_FOR | Request::HEADER_X_FORWARDED_PROTO;

域名不匹配和时钟偏差怎么快速定位?

Peer certificate CN=api.example.com did not match expected CN=127.0.0.1 说明你请求的是 IP,而证书 SAN 列表里没有该 IP——按 RFC 6125,校验只认 SAN,不认 CN。certificate has expired 则常是容器时钟漂移超出 notBefore/notAfter 区间:

date -u                      # 与 NTP 源对比,偏差 > 300 秒即需校时
chronyc tracking | grep -i "system time"   # 或 timedatectl status

企业内网自签证书,正确的放行方式是什么?

由自建 CA 签发的内部 API,PHP 默认不信任该根证书。据 Guzzle 文档,正确做法是把企业根 CA 追加进 cacert.pem,或在单次请求上用 verify 指定 CA 路径——而不是把 verify 设为 false,那等于关闭整条链校验并暴露中间人风险。

// Laravel 9/10/11 + Guzzle 7.x:仅对该域名指定企业根 CA
Http::withOptions([
    'verify' => '/etc/ssl/certs/internal-root-ca.pem', // 指向根 CA,切勿写 false
])->get('https://api.internal.example.com/health');

修复 Laravel HTTPS 证书报错的完整实操步骤(分步编号)

动手之前先明确一点:Laravel 本身不校验证书,真正握手的是 PHP 底层的 libcurl/OpenSSL。所以同一个域名用系统 curl 能通、用 Laravel 的 Http::get() 却炸,问题几乎必然落在 PHP 的 CA 配置或反向代理的协议判定上。下面 6 步按”先定位、再修、最后防复发”的顺序推进,每步都给可复制的命令。

  1. 第 1 步:复现并锁定报错类型。先让 Laravel 自己把异常吐出来,再看日志里的 cURL 编号——编号决定后面全部动作,不要一上来就盲目换证书。
    # 进入 tinker,直接发一次真实请求,记录抛出的异常类名
    php artisan tinker
    >>> IlluminateSupportFacadesHttp::get('https://api.example.com/health');
    # 典型输出:IlluminateHttpClientConnectionException: cURL error 60: SSL certificate
    # problem: unable to get local issuer certificate (see https://curl.haxx.se/libcurl/c/libcurl-errors.html)
    
    # 同步查看日志里的原始错误行(含 cURL 编号)
    tail -n 50 storage/logs/laravel.log | grep -i "curl error"
  2. 第 2 步:对比系统 curl 与 PHP curl,判断问题在哪一层。
    # 终端侧:若能返回 HTTP/2 200,说明网络与服务端证书都没问题
    curl -vI https://api.example.com
    
    # PHP 侧:看它到底链接了哪个 libcurl 与 OpenSSL(版本决定支持的 TLS 1.3 与根证书逻辑)
    php -r 'print_r(curl_version());'
    # 关注输出中的 version / ssl_version 字段,例如 libcurl 8.5.0 + OpenSSL/3.0.13

    两者结论一致则不在此步停留;系统 curl 通、PHP 不通,就锁定为 PHP 的 CA 配置问题(cURL error 60 正是”无法获取本地颁发者证书”)。

  3. 第 3 步:安装或更新 CA 根证书包。据 curl 官方 CA bundle 文档,cacert.pem 每月随 Mozilla NSS 根证书库重新生成,文件头会写明 as of 日期,长期不更新就会在新证书链上翻车。
    # 通用做法:下载官方聚合根证书(需 root 权限)
    sudo curl -o /etc/ssl/certs/cacert.pem https://curl.se/ca/cacert.pem
    sudo chown root:root /etc/ssl/certs/cacert.pem   # 属主必须是 root
    sudo chmod 644 /etc/ssl/certs/cacert.pem         # 权限 644,避免 77 号报错
    
    # Debian/Ubuntu 亦可走发行版包(与系统 curl 共用同一信任库)
    sudo apt install -y ca-certificates && sudo update-ca-certificates
  4. 第 4 步:写入 php.ini 并重载 FPM。PHP 官方文档明确 curl.cainfo 与 openssl.cafile 默认值为空,空值即交给系统默认路径,而容器镜像里往往没有该路径。
    # 先确认 CLI 与 FPM 是否加载同一个 php.ini(两者常常不同!)
    php --ini
    php-fpm8.2 -i | grep "Loaded Configuration File"
    
    # 在对应的 php.ini 中追加
    curl.cainfo = /etc/ssl/certs/cacert.pem
    openssl.cafile = /etc/ssl/certs/cacert.pem
    
    # 重载 FPM(版本号按实际替换)并验证生效
    sudo systemctl reload php8.2-fpm
    php -i | grep -i cainfo
  5. 第 5 步:应用层兜底,避免换机器或换镜像后复发。把 CA 路径收进配置,用 Laravel 10+ 的 Http::globalOptions() 统一注入。
    // config/services.php
    'ca_bundle' => env('CA_BUNDLE', '/etc/ssl/certs/cacert.pem'),
    
    // app/Providers/AppServiceProvider.php 的 boot() 中
    Http::globalOptions(['verify' => config('services.ca_bundle')]);

    这样即使 php.ini 丢失配置,出站请求仍指向明确的 PEM 文件。

  6. 第 6 步:修复反向代理信任与 URL 生成。cURL error 60 之外,最常见的”HTTPS 报错”其实是 http:// 混合内容或重定向循环——据 Laravel 文档,代理后面的 X-Forwarded-Proto 必须被显式信任才会被采信。
    // Laravel 11:bootstrap/app.php
    ->withMiddleware(function (Middleware $middleware) {
        $middleware->trustProxies(at: '*', headers:
            Request::HEADER_X_FORWARDED_FOR | Request::HEADER_X_FORWARDED_PROTO
            | Request::HEADER_X_FORWARDED_HOST | Request::HEADER_X_FORWARDED_PORT);
    })
    
    // Laravel 10 及以前:app/Http/Middleware/TrustProxies.php
    protected $proxies = '*';
    protected $headers = Request::HEADER_X_FORWARDED_FOR | Request::HEADER_X_FORWARDED_PROTO
        | Request::HEADER_X_FORWARDED_HOST | Request::HEADER_X_FORWARDED_PORT;
    
    // 强制生成 https 链接(AppServiceProvider::boot)
    URL::forceScheme('https');
    
    // 清缓存并重建配置缓存
    php artisan config:clear && php artisan config:cache

第 1 步记下的编号值得单独记一张速查表,后续排查可以少走大半弯路(编号语义见 curl 官方 libcurl-errors 文档):

cURL 编号 含义 典型原因 对应动作
60 CA 证书不受信 本地根证书缺失或过期 第 3、4 步
51 对端证书校验失败 证书链不完整、自签证书 服务端补齐中间证书
77 CA 文件读不到 路径错误或权限不足 检查 chmod 644 / root:root
35 TLS 握手失败 协议版本或加密套件不匹配 核对 OpenSSL 版本

补充一个易被忽略的事实:Let’s Encrypt 自 2024 年起逐步缩短证书有效期并推进短周期签发,客户端根证书与中间证书的更新节奏必须跟上,否则生产环境会在某个看似无关的凌晨突然集体报 cURL error 60。

关键配置与命令示例:php.ini、Nginx、Laravel 10/11 分别怎么写

问:laravel https 证书报错,到底该改 php.ini、Nginx 还是 Laravel?答案是三处各管一段链路:php.ini 管「PHP 进程去哪找 CA 根证书」,Nginx 管「Laravel 是否知道原始请求是 https」,Laravel 中间件管「信任哪些代理传来的 X-Forwarded-* 头」。只改一处往往治不好 cURL error 60。

1)php.ini:让 PHP 认准 CA bundle(PHP 8.1/8.2/8.3 写法一致,两个指令默认值均为空,为空时回退到编译期或系统默认路径):

; /etc/php/8.2/fpm/php.ini —— 两行必须分别落在各自的段落里
[curl]
curl.cainfo = /etc/ssl/certs/cacert.pem

[openssl]
openssl.cafile = /etc/ssl/certs/cacert.pem

改完必须 systemctl reload php8.2-fpm(reload 即可,无需 restart);而 php artisan serve 是独立的 CLI 进程,不读 FPM 的配置,必须 Ctrl+C 后重新启动才会加载新值。验证命令:php -i | grep -E 'curl.cainfo|openssl.cafile'。据 PHP 官方手册,openssl.cafile 同时影响 stream_socket_client 与 Guzzle 的默认 TLS 校验。

2)Nginx 反向代理:把 https 事实告诉后端

location / {
    proxy_pass http://127.0.0.1:9000;
    proxy_set_header Host              $host;
    proxy_set_header X-Real-IP         $remote_addr;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;   # 关键行:TLS 在 Nginx 终止时后端才知道是 https
}

如果是 Nginx 用 fastcgi 直连 PHP-FPM(没有中间应用服务器),则补一行 fastcgi_param HTTPS on;,让 $_SERVER['HTTPS'] 为 on;纯 HTTP 内网链路不要加,否则 Laravel 会生成错误的 https 资源链接。

3)Laravel 11 vs Laravel 10:TrustProxies 写在哪

对比项 Laravel 10 Laravel 11
配置位置 app/Http/Middleware/TrustProxies.php bootstrap/app.php 的 withMiddleware 闭包
默认 $proxies null(不信任任何代理) 未调用 trustProxies() 即等同不信任
默认 headers HEADER_X_FORWARDED_FOR 等四项组合 需显式传入,否则不含 PROTO
// Laravel 11:bootstrap/app.php
use IlluminateHttpRequest;

->withMiddleware(function (Middleware $middleware) {
    $middleware->trustProxies(
        at: ['10.0.0.0/8', '172.16.0.0/12'], // 生产环境写负载均衡器网段,别用 '*'
        headers: Request::HEADER_X_FORWARDED_FOR | Request::HEADER_X_FORWARDED_PROTO,
    );
})
// Laravel 10:app/Http/Middleware/TrustProxies.php
protected $proxies = ['10.0.0.0/8']; // 默认 null;'*' 仅限调试
protected $headers = Request::HEADER_X_FORWARDED_FOR
    | Request::HEADER_X_FORWARDED_HOST
    | Request::HEADER_X_FORWARDED_PORT
    | Request::HEADER_X_FORWARDED_PROTO;

Laravel 11 精简了 app/Http/Middleware 目录,TrustProxies 不再以独立类文件存在,据 Laravel 官方升级指南,旧文件会被框架内置实现取代。

4)只对单次请求放宽校验(多 CA 源并存、对接合作方自签接口时用):

Http::withOptions([
    'verify'          => '/etc/ssl/certs/cacert.pem', // 覆盖全局 CA,仅本次生效
    'timeout'         => 10,   // 总超时,默认 0(不限)
    'connect_timeout' => 5,    // 连接超时,默认 0
])->get('https://api.example.com');

5)Composer 与 CLI 环境变量:让 artisan、composer、curl 行为一致

composer config --global cafile /etc/ssl/certs/cacert.pem  # 写入全局 config.json

export COMPOSER_CAFILE=/etc/ssl/certs/cacert.pem   # Composer 专用
export SSL_CERT_FILE=/etc/ssl/certs/cacert.pem     # OpenSSL 系工具
export CURL_CA_BUNDLE=/etc/ssl/certs/cacert.pem    # libcurl 系工具

容器里把后两个变量写成 Dockerfile 的 ENV 固化,可避免「宿主 php 正常、容器内 artisan 报 cURL error 60」这类环境漂移;cURL 官方文档明确 CURL_CA_BUNDLE 优先于编译期默认路径。改完用 php -r "var_dump(openssl_get_cert_locations());" 确认 default_cert_file 指向的文件确实存在且可读。

方案对比与选型:CA 包、verify 参数与服务端证书怎么选

问:laravel https 证书报错 反复出现时,该换 CA 包、改 verify 参数,还是重签服务端证书?先分清两层:客户端信任源(CA bundle)决定”你信谁”,服务端证书链决定”对方能否被验证”。两者缺一,报错都是 cURL error 60: SSL certificate problem: unable to get local issuer certificate。

方案 适用场景 关键参数 / 命令 维护成本 参考成本
系统 CA 包 ca-certificates Debian/Ubuntu 常规服务器 apt install ca-certificates,路径 /etc/ssl/certs/ca-certificates.crt 低,随系统更新 免费
curl.se 的 cacert.pem Windows、容器、跨发行版统一 curl.cainfo=/etc/ssl/certs/cacert.pem 需每季度更新一次 免费
Guzzle / Http 指定 verify 路径 多环境、只影响单个应用 Http::globalOptions(['verify' => $path]) 低 免费
verify => false 仅限本地一次性调试 禁止进主分支 高(安全风险) 免费

据 curl.se 官方说明,cacert.pem 由 Mozilla 根证书库导出,更新节奏跟随 Mozilla 的根证书变更,因此”每季度同步”只是保守下限,不是固定周期。

服务端证书 适用场景 关键命令 / 参数 维护成本 参考成本
Let’s Encrypt 公网站点 certbot --nginx -d 域名,90 天有效期 自动续期 免费
商业 DV 需要更长有效期或商业支持 单域名,10 分钟签发 中 约 100–500 元/年
商业 OV / EV 政企合规、需组织信息校验 需提交营业执照 高 约 800–3000 元/年

问:这些方案具体怎么落地?先统一服务器与 PHP 的信任源:

# Debian/Ubuntu 20.04–24.04 通用:安装并校验系统 CA 包
sudo apt-get update && sudo apt-get install -y ca-certificates
# 统计证书条数,正常 140 张以上;为 0 说明包损坏或未安装
grep -c 'BEGIN CERTIFICATE' /etc/ssl/certs/ca-certificates.crt

# 查看 PHP 当前生效值:默认均为空,此时回退到 OpenSSL 编译时路径
php -i | grep -E 'curl.cainfo|openssl.cafile'
# 为空且持续报 cURL error 60 时,在 php.ini 显式指向同一份文件
# curl.cainfo = /etc/ssl/certs/ca-certificates.crt
# openssl.cafile = /etc/ssl/certs/ca-certificates.crt
sudo systemctl reload php8.3-fpm   # 版本按实际 php8.1/8.2/8.3 调整
# 容器镜像或 Windows 开发机:统一使用 curl.se 官方 bundle
curl -fsSL https://curl.se/ca/cacert.pem -o /etc/ssl/certs/cacert.pem
# Dockerfile 中建议固定版本号,便于审计(按官网发布页替换日期)
# ADD https://curl.se/ca/cacert-2024-09-24.pem /etc/ssl/certs/cacert.pem

# php.ini 或 conf.d/curl.ini:一份文件同时服务 Composer、artisan、Guzzle
curl.cainfo = /etc/ssl/certs/cacert.pem
openssl.cafile = /etc/ssl/certs/cacert.pem
// app/Providers/AppServiceProvider.php(Laravel 9.x 起提供 Http::globalOptions)
use IlluminateSupportFacadesHttp;

public function boot(): void
{
    // 默认不写任何代码 = 继承 php.ini;仅对接合作方自签 CA 时才覆盖
    $ca = config('services.partner.ca_bundle'); // 从 .env 读取,如 PARTNER_CA_BUNDLE
    if ($ca && is_file($ca)) {
        Http::globalOptions(['verify' => $ca]);
    }
}
# 据 Let's Encrypt 文档,证书有效期 90 天,certbot 的 systemd timer 每日两次检查续期
sudo apt-get install -y certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com --redirect
sudo certbot renew --dry-run     # 演练续期,确认插件与 reload 钩子可用

# 部署后必查:链上证书数应为 2(叶证书 + 中间证书),缺中间证书同样报 cURL error 60
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | grep -c 'BEGIN CERTIFICATE'
  1. 服务器侧优先系统 CA 包:Debian/Ubuntu 用 ca-certificates,容器与 Windows 开发机统一用 curl.se 的 cacert.pem,并把路径写进 php.ini 而不是散落在代码里——Composer、artisan、Guzzle 三条链路共用一份信任源,才能一次性消除大部分 laravel https 证书报错。
  2. 应用层只在确实存在多 CA 源时覆盖(如对接合作方自签接口),默认继承系统配置;覆盖值从 env 读取,测试与生产可不同。据 OpenSSL 文档,cafile 只影响当前进程,这也解释了为什么 CLI 正常、FPM 仍报错。
  3. verify => false 只允许出现在本地 .env 控制的分支,触发时用 Log::warning 打印一次;生产环境一旦被中间人劫持,API Key、支付回调、OAuth token 都会明文暴露。
  4. 服务端优先 Let’s Encrypt + certbot 自动续期,成本为零;只有需要 OV/EV 组织信息展示或 SLA 技术支持时才买商业证书。商业证书同样要求部署 fullchain(叶证书 + 中间证书),付费并不能绕过证书链问题;主机名校验规则可对照 RFC 6125 与 Mozilla 根证书计划的要求。

排查 laravel https 证书报错,第一步不是改代码,而是把报错原文和根因对上号。下面 6 条覆盖了 php-fpm 错误日志、storage/logs/laravel.log 和 Composer 输出里出现频率最高的情形,根因归为三类:CA 信任包缺失、证书链不完整、主机名与 SAN 不匹配。

报错关键字 根因 快速验证
cURL error 60 … unable to get local issuer certificate PHP 侧 CA 包为空或过期 php -i | grep -i cainfo
cURL error 77 … error setting certificate verify locations 路径已配置但文件不存在或不可读 is_readable() 探测
cURL error 51 / did not match expected CN 请求地址不在证书 SAN 列表中 openssl x509 -text
unable to verify the first certificate 服务端只发叶子证书,缺中间证书 openssl s_client -showcerts
stream_socket_enable_crypto(): … error:0A000086 SMTP/Redis/队列连接 TLS 校验失败 查 DSN 与 openssl.cafile
Composer curl error 60 while downloading … Composer 使用独立的 CA 配置 composer diagnose

cURL error 60 怎么修?它只说明 PHP 进程找不到可信根证书。Laravel 的 HTTP 客户端底层是 ext-curl,受 curl.cainfo 与 openssl.cafile 控制,这两个配置项在 PHP 8.1–8.3 的默认值均为空,所以官方 Docker 镜像常常开箱即报错。

# 1. 确认当前是否已配置 CA 包(无输出 = 未配置)
php -i | grep -iE 'curl.cainfo|openssl.cafile'
# 2. 拉取 Mozilla 根证书集(curl 官方维护)并检查权限
sudo curl -fsSL https://curl.se/ca/cacert.pem -o /etc/ssl/certs/cacert.pem
ls -l /etc/ssl/certs/cacert.pem    # 需为 -rw-r--r-- 644,属主 root
# 3. 写入 php.ini
curl.cainfo = /etc/ssl/certs/cacert.pem
openssl.cafile = /etc/ssl/certs/cacert.pem
# 4. 重载并复核
sudo systemctl reload php8.3-fpm && php -i | grep -i cainfo

error 77 为什么更难查?因为配置项已生效、只是路径无效,九成发生在容器里:宿主机有文件,挂载进容器后丢失。必须在 PHP 进程视角判断,不能用宿主机的 ls 代替。

docker compose exec php php -r 'var_dump(is_readable("/etc/ssl/certs/cacert.pem"));'
# bool(false) 说明容器内不存在该文件;改为挂载或镜像内安装 ca-certificates

error 51 与 CN 不匹配怎么办?据 CA/Browser Forum Baseline Requirements 1.2.6(2017 年 3 月生效),主流浏览器已不再用 CN 匹配主机名,只看 SAN 扩展(RFC 5280 §4.2.1.6)。用 IP 或内网域名访问时最易触发。

openssl x509 -in cert.pem -noout -text | grep -A1 'Subject Alternative Name'
# 必须出现 DNS:api.example.com;输出为空说明证书只写了 CN,需要重签

unable to verify the first certificate 属于服务端问题:Let’s Encrypt 文档明确要求 Nginx 的 ssl_certificate 指向 fullchain.pem 而非 cert.pem,否则移动端与 Java/Go 客户端会失败。

openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts < /dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# 返回 1 = 缺中间证书;正常为 2 条及以上
# Nginx 改为全链证书后重载
# ssl_certificate /etc/letsencrypt/live/api.example.com/fullchain.pem;
sudo nginx -t && sudo nginx -s reload

STARTTLS 场景多发生在邮件、Redis TLS 和队列连接上。Laravel 9+ 改用 Symfony Mailer,DSN 支持 verify_peer 参数,但仅限内网自签证书;公网邮箱配成 0 等于放弃中间人防护。另外 OpenSSL 3.x 才输出 error:0A000086 这类十六进制函数码,1.1.1 显示为 error:14090086,据此可判断环境版本。

# .env:仅内网自签 SMTP 使用,公网服务务必删掉 verify_peer=0
MAIL_URL="smtp://user:pass@mail.internal:465?verify_peer=0"

Composer 报 curl error 60 是另一套配置,与 php.ini 无关,需要单独指定 cafile:

composer config --global cafile /etc/ssl/certs/cacert.pem
# 或临时覆盖:export COMPOSER_CAFILE=/etc/ssl/certs/cacert.pem
composer diagnose    # 逐项检查 http/https 连通性,正常应全部 OK

怎么验证配置真的生效了?六步确认法

改完 php.ini 和 .env 就以为万事大吉,是 laravel https 证书报错最典型的复发场景——配置缓存没清、PHP-FPM 没 reload、CLI 与 FPM 加载的不是同一个 ini,任何一环没刷新,cURL error 60 都会原样回来。下面六步按“由外到内”的顺序验证,每一步都有可判定的输出,不要跳步。

第 1 步:验证服务端证书链是否完整。这一步排除“对方服务器少发中间证书”的可能,与本地配置无关:

# -servername 触发 SNI,缺了它会连到默认站点,测了个寂寞
# -CAfile 指定校验锚点;不加则 s_client 只打印链、不做校验
openssl s_client -connect api.example.com:443 -servername api.example.com 
  -CAfile /etc/ssl/certs/cacert.pem < /dev/null | grep 'Verify return code'
# 期望:Verify return code: 0 (ok)
# 20 (unable to get local issuer certificate) → 服务端漏发中间证书
# 10 (certificate has expired)               → 证书已过期

据 OpenSSL 官方文档,s_client 默认只建立连接、不校验证书,必须配合 -CAfile(或 -verify_return_error)输出才有诊断价值。返回 0 说明链完整且 CA 匹配,问题一定在客户端。

第 2 步:验证 curl 侧。把 PHP 摘出去,先确认命令行 curl 能不能通:

# 显式指定 CA,排除系统 CA 的干扰
curl --cacert /etc/ssl/certs/cacert.pem -sS -o /dev/null -w '%{http_code}n' https://api.example.com
# 期望:200
# 再去掉 --cacert 跑一次,仍返回 200 才说明系统 CA 包(ca-certificates)也已就绪
curl -sS -o /dev/null -w '%{http_code}n' https://api.example.com

第 3 步:验证 PHP 到底加载了哪份配置。CLI 与 FPM 的 ini 路径常常不同,php --ini 看到的只是 CLI:

php --ini | grep 'Loaded Configuration File'      # CLI 实际加载的 php.ini
php -i | grep -iE 'curl.cainfo|openssl.cafile'    # 生效值;输出为空 = 未设置,libcurl 回退到编译期内置路径
php -r 'print_r(curl_version()["version"]);'      # libcurl 版本,如 8.5.0
# FPM 侧必须单独查(版本号按实际替换):
php-fpm8.3 -i | grep -iE 'curl.cainfo|openssl.cafile'

三者必须对得上:curl.cainfo 指向的文件要存在、可读、且与第 1、2 步用的是同一份 CA 包。注意 curl.cainfo 的默认值是空(未设置),这意味着 libcurl 使用编译期决定的 CA 路径,在容器里经常指向一个不存在的文件——这正是容器化 Laravel 项目里 cURL error 60 高发的原因。

第 4 步:验证应用层。只有走到这一步才真正覆盖 Laravel 的 HTTP 客户端栈:

php artisan tinker
>>> Http::get('https://api.example.com/health')->status();
=> 200
# 另开一个终端盯日志,确认不再新增记录
tail -f storage/logs/laravel.log | grep -i 'cURL error'

如果 tinker 里通、FPM 里不通,几乎必然是第 3 步的 FPM ini 没生效,需要 systemctl reload php8.3-fpm(reload 而非 restart 才会重读 ini)。

第 5 步:验证 Laravel 自己生成的 URL。反向代理场景下,证书通了但页面里还是 http://,会引发混合内容与重定向循环:

php artisan tinker --execute="echo route('home');"   # 期望输出 https://...
php artisan about                                    # Laravel 9+ 才有;8.x 用 php artisan config:show app.url
# 重点看 APP_URL 与 “Configuration Cached” 状态,缓存为 Yes 时改 .env 不生效
php artisan config:clear

第 6 步:验证续期链路。证书 90 天有效,据 Let’s Encrypt 文档,官方建议在剩余 30 天时续期,所以“今天能通”不代表下个月能通:

certbot renew --dry-run     # 期望:Congratulations, all simulated renewals succeeded
openssl s_client -connect api.example.com:443 -servername api.example.com < /dev/null 
  | openssl x509 -noout -enddate     # 记录 notAfter,据此设置 30 天前告警
步骤 验证对象 通过判据 失败最常见原因
1 服务端证书链 Verify return code: 0 (ok) 漏发中间证书 / 证书过期
2 curl + 系统 CA 两次均返回 200 ca-certificates 包过旧
3 PHP ini / libcurl cainfo 路径存在且 FPM 一致 改的是 CLI 的 ini,FPM 未 reload
4 应用层 Http 客户端 status 200 且日志无新增 配置缓存未清
5 生成的 URL 协议 route() 输出 https:// APP_URL 未改 / TrustProxies 未配
6 续期与到期日 dry-run 成功 + 到期日已记录 80 端口校验被防火墙拦截

六步全部通过后,才算真正把这次 laravel https 证书报错闭环;日常只需保留第 6 步的到期日监控与第 4 步的日志告警作为回归检查。

生产环境上线前的 6 项检查清单

上线前最容易漏掉哪一步?不是 Nginx 的证书路径,而是容器镜像里根本没有 CA 根证书——Laravel 用 Guzzle/cURL 调外部 HTTPS 接口时会直接抛 cURL error 60,而浏览器访问你的站点却完全正常,这也是 laravel https 证书报错最典型的来源。下面 6 项按”容器 → 配置 → 进程 → 续期 → 缓存 → 可观测”的顺序逐条核对。

1. 镜像必须显式安装 CA 根证书。alpine 和 slim 类镜像默认不装 ca-certificates,OpenSSL 找不到信任锚,据 OpenSSL 文档 openssl version -d 输出的 OPENSSLDIR 就是证书查找目录,必须确认里面有文件。基础镜像选型对比如下:

基础镜像 安装命令 默认是否有 CA 校验路径
alpine 3.19 apk add --no-cache ca-certificates 否 /etc/ssl/certs/ca-certificates.crt
debian bookworm apt install -y ca-certificates 否(slim 亦无) /etc/ssl/certs/ca-certificates.crt
php:8.3-fpm(完整版) 已预装 是 同上
# Dockerfile(alpine)
FROM php:8.3-fpm-alpine
RUN apk add --no-cache ca-certificates 
 && update-ca-certificates
# 构建期自检:目录里有证书文件才算通过,否则让构建失败
RUN openssl version -d && test -s /etc/ssl/certs/ca-certificates.crt

2. 配置开关走环境变量,代码里不出现硬编码路径。staging 与 production 行为分叉,八成是某处写死了 /etc/ssl/certs/…。把开关收拢到 .env:CA_BUNDLE 给路径,HTTP_VERIFY 生产必须为 true,本地才允许临时 false;注意 Laravel 的 env() 只在 config/ 目录内可靠,业务代码请用 config() 读取。

# .env(production)
CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt
HTTP_VERIFY=true
// config/services.php —— 默认值 true,禁止在业务代码里 env()
'verify' => env('HTTP_VERIFY', true)
    ? env('CA_BUNDLE', '/etc/ssl/certs/ca-certificates.crt')
    : false,

3. 常驻进程必须重载。用 Octane(Swoole/RoadRunner)时,改完 php.ini 或 CA 文件后不重载,旧 worker 仍持旧配置,表现就是”重启容器前一直报 cURL error 60″:

php artisan octane:reload   # 平滑重载 worker,不清空配置缓存
# 若仍复现:php artisan octane:stop && php artisan octane:start --server=swoole

4. 续期钩子与到期监控。据 Let’s Encrypt 文档,证书有效期 90 天,推荐用 --deploy-hook 在续期成功后重载服务;容器化部署请把证书目录挂载出来,否则重建容器即丢证书。

certbot renew --deploy-hook 'systemctl reload nginx'
# 监控:剩余 30 天告警
openssl x509 -enddate -noout -in /etc/letsencrypt/live/example.com/fullchain.pem

5. 配置缓存纪律。php artisan config:cache 之后 .env 的改动一律不生效,这是把”配置正确”误判成”证书有问题”的常见陷阱。改完 APP_URL 或 CA_BUNDLE 必须:

php artisan config:clear && php artisan config:cache
php artisan config:show services   # 确认 verify/CA_BUNDLE 已生效

6. 日志与告警关键字。把 cURL error 60(CA 不可信)、51(对端证书过期/校验失败)、77(CA 文件读取失败)加入告警规则;storage/logs/laravel.log 用 daily 通道保留 14 天,才能回溯这次 laravel https 证书报错到底是证书到期、CA 更新还是网络抖动。

// config/logging.php
'daily' => ['driver' => 'daily', 'days' => 14, 'path' => storage_path('logs/laravel.log')],

多数情况不是。cURL error 60 表示客户端无法用本地 CA 链验证对端证书,最常见原因是 PHP 没有配置 curl.cainfo。先用 openssl s_client -connect 域名:443 -servername 域名 看服务端证书有效期,再 php -i | grep -i cainfo 看客户端 CA 路径,两边分别确认。

浏览器自带完整根证书库并会自动补齐中间证书,PHP cURL 用的是系统或 php.ini 指定的 CA 包,两者不是同一套信任源。尤其是服务端只部署 cert.pem 缺中间证书时,浏览器能过,Guzzle 7.x + OpenSSL 3.x 会报 unable to verify the first certificate。

能绕过报错,但不建议。verify=false 等于放弃对中间人攻击的防护,生产环境被劫持时 API Key、OAuth token、支付回调数据都可能泄露。只允许在本地一次性调试时通过 .env 开关启用,正确做法是修 CA 路径或补全服务端证书链。

技术上没有区别。报错取决于证书链是否完整、CA 是否被客户端信任、域名是否在 SAN 中,与是否付费无关。Let's Encrypt 有效期 90 天,用 certbot renew –dry-run 验证自动续期;商业 DV 约 100–500 元/年、OV 约 800–3000 元/年,买到的主要是有效期长度、组织信息展示与厂商技术支持。

Laravel 默认不信任代理头,$request->isSecure() 读的是 PHP-FPM 看到的连接,而 FPM 走的是 127.0.0.1:9000 明文。需要配置 trustProxies 并让 Nginx 透传 X-Forwarded-Proto $scheme,或在 AppServiceProvider 里 URL::forceScheme('https'),改完执行 php artisan config:clear 再 config:cache。

建议都配。curl.cainfo 影响 cURL 扩展,Guzzle、Composer 都走 libcurl;openssl.cafile 影响 OpenSSL 扩展,stream_socket_enable_crypto、SMTP STARTTLS、部分 Redis TLS 连接走这条链路。只配一个,邮件通知或队列任务仍可能报 certificate verify failed。

Laravel 11 精简了 app/Http/Middleware 目录,TrustProxies 不再以独立类文件存在,改为在 bootstrap/app.php 里用 $middleware->trustProxies(at: '*', headers: …) 配置。Laravel 10 及以前仍在 AppHttpMiddlewareTrustProxies 类里修改 $proxies 与 $headers 属性。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。