知仓学习社知仓学习社
报错 SSL: CERTIFICATE_VERIFY_FAILED（pip / Manager 拉取节点与依赖时证书校验失败） / 全站资源搜索
搜索 更新 2026-10-02
报错 033 依赖缺失与自定义节点安装失败 有来源可查

报错 SSL: CERTIFICATE_VERIFY_FAILED（pip / Manager 拉取节点与依赖时证书校验失败）

报错原文（原样） 
SSL: CERTIFICATE_VERIFY_FAILED
检索关键词 SSL: CERTIFICATE_VERIFY_FAILED、bypass_ssl、config.ini、CERTIFICATE_VERIFY_FAILED、证书校验、下载失败
先看这一句 pip 安装或 Manager 拉取节点清单时报 SSL 证书校验失败，下载中断；同一网络下浏览器可能正常，命令行却失败。
适用版本 全版本通用；bypass_ssl 为 Manager 的 config.ini 选项，其可用性随 Manager 版本变化 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器

现象与触发场景

常见触发场景：

  • 公司网络/安全软件做了 HTTPS 中间人解密，证书链不被 Python 信任
  • 系统根证书缺失或过期（常见于长期未更新的 Windows）
  • 代理软件提供的是自签名证书

根因

  • Python 使用自带的证书校验逻辑，不会自动信任被中间设备替换的证书
  • 系统证书库缺少对应根证书
  • 走代理时证书与目标域名不匹配

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 在 Manager 中开启 bypass_ssl（官方文档给出的做法）
    官方 Manager 排障文档明确：遇到 SSL: CERTIFICATE_VERIFY_FAILED 时，编辑 config.ini 加入 bypass_ssl = True。注意这会关闭证书校验，等于降低安全等级，仅在你确认网络环境可信时使用，问题解决后建议改回。
    bypass_ssl = True
  2. 从根因修证书链
    更稳妥的做法是让系统信任正确的证书：更新系统根证书、更新 pip，或按公司代理提供的根证书配置 Python 的证书路径（优先向网络管理员索取正式证书而不是长期关闭校验）。
    ..\..\python_embeded\python.exe -m pip install --upgrade pip
  3. 改用国内可信镜像降低触发概率
    若只是访问 PyPI/GitHub 不稳定，可改用可信镜像源安装依赖，同时为 Manager 配置 GITHUB_ENDPOINT 走镜像，减少证书不匹配的中间环节。
    ..\..\python_embeded\python.exe -m pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

验证是否修好

重新执行 pip 安装或 Manager 拉取操作不再出现 SSL 报错并能成功下载；若曾开启 bypass_ssl，恢复该选项后确认网络本身已可信。

补充说明

镜像源地址仅为示例，请以你实际可用的镜像为准（未经本机验证）。bypass_ssl 会关闭证书校验，属降低安全性的操作，请权衡后使用。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [80] （官方文档）　ComfyUI Manager Troubleshooting（SSL certificate verification failed）　https://docs.comfy.org/manager/troubleshooting
  2. 模型与权重文件加载（11 条）

这条报错要用到的东西

按本条报错所属的类别（依赖缺失与自定义节点安装失败）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

常用节点速查包常用节点参数小抄 / 常见连法示意图 待挂载
节点库按用途找节点仓库，附适配模型与下载量 板块

同一类别的其他条目

【023】报错 No module named 'insightface'（IPAdapter 人脸加载器 / ReActor 换脸节点不可用） 有来源 【024】一个节点包报错导致 / 或看似导致所有自定义节点加载中断（Cannot import ... custom_nodes） 有来源 【025】报错 No module named 'cv2'（controlnet_aux / WanVideoWrapper 等节点导入失败） 有来源 【026】报错 ImportError: DLL load failed while importing onnxruntime_pybind11_state（缺 Visual C++ 运行库 / onnxruntime 版本不匹配） 有来源 【027】报错 ImportError: cannot import name 'cached_download' from 'huggingface_hub'（diffusers 与新版 huggingface_hub 不兼容） 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库