Windows系统下安装Poetry遭遇SSL证书验证失败问题求助
Windows系统下安装Poetry遭遇SSL证书验证失败问题求助
问题详情
我在Win10系统上使用Python 3.10安装Poetry时失败了,执行的安装命令是:
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -
运行后出现了SSL证书验证错误,核心报错信息如下:
ssl.SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:997)
之前看到有建议说运行Install Certificates.command来解决这个问题,但我在Python安装目录和电脑其他地方都找不到这个文件,想请教有没有其他可行的解决办法?
针对Windows系统的解决办法
1. 手动导入网站根证书(推荐)
这是最安全的修复方式,步骤如下:
- 打开浏览器访问
https://install.python-poetry.org,点击地址栏左侧的锁图标,选择「证书」→「详细信息」→「复制到文件」,导出为**Base64编码的X.509(.CER)**格式证书 - 按下
Win+R输入certmgr.msc打开证书管理器,展开「受信任的根证书颁发机构」→「证书」,右键选择「所有任务」→「导入」,将刚才导出的证书导入 - 重启终端后重新执行Poetry安装命令
2. 临时跳过SSL验证(仅临时使用)
如果需要快速完成安装,可以临时关闭Python的SSL验证:
# 设置环境变量跳过SSL验证 $env:PYTHONHTTPSVERIFY = "0" # 执行Poetry安装命令 (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py - # 安装完成后记得删除该环境变量,恢复安全设置 Remove-Item Env:\PYTHONHTTPSVERIFY
⚠️ 注意:这种方法会降低网络请求的安全性,仅作为临时 workaround,安装完成后务必移除环境变量。
3. 更新Python的CA证书库
Windows版Python默认的CA证书可能不全,手动更新步骤:
- 获取最新的CA证书集合文件(
cacert.pem) - 找到Python安装目录下的
Lib\site-packages\certifi文件夹,替换其中的cacert.pem文件 - 重启终端后再次尝试安装Poetry
4. 使用离线安装包
如果上述方法都无法解决,可以直接使用离线安装程序:
- 下载Poetry官方提供的Windows版离线安装包(
.exe格式) - 双击运行安装包,按照向导完成安装,这种方式不需要网络请求验证证书
备注:内容来源于stack exchange,提问作者masterofpuppets




