解决 astrbot插件安装时显示"解析版本信息失败" 的问题或者其他问题

提示

适用于 AstrBot 框架

遇到的问题可能有:

• Cannot connect to host api.github.com:443 ssl:True [SSLCertVerificationError: (1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1000)')]

• Cannot connect to host api.soulter.top:443 ssl:True [SSLCertVerificationError: (1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:997)')]

• Cannot connect to host api.soulter.top:443 ssl:True [SSLCertVerificationError: (1, '[SSL: CERTIFICATE_VERIFY_FAILED]

• Cannot connect to host github.com:443 ssl:True [SSLCertVerificationError: (1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1020)')]

1. 更新或安装根证书

• macOS 系统：
  如果你用的是 macOS，Python 通常会附带一个 Install Certificates.command 脚本。你可以在终端里运行它，确保系统信任最新的根证书。
• Windows 系统：
  Windows 下你可能需要手动更新根证书或者重新安装 Python，确保安装过程中包含最新的证书链。另外，也可以通过系统更新来确保根证书库是最新的。

2. 使用 certifi 库确保使用最新的 CA 列表

• 目前已经在代码里导入了 certifi 并创建了 SSL 上下文：

  ssl_context = ssl.create_default_context(cafile=certifi.where())

  这一步通常没问题，但你可以再确认下程序启动前，环境变量 SSL_CERT_FILE 是否正确设置为 certifi.where() 的返回路径。可以在运行程序前设置这个环境变量，例如：

  export SSL_CERT_FILE=$(python -c "import certifi; print(certifi.where())")

  或在 Windows 下设置环境变量，然后再启动程序。

3. 检查代理设置

• 如果你在使用代理，确认代理配置是否正确。有些代理会拦截 HTTPS 流量并替换证书，导致验证失败。可以尝试：
  • 暂时禁用代理，看看是否问题依然存在。
  • 或在 aiohttp 的 ClientSession 中禁用 trust_env（将其设置为 False），避免读取系统代理设置。

4. 临时禁用 SSL 验证（不推荐长期使用）

• 如果以上办法都试过了，还想暂时绕过这个问题，可以在创建 aiohttp 的 TCPConnector 时直接关闭 SSL 验证：

  connector = aiohttp.TCPConnector(ssl=False)

  但请记住，这样做会降低安全性，因为你将不会验证服务器的身份，容易受到中间人攻击，只能作为临时调试方案。

5. 验证代码环境

• 确保你安装了最新版本的 aiohttp、certifi 和 Python，因为有时候版本问题也会导致证书验证异常。可以尝试更新这些包：

  pip install --upgrade aiohttp certifi

或者其他解决方法

• 记录: ca 证书未成功加载的问题及其解决办法

你也可以自行在网络上搜索相关解决方法。