Python SDK 连接 OpenAI 报错 SSL 证书验证失败如何处理

Python SDK 调用 OpenAI 接口出现 SSL 证书验证失败，最推荐的处理方向是更新本地 CA 证书包或检查网络代理配置，适用场景为本地开发环境或企业内网出口，最重要的风险边界是生产环境严禁关闭证书验证。

先说结论：该报错通常由本地 CA 证书过期或网络中间人拦截导致，优先升级 certifi 包，其次检查系统时间和代理设置。

先确认：检查本地 Python 环境中的 certifi 版本及系统时间是否准确
先处理：执行 pip 命令升级证书包，或配置正确的 HTTP 代理环境变量
再验证：运行最小化 SDK 调用脚本，确认 SSL 握手成功且无报错

命令速用版

在终端执行以下命令更新证书包，适用于大多数 Linux、macOS 和 Windows 环境：

pip install `--upgrade` certifi
python -m pip install `--upgrade` pip

若处于企业代理网络，需先 export 环境变量：

export HTTP_PROXY=http://proxy-user:proxy-pass@proxy-server:port
export HTTPS_PROXY=http://proxy-user:proxy-pass@proxy-server:port

为什么会这样

SSL 证书验证失败的核心原因是客户端无法信任服务器提供的证书链。

Python SDK 底层依赖 httpx 或 requests 库，这些库使用 certifi 包提供的 CA 证书 bundle 进行验证。如果本地 certifi 版本过旧，缺少新颁发的根证书，或者网络出口存在防火墙进行 HTTPS 解密（中间人攻击），都会导致哈希值不匹配。此外，系统时间偏差超过证书有效期范围也会直接触发验证错误。

分步处理

步骤 1：更新证书包

在虚拟环境中激活后，执行升级命令。操作动作是强制重装 certifi，验证结果是 pip 显示 Successfully installed。

pip install `--upgrade` `--force-reinstall` certifi

步骤 2：检查系统时间

确认操作系统时间与网络时间同步。操作动作是查看 date 命令输出，风险边界是时间偏差不能超过证书有效期。

步骤 3：配置代理环境变量

如果在公司内网，需要配置代理。操作动作是设置 HTTP_PROXY 和 HTTPS_PROXY，注意代理服务器必须支持 SSL 透传。

步骤 4：代码层临时绕过（仅限调试）

在初始化 OpenAI 客户端时传入 verify=False。操作动作是修改 client 初始化参数，风险边界是生产环境严禁使用，会导致中间人攻击风险。

import httpx
from openai import OpenAI
client = OpenAI(http_client=httpx.Client(verify=False))

怎么验证是否生效

创建一个 test.py 文件，调用最简单的接口如 models.list()。

from openai import OpenAI
client = OpenAI()
try:
    models = client.models.list()
    print("SSL 验证通过，连接成功")
except Exception as e:
    print(f"报错：{e}")

检查点：控制台输出“连接成功”且无 SSLError 异常。日志位置为当前终端标准输出。

常见坑

生产环境关闭验证：代码中写死 verify=False 上线，会导致敏感数据泄露风险。
多 Python 版本冲突：系统自带 Python 与虚拟环境 Python 的 certifi 路径不一致，需确认 pip 对应的是哪个 python。
代理认证失败：配置了代理但未提供用户名密码，导致连接被代理服务器拒绝，报错可能混淆为 SSL 错误。

常见问题

可以直接在代码里关闭 SSL 验证吗？

仅限本地调试场景，生产环境禁止关闭。

关闭验证会移除中间人攻击防护，敏感 API Key 和数据可能被窃取。调试完成后必须恢复默认验证机制。

企业内网必须配置代理吗？

取决于网络策略，若直连外域被拦截则必须配置。

部分企业防火墙会拦截非白名单 HTTPS 请求，此时需联系网络管理员获取代理地址，并在环境变量中正确设置。

升级 certifi 后仍然报错怎么办？

检查是否使用了系统级证书存储而非 Python 包。

某些操作系统（如 macOS）优先使用系统钥匙串，需确保证书已导入系统信任列表，或强制 Python 使用 certifi 提供的 bundle。

参考来源

OpenAI Python SDK GitHub 仓库，Issue 讨论区，https://github.com/openai/openai-python
certifi 项目文档，Mozilla CA 包说明，https://github.com/certifi/python-certifi
Python requests 库文档，SSL 证书验证章节，https://docs.python-requests.org/