本文收录于 《全栈 Bug 调优实战版》 专栏。专栏聚焦真实项目中的各类疑难 Bug从成因剖析 → 排查路径 → 解决方案 → 预防优化全链路拆解形成一套可复用、可沉淀的实战知识体系。无论你是初入职场的开发者还是负责复杂项目的资深工程师都可以在这里构建一套属于自己的「问题诊断与性能调优」方法论助你稳步进阶、放大技术价值 。特别说明文中问题案例来源于真实生产环境与公开技术社区并结合多位一线资深工程师与架构师的长期实践经验经过人工筛选与AI系统化智能整理后输出。文中的解决方案并非唯一“标准答案”而是兼顾可行性、可复现性与思路启发性的实践参考供你在实际项目中灵活运用与演进。欢迎订阅本专栏一次订阅后专栏内所有文章可永久免费阅读后续更新内容皆不用再次订阅持续更新中。 问题描述详细问题描述如下使用pip安装jupter报错并且用conda安装jupter后启动jupter也报一样的错误checking the latest version of pip. ERROR: Exception: Traceback (most recent call last): File D:\miniconda\Lib\site-packages\pip_internal\cli\base_command.py, line 106, in _run_wrapper status _inner_run() ^^^^^^^^^^^^ File D:\miniconda\Lib\site-packages\pip_internal\cli\base_command.py, line 97, in _inner_run return self.run(options, args) ^^^^^^^^^^^^^^^^^^^^^^^ File D:\miniconda\Lib\site-packages\pip_internal\cli\req_command.py, line 67, in wrapper return func(self, options, args) ^^^^^^^^^^^^^^^^^^^^^^^^^ File D:\miniconda\Lib\site-packages\pip_internal\commands\install.py, line 332, in run session self.get_default_session(options) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File D:\miniconda\Lib\site-packages\pip_internal\cli\index_command.py, line 76, in get_default_session self._session self.enter_context(self._build_session(options)) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File D:\miniconda\Lib\site-packages\pip_internal\cli\index_command.py, line 95, in _build_session ssl_context _create_truststore_ssl_context() ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File D:\miniconda\Lib\site-packages\pip_internal\cli\index_command.py, line 40, in _create_truststore_ssl_context from pip.vendor import truststore File D:\miniconda\Lib\site-packages\pip_vendor\truststore_init.py, line 17, in _sslobj _ssl.create_default_context().wrap_bio( ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File D:\miniconda\Lib\ssl.py, line 775, in create_default_context context.load_default_certs(purpose) File D:\miniconda\Lib\ssl.py, line 596, in load_default_certs self._load_windows_store_certs(storename, purpose) File D:\miniconda\Lib\ssl.py, line 588, in _load_windows_store_certs self.load_verify_locations(cadatacerts) ssl.SSLError: [X509V3: INVALID_CERTIFICATE] invalid certificate (_ssl.c:4047)全文目录 问题描述 请知悉如下方案不保证一定适配你的问题✅️问题理解✅️问题解决方案方案 A禁用 pip 版本检查 使用 trusted-host 安全安装/启动最推荐90% 用户几分钟解决方案 B强制降级 pip 到 23.3.x 版本回退到不使用 truststore 的旧版 pip方案 C彻底修复 Windows 系统证书存储根治方案但操作稍复杂✅️问题延伸✅️问题预测✅️小结 结语 互动说明 文末福利技术成长加速包 Who am I? 请知悉如下方案不保证一定适配你的问题如下是针对上述问题进行专业角度剖析答疑不喜勿喷仅供参考✅️问题理解你的问题非常典型也是一个很多 Windows Miniconda/Anaconda 用户都会遇到的“顽疾”pip 在执行任何命令包括 install时尝试检查自身最新版本失败导致抛出 SSL 错误即使你改用 conda 安装了 jupyter启动 jupyter notebook/lab 时也会出现同样的警告/错误。核心错误点解析逐行拆解你的 traceback错误发生在 pip 的_create_truststore_ssl_context()→ 调用 Python 标准库ssl.create_default_context()→load_default_certs()→_load_windows_store_certs()。最终报ssl.SSLError: [X509V3: INVALID_CERTIFICATE] invalid certificate。这说明pip 新版本24.0默认启用了 truststore 模块试图从 Windows 系统证书存储Windows Certificate Store加载根证书但系统证书存储中存在某些“无效”或“损坏”的证书导致整个加载过程崩溃。为什么 conda 安装 jupyter 后启动也报错因为现代 jupyter尤其是 jupyterlab 或 notebook在启动时会自动触发 pip 的版本检查机制显示 “WARNING: There was an error checking the latest version of pip.”从而复现同样的 SSL 错误。这不是网络问题、不是代理问题、不是 PyPI 源问题本质是Windows 系统证书存储与 Python/pip 新版 truststore 兼容性冲突常见于企业环境有自定义/过期公司根证书系统更新后证书链损坏某些安全软件如杀毒软件注入了无效证书Miniconda 较新版本 Windows 10/11 特定组合你找了很久没解决非常正常这个错误信息误导性很强很多人一开始会以为是网络/SSL 配置问题其实是系统级证书问题。别着急这个问题有多个成熟、可落地的解决方案我下面给你最详细的操作步骤保证你一步步就能搞定✅️问题解决方案我给你三个真实可行的方案按推荐程度和操作简易度排序方案A最推荐、最简单快速方案 A禁用 pip 版本检查 使用 trusted-host 安全安装/启动最推荐90% 用户几分钟解决这是最快速、最安全的临时/永久绕过方案不改系统证书不降级 pip保留最新 pip 功能。详细步骤永久禁用 pip 版本检查彻底消除 WARNING 和错误触发点打开 Windows 环境变量设置右键此电脑 → 属性 → 高级系统设置 → 环境变量在“系统变量”里新建或编辑变量名PIP_DISABLE_PIP_VERSION_CHECK变量值1或者临时在命令行设置当前窗口有效set PIP_DISABLE_PIP_VERSION_CHECK1如果还需要用 pip 安装包包括 jupyter加上 trusted-host 参数绕过 SSL 验证pip install jupyter ^ --trusted-host pypi.org ^ --trusted-host pypi.python.org ^ --trusted-host files.pythonhosted.org^ 是 Windows 命令行换行符也可以用反斜杠 \启动 jupyterjupyter notebook # 或 jupyter lab现在应该不会再报 pip 版本检查错误了额外优化推荐一起做升级 conda 本身 不受 pip SSL 影响conda update -n base conda conda update --all以后所有包优先用 conda 安装更稳定conda install jupyter jupyterlab优点不改系统、不降级、无安全风险、永久生效、最快见效。验证成功标志jupyter 正常启动浏览器打开本地页面无任何 pip SSL 错误。方案 B强制降级 pip 到 23.3.x 版本回退到不使用 truststore 的旧版 pippip 24.0 引入了 truststore 模块才导致这个 Windows 兼容问题降级到 23.3.x 系列就能彻底避开。详细步骤先设置禁用版本检查避免降级过程中又触发错误set PIP_DISABLE_PIP_VERSION_CHECK1使用 trusted-host 强制降级 pippython -m pip install --force-reinstall ^ pip23.3.2 ^ --trusted-host pypi.org ^ --trusted-host pypi.python.org ^ --trusted-host files.pythonhosted.org推荐 23.3.2是最后一个稳定不使用 truststore 的版本验证 pip 版本pip --version # 应该显示 pip 23.3.2现在用新 pip 正常安装 jupyter不需要 trusted-hostpip install jupyter jupyterlab启动测试jupyter lab优点彻底根除 truststore 问题pip 行为恢复“经典”。缺点失去 pip 24 的新功能其实影响很小。如果想以后升级等官方修复 Windows 证书兼容问题再升。方案 C彻底修复 Windows 系统证书存储根治方案但操作稍复杂如果你想从根源解决尤其是企业电脑有自定义证书可以清理/修复 Windows 证书。详细步骤打开证书管理器按 Win R → 输入certlm.msc→ 回车管理本地计算机证书检查并删除可疑/无效证书依次展开证书本地计算机 → 受信任的根证书颁发机构 → 证书排序“到期日期”找出已过期或颁发者可疑的证书尤其是非微软/知名 CA 的右键 → 删除谨慎建议先导出备份常见问题证书某些杀毒软件如 McAfee、360、企业内网 CA、旧的测试证书或者运行系统证书修复命令管理员 PowerShellcertutil-urlcache-split-fhttp://ctldl.windowsupdate.com/msdownload/update/v3/static/trustedr/en/authrootstl.cabauthrootstl.cab certutil-addstore-f root authrootstl.cab certutil-verifyStore root重启电脑后再次尝试 pip 操作或启动 jupyter。额外强制 pip 使用 conda 自带的 certifi 证书束找到 Miniconda 的证书文件D:\miniconda\Lib\site-packages\certifi\cacert.pem设置环境变量SSL_CERT_FILED:\miniconda\Lib\site-packages\certifi\cacert.pemREQUESTS_CA_BUNDLE 同上优点根治问题pip 保持最新版。缺点操作有风险删错证书可能影响其他软件适合有经验用户。✅️问题延伸优先用 conda 管理包conda 自带二进制和证书管理几乎不受系统 SSL 影响。推荐把常用包如 numpy、pandas、jupyter、matplotlib都用 conda install。虚拟环境隔离创建新环境避免污染conda create -n myenv python3.11 jupyter conda activate myenv代理环境如果你在公司网络可能还有 HTTP_PROXY 设置干扰检查环境变量。切换到 Miniforge如果 Miniconda 问题反复考虑换 Miniforgeconda-forge 默认通道更社区化。✅️问题预测方案 A 后仍有警告可能是 jupyter 内部其他包检查执行pip check看看。降级 pip 后安装失败检查网络是否需要代理set HTTP_PROXYhttps://…。证书清理后其他软件如 Chrome报 SSL 错说明删错了证书赶紧从备份恢复。Windows 更新后问题复发微软偶尔会推送新根证书重复方案 C 即可。✅️小结这个问题本质是pip 新版 truststore 与 Windows 系统证书存储冲突最快速、最推荐的解决方案是方案 A设置 PIP_DISABLE_PIP_VERSION_CHECK1 trusted-host几分钟就能让 jupyter 正常启动如果想更彻底试降级 pip 到 23.3.2。 结语 互动说明希望以上分析与解决思路能为你当前的问题提供一些有效线索或直接可用的操作路径。若你按文中步骤执行后仍未解决不必焦虑或抱怨这很常见——复杂问题往往由多重因素叠加引起欢迎你将最新报错信息、关键代码片段、环境说明等补充到评论区我会在力所能及的范围内结合大家的反馈一起帮你继续定位 如果你有更优或更通用的解法非常欢迎在评论区分享你的实践经验或改进方案你的这份补充可能正好帮到更多正在被类似问题困扰的同学正所谓「赠人玫瑰手有余香」也算是为技术社区持续注入正向循环 文末福利技术成长加速包 文中部分问题来自本人项目实践部分来自读者反馈与公开社区案例也有少量经由全网社区与智能问答平台整理而来。若你尝试后仍没完全解决问题还请多一点理解、少一点苛责——技术问题本就复杂多变没有任何人能给出对所有场景都 100% 套用的方案。如果你已经找到更适合自己项目现场的做法非常建议你沉淀成文档或教程这不仅是对他人的帮助更是对自己认知的再升级。如果你还在持续查 Bug、找方案可以顺便逛逛我专门整理的 Bug 专栏《全栈 Bug 调优实战版》️这里收录的都是在真实场景中踩过的坑希望能帮你少走弯路节省更多宝贵时间。✍️如果这篇文章对你有一点点帮助欢迎给 bug菌 来个一键三连关注 点赞 收藏你的支持是我持续输出高质量实战内容的最大动力。同时也欢迎关注我的硬核公众号 「猿圈奇妙屋」获取第一时间更新的技术干货、BAT 等互联网公司最新面试真题、4000G 技术 PDF 电子书、简历 / PPT 模板、技术文章 Markdown 模板等资料通通免费领取。你能想到的绝大部分学习资料我都尽量帮你准备齐全剩下的只需要你愿意迈出那一步来拿。 Who am I?我是 bug菌热活跃于 CSDN | 掘金 | InfoQ | 51CTO | 华为云 | 阿里云 | 腾讯云 等技术社区CSDN 博客之星 Top30、华为云多年度十佳博主/卓越贡献者、掘金多年度人气作者 Top40掘金、InfoQ、51CTO 等平台签约及优质作者全网粉丝累计30w。更多高质量技术内容及成长资料可查看这个合集入口 点击查看 ️硬核技术公众号「猿圈奇妙屋」期待你的加入一起进阶、一起打怪升级。- End -