MacOS下PyCharm运行Discord bot报SSL证书验证失败如何解决

根因说明 #

MacOS平台下官方安装的Python3.8默认不会读取系统根证书库，且你之前用--user参数安装的certifi仅对当前用户全局生效，PyCharm项目如果使用独立虚拟环境、或者解释器权限配置异常，就无法读取到正确的证书文件，触发SSL验证失败报错。

分步操作 #

• 第一步：确认PyCharm项目的Python解释器路径
  打开PyCharm偏好设置 → 项目:<你的项目名称> → Python解释器，点击解释器右侧齿轮图标选择「显示所有」，复制当前在用的Python3.8解释器完整路径。
• 第二步：临时验证修复效果
  在你的Discord机器人代码入口最顶部添加以下代码，运行测试是否还会触发SSL报错：

  import ssl
  import certifi
  # 强制指定certifi提供的根证书库
  ssl._create_default_https_context = lambda: ssl.create_default_context(cafile=certifi.where())
  

  若添加后运行正常，说明确实是证书加载路径问题，继续执行后续步骤做永久修复。
• 第三步：全局修复Python3.8证书配置
  打开系统终端，执行以下命令获取管理员权限运行证书安装脚本，避免之前的权限报错：

  sudo /Applications/Python\ 3.8/Install\ Certificates.command
  

  输入你的Mac开机密码后等待执行完成即可。
• 第四步：同步PyCharm解释器的certifi配置
  打开PyCharm内置终端，执行以下命令升级当前解释器环境下的certifi库：

  # 把<你第一步复制的解释器路径>替换成实际路径，比如 /Users/xxx/PycharmProjects/xxx/venv/bin/python
  <你第一步复制的解释器路径> -m pip install --upgrade --force-reinstall certifi
  

  执行完成后运行以下命令确认证书路径加载正常：

  python -c "import certifi; print(certifi.where())"
  

特殊情况处理 #

如果以上操作完成后仍然报错，检查是否开启了代理/抓包工具：这类工具会拦截SSL请求替换证书，Python默认不识别这类自定义证书，你可以把代理工具的根证书内容复制，追加到上面命令输出的cacert.pem文件末尾即可。

内容的提问来源于stack exchange，提问作者Emerson Meadows