You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

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

火山引擎 最新活动