bilibili-api 项目中 SSL 证书验证问题的分析与解决
项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-api 问题背景
在使用 bilibili-api 进行搜索功能调用时，部分开发者遇到了 SSL 证书验证失败的问题。具体表现为调用 search.search 方法时返回 SSLCertVerificationError 错误，提示"certificate verify failed: unable to get local issuer certificate"。
问题分析
SSL/TLS 证书验证是 HTTPS 安全连接的重要组成部分，用于验证服务器身份的真实性。当客户端无法验证服务器提供的证书时，就会抛出此类错误。可能的原因包括：
- 本地系统缺少必要的根证书
- 系统时间不正确导致证书有效期验证失败
- 网络中间设备或中转服务器干扰
- Python 环境中的 SSL 证书配置问题
在 bilibili-api 项目中，默认使用 aiohttp 库作为 HTTP 客户端，而 aiohttp 依赖于系统的 SSL 证书存储。当系统环境配置不当时，就可能出现证书验证问题。
解决方案
方案一：切换 HTTP 客户端
bilibili-api 提供了切换 HTTP 客户端的配置选项，可以将默认的 aiohttp 切换为 httpx：
from bilibili_api import settings
settings.http_client = settings.HTTPClient.HTTPX
httpx 在处理 SSL 证书时采用了不同的机制，往往能绕过一些 aiohttp 会遇到的问题。多位开发者反馈此方法有效解决了他们的证书验证问题。
方案二：调整 aiohttp 配置
如果希望继续使用 aiohttp，可以尝试调整其 SSL 配置：
from aiohttp import TCPConnector
from bilibili_api import set_aiohttp_session
set_aiohttp_session(aiohttp.ClientSession(connector=TCPConnector(ssl=False)))
此方法会禁用 SSL 验证，虽然能解决问题，但会降低安全性，不建议在生产环境中使用。
方案三：更新系统证书
对于 Linux 系统，可以尝试更新证书存储：
sudo apt-get install --reinstall ca-certificates
对于 macOS，可以尝试更新钥匙串中的证书。
其他相关问题
除了搜索功能外，类似的问题也出现在其他 API 调用中，特别是高频调用场景下。例如：
- 使用
get_dynamic_page_info获取最新动态时出现ServerDisconnectedError - 批量调用
get_dynamics_new()方法时出现服务器断开连接错误
这些问题同样可以通过切换 HTTP 客户端到 httpx 来解决，说明 httpx 在处理高频连接和稳定性方面可能优于 aiohttp。
最佳实践建议
- 对于生产环境应用，推荐使用 httpx 作为 HTTP 客户端
- 定期检查系统证书存储是否完整
- 对于高频调用场景，适当增加请求间隔时间
- 实现完善的错误处理和重试机制
总结
SSL 证书验证问题是 Python HTTP 客户端开发中的常见挑战。bilibili-api 提供了灵活的 HTTP 客户端配置选项，开发者可以根据实际环境选择最适合的解决方案。对于大多数情况，切换到 httpx 客户端是最简单有效的解决方法，同时保持良好的性能和稳定性。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
