首页
/ GitHub Actions中setup-python项目处理Python 3.5证书验证失败的解决方案

GitHub Actions中setup-python项目处理Python 3.5证书验证失败的解决方案

2025-07-07 05:30:18作者:史锋燃Gardner

问题背景

近期在使用GitHub Actions的setup-python项目安装Python 3.5版本时,许多用户遇到了SSL证书验证失败的问题。这个问题表现为在安装过程中,pip无法验证PyPI服务器的SSL证书,导致安装失败。错误信息通常显示为"SSL: CERTIFICATE_VERIFY_FAILED"。

技术原因分析

这个问题的根本原因在于Python 3.5已经停止维护,其内置的SSL模块无法正确验证PyPI服务器更新后的SSL证书。PyPI服务器近期可能更新了其SSL配置,采用了更现代的加密标准或证书链,而Python 3.5中的SSL实现无法处理这些新变化。

值得注意的是,这个问题不仅影响Python 3.5,同样会影响其他较旧的Python版本,如Python 3.4等。这主要是因为较旧版本的Python使用的OpenSSL库版本较低,无法识别新的证书颁发机构或加密算法。

解决方案

对于必须使用Python 3.5的开发环境,目前有以下几种解决方案:

1. 使用PIP_TRUSTED_HOST环境变量

这是目前最直接的解决方案。通过在GitHub Actions工作流中添加环境变量配置,可以绕过SSL证书验证:

- uses: actions/setup-python@v5
  with:
    python-version: 3.5
  env:
    PIP_TRUSTED_HOST: "pypi.python.org pypi.org files.pythonhosted.org"

这种方法告诉pip信任指定的主机,即使SSL证书验证失败也继续执行。需要注意的是,这会降低安全性,使系统容易受到中间人攻击。

2. 升级到支持的Python版本

从安全角度考虑,最佳解决方案是升级到仍在支持期的Python版本。Python 3.5已于2020年停止官方支持,继续使用会面临多种安全风险。

3. 手动安装证书

对于有特殊需求必须使用Python 3.5的情况,可以考虑手动更新系统的证书存储。这需要:

  1. 获取最新的CA证书包
  2. 配置Python使用这些证书
  3. 可能需要重新编译Python以支持新的SSL特性

这种方法技术难度较高,且不一定能完全解决问题。

安全考虑

使用PIP_TRUSTED_HOST解决方案时,开发者应当意识到这会降低系统的安全性。在生产环境中,特别是处理敏感数据时,应当尽量避免使用这种方案。如果必须使用,建议:

  1. 仅在CI/CD环境中临时使用
  2. 限制信任的主机范围
  3. 考虑增加额外的安全监控措施

长期建议

对于长期项目,建议制定Python版本升级计划。GitHub Actions支持从Python 3.6到最新版本的所有主流Python发行版,升级到较新版本不仅可以避免这类问题,还能获得性能改进和新特性。

对于维护遗留系统的团队,可以考虑使用容器技术将旧版Python环境隔离,而不是直接在CI/CD系统中使用过时的Python版本。这种方法可以在一定程度上平衡兼容性和安全性需求。

登录后查看全文
热门项目推荐

热门内容推荐

最新内容推荐

项目优选

收起
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
137
188
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
885
527
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
368
382
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
183
265
kernelkernel
deepin linux kernel
C
22
5
MateChatMateChat
前端智能化场景解决方案UI库,轻松构建你的AI应用,我们将持续完善更新,欢迎你的使用与建议。 官网地址:https://matechat.gitcode.com
735
105
note-gennote-gen
一款跨平台的 Markdown AI 笔记软件,致力于使用 AI 建立记录和写作的桥梁。
TSX
84
4
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
1.08 K
0
harmony-utilsharmony-utils
harmony-utils 一款功能丰富且极易上手的HarmonyOS工具库,借助众多实用工具类,致力于助力开发者迅速构建鸿蒙应用。其封装的工具涵盖了APP、设备、屏幕、授权、通知、线程间通信、弹框、吐司、生物认证、用户首选项、拍照、相册、扫码、文件、日志,异常捕获、字符、字符串、数字、集合、日期、随机、base64、加密、解密、JSON等一系列的功能和操作,能够满足各种不同的开发需求。
ArkTS
53
1
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
400
376