很多初次接触 AI API 的新手开发者，在运行代码时经常会遇到这样的报错：

SSL certificate problem: unable to get local issuer certificate

或者：

requests.exceptions.SSLError: certificate verify failed

别慌！本文将用最通俗的语言，手把手教你彻底解决这个烦人的证书问题。

一、什么是 SSL 证书错误？

想象一下，你给朋友寄信需要一个信封，SSL 证书就像是互联网世界的"信封封条"。当你的电脑要和 AI API 服务器（比如 HolySheep AI）通信时，需要验证这个"封条"是否真实有效。

证书错误就像是你收到了一封信，但信封上的封条破损了或者根本不是官方的——这时候系统会出于安全考虑拒绝接受这封信。

二、为什么会出现证书错误？

常见原因有以下几种：

三、Windows 系统修复方法

方法1：安装根证书包（推荐）

步骤1： 下载 cacert.pem 证书文件
（下载地址：点击下载证书文件）

步骤2： 将文件保存到 C:\cacert.pem（或其他你记得的路径）

步骤3： 设置环境变量
按 Win + R → 输入 sysdm.cpl → 高级选项卡 → 环境变量 → 新建系统变量：

步骤4： 重启电脑后生效

方法2：安装 Mozilla 根证书（更全面）

下载 cacert.pem 后，Python 用户还需要在代码中指定证书路径（后面会详细说明）。

四、Mac 系统修复方法

步骤1： 安装 Homebrew（如果还没安装）
打开终端，输入：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

步骤2： 安装 ca-certificates

brew install ca-certificates

步骤3： 更新系统证书

sudo security add-trusted-certificates -d -r trustRoot /usr/local/share/ca-certificates/cacert.pem

步骤4： 如果使用 Python，配置环境变量

export SSL_CERT_FILE=/usr/local/share/ca-certificates/cacert.pem
export REQUESTS_CA_BUNDLE=/usr/local/share/ca-certificates/cacert.pem

五、Linux 系统修复方法

Ubuntu/Debian 系统

sudo apt update
sudo apt install -y ca-certificates
sudo update-ca-certificates

CentOS/RHEL 系统

sudo yum install -y ca-certificates
sudo update-ca-trust force-enable
sudo update-ca-trust extract

验证证书是否安装成功

curl -I https://api.holysheep.ai/v1/models

如果返回 HTTP/2 200，说明证书问题已解决！

六、Python 代码中的解决方案

当你使用 Python 调用 AI API 时，最简单的方法是手动指定证书路径：

import requests


方法1：指定 cert 文件路径

response = requests.get(
    "https://api.holysheep.ai/v1/models",
    headers={
        "Authorization": "Bearer YOUR_HOLYSHEEP_API_KEY"
    },
    verify="C:/cacert.pem"  # 这里改成你的证书路径
)

print(response.json())

如果你不想每次都指定证书，可以设置全局环境：

import os
import requests


方法2：设置环境变量（一劳永逸）

os.environ['REQUESTS_CA_BUNDLE'] = 'C:/cacert.pem'


之后就不需要每次指定 verify 参数了

response = requests.get(
    "https://api.holysheep.ai/v1/models",
    headers={
        "Authorization": "Bearer YOUR_HOLYSHEEP_API_KEY"
    }
)

print(response.json())

七、Node.js 代码中的解决方案

使用 node-fetch 或 axios 时，Node.js 通常会使用系统证书。如果遇到问题，可以尝试：

// 方法1：使用 axios 并忽略 SSL 验证（仅用于测试环境！）
const axios = require('axios');

// 强烈不推荐在生产环境使用
process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = '0';

const response = await axios.get('https://api.holysheep.ai/v1/models', {
    headers: {
        'Authorization': 'Bearer YOUR_HOLYSHEEP_API_KEY'
    }
});

console.log(response.data);

推荐方式：安装 certifi 包来管理证书：

npm install certifi
const https = require('https');
const certifi = require('certifi');

const agent = new https.Agent({
    ca: certifi
});

axios.get('https://api.holysheep.ai/v1/models', {
    headers: {
        'Authorization': 'Bearer YOUR_HOLYSHEEP_API_KEY'
    },
    httpsAgent: agent
}).then(response => {
    console.log(response.data);
}).catch(error => {
    console.error('请求失败:', error.message);
});

八、使用代理时的证书问题

很多开发者使用 Clash、V2Ray 等代理工具时会出现证书错误。解决方法：

九、常见报错排查

问题1：仍然报 "certificate verify failed"

可能原因：证书路径错误或文件损坏

解决方法：

问题2：报 "SSL certificate problem: self signed certificate"

可能原因：服务器使用自签名证书（常见于内网环境）

解决方法：

问题3：Mac 上证书安装了但还是报错

可能原因：Python/Node.js 没有使用系统证书

解决方法：

问题4：Windows 下环境变量不生效

可能原因：没有以管理员权限设置环境变量

解决方法：

十、一劳永逸的方案：使用 HolySheep AI

其实，证书问题很大程度上是因为使用了需要特殊网络环境的 API 服务。

HolySheheep AI 作为国内直连的 AI API 服务商，拥有以下天然优势：

总结

SSL 证书错误虽然看起来吓人，但解决思路很清晰：

  1. 下载根证书文件 cacert.pem
  2. 根据你的操作系统安装证书或设置环境变量
  3. 在代码中指定证书路径
  4. 或者——直接使用国内直连的 HolySheheep AI，省去一切网络麻烦！

祝你调试顺利，如果还有其他问题，欢迎留言交流！

👉 免费注册 HolySheep AI，获取首月赠额度

相关资源

相关文章