Poetry install执行失败，报错SSLError: GitHub HTTPSConnectionPool超出最大重试次数

我在Python项目中运行poetry install命令时遇到错误，报错信息如下：

HTTPSConnectionPool(host='github.com', port=443): Max retries exceeded with url: ... (Caused by SSLError(FileNotFoundError(2, 'No such file or directory')))

我已经尝试了以下排障步骤，但都没有解决问题：

• 验证了网络连接正常
• 确认安装了最新版本的Poetry
• 确保Git和OpenSSL是最新版本
• 确认仓库URL正确且可以在浏览器中访问

环境详情：

OS: 14.7.1 (23H222)
Python version: 3.11.9
Poetry version: 1.8.5
Git version: 2.45.2

嗨，这个问题我在macOS 14.x系统上帮朋友排查过几次，核心原因就是Poetry在建立SSL连接时找不到系统的CA证书文件，给你几个针对性的解决思路，按顺序试应该能搞定：

1. 手动指定SSL证书路径 #

macOS的系统证书一般存放在/etc/ssl/cert.pem，你可以先临时把这个路径告诉Poetry：

export SSL_CERT_FILE=/etc/ssl/cert.pem

执行完这条命令后，再重新运行poetry install试试。如果有效，你可以把这个环境变量加到你的shell配置文件里（比如~/.zshrc或~/.bash_profile），避免每次都手动设置。

2. 重置Git的SSL配置 #

有时候Git的SSL配置会干扰Poetry的连接，你可以重置Git的SSL相关设置：

git config --global http.sslVerify true
git config --global http.sslCAInfo /etc/ssl/cert.pem

设置完后，先尝试用Git直接克隆你要拉取的GitHub仓库，如果Git能正常克隆，那Poetry大概率也能正常拉取依赖了。

3. 检查系统根证书完整性 #

打开Mac的「钥匙串访问」应用，切换到「系统」钥匙串，查看「证书」分类下是否有常见的根CA证书（比如DigiCert Global Root CA、Let’s Encrypt的根证书）。如果发现缺失，可以通过以下方式修复：

• 运行系统更新，确保macOS的安全补丁是最新的
• 手动导入缺失的根证书（可以从CA官方网站下载后拖入钥匙串访问）

4. 临时切换Poetry的PyPI源（应急方案） #

如果以上方法都暂时无法解决，而你的依赖主要来自PyPI而非GitHub私有仓库，可以临时把Poetry的源换成国内镜像绕开GitHub的SSL问题：

poetry config pypi-url https://mirrors.aliyun.com/pypi/simple/
poetry config repositories.aliyun https://mirrors.aliyun.com/pypi/simple/

之后再运行poetry install，等问题解决后可以再切回默认源：

poetry config --unset pypi-url
poetry config --unset repositories.aliyun

5. 重新安装Poetry并指定证书 #

如果上面的方法都无效，你可以尝试重新安装Poetry，安装时手动指定证书路径：

curl -sSL https://install.python-poetry.org | python3 - --cert /etc/ssl/cert.pem

备注：内容来源于stack exchange，提问作者Nadav