For the complete documentation index, see llms.txt. This page is also available as Markdown.

SSL 证书错误

如果出现:

SSL certificate verify failed
SSL Error
CERTIFICATE_VERIFY_FAILED

通常表示:

HTTPS 证书校验失败

这是开发者使用代理或请求 HTTPS 网站时的常见问题。


一、常见原因

1. 本地证书环境异常

例如:

  • 系统证书缺失

  • Python CA 证书异常

  • OpenSSL 版本过旧


2. 网络环境问题

部分国内网络环境可能导致:

建议优先使用:

  • 海外 VPS

  • 海外云服务器


3. HTTPS 请求被拦截

可能出现:

  • 防火墙拦截

  • 中间代理干扰

  • SSL 握手失败


4. 目标网站证书异常

部分网站:

可能导致验证失败。


二、常见报错示例

cURL


Python requests


三、推荐排查方式

1. 先测试代理是否正常


2. 临时关闭 SSL 验证(仅测试)

cURL


Python


⚠️ 注意

生产环境不建议长期关闭 SSL 验证。


四、推荐解决方案

推荐:

  • 更新系统证书

  • 更新 OpenSSL

  • 使用海外 VPS

  • 更换 DNS

避免:

  • 老旧 Python 环境

  • 国内网络直接高频请求海外 HTTPS 网站


五、推荐排查流程


六、相关文章

最后更新于

这有帮助吗?