知仓学习社知仓学习社
transformers 报 We couldn't connect to 'https://huggingface.co' to load this file / 全站资源搜索
搜索 更新 2026-10-02
报错 069 网络、下载与访问（含国内网络环境） 有来源可查

transformers 报 We couldn't connect to 'https://huggingface.co' to load this file

报错原文（原样） 
We couldn't connect to 'https://huggingface.co' to load this file, couldn't find it in the cached files and it looks like bert-base-uncased is not the path to a directory containing a file named config.json.
Checkout your internet connection or see how to run the library in offline mode at 'https://huggingface.co/docs/transformers/installation#offline-mode'.
检索关键词 We couldn't connect to 'https://huggingface.co' to load this file、couldn't find it in the cached files、is not the path to a directory containing a file named config.json、Checkout your internet connection、offline mode、transformers
先看这一句 使用带 transformers 的节点（文本编码、打标、翻译、提示词扩写等）时报错，提示无法连接 huggingface.co 且在本地缓存里也找不到文件，节点直接失败。
适用版本 全版本通用，取决于节点是否依赖 transformers 在线加载 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器、全部主流环境

现象与触发场景

常见触发场景：

  • 首次使用某个 transformers 模型，需要在线拉取 config.json / tokenizer 等小文件
  • 之前下载到一半失败，本地缓存里留下了不完整的目录
  • 网络可访问但被代理拦截，或镜像端点没设

根因

  • transformers 加载模型时会先向 huggingface.co 查询仓库文件清单，该请求失败后回落到本地缓存；缓存里没有对应快照，于是抛出这条消息。
  • 报错里说 "is not the path to a directory" 的另一层含义是：传入的既不是一个已存在的本地目录，也不是一个能解析的仓库 ID，因此 transformers 把它当成远程仓库 ID 去联网。
  • 没有配置 HF_ENDPOINT 或代理，进程环境里没有可用出口。

解决步骤

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

  1. 设置 HF_ENDPOINT 指向镜像并完全重启 ComfyUI
    让 transformers 直接走国内镜像取 config/tokenizer 等文件。环境变量必须在 ComfyUI 进程启动前设置好，改完重启整个程序（不是刷新网页）。
    setx HF_ENDPOINT https://hf-mirror.com
    # Linux
    export HF_ENDPOINT=https://hf-mirror.com
  2. 改走离线模式，先把模型目录准备好
    如果模型文件已经手工下载齐全，可以让 transformers 完全不联网：把 HF_HUB_OFFLINE 设为 1，并把本地目录路径作为模型来源传给节点/脚本。ERROR 消息里给出的 offline-mode 文档链接就是这个思路。
    setx HF_HUB_OFFLINE 1
    # Linux
    export HF_HUB_OFFLINE=1
  3. 清掉不完整的缓存快照后重下
    下载中断会在 Hugging Face 缓存目录（默认 ~/.cache/huggingface/hub，Windows 下为用户目录 .cache\huggingface\hub）留下半成品目录，可能被误判为可用快照。定位到对应模型目录删除后重新下载，或改用能断点续传的下载方式。

验证是否修好

重启后重跑该节点：不再出现 We couldn't connect to 'https://huggingface.co' 提示，日志中能看到从镜像域名拉取文件并成功加载。

补充说明

该 issue（#5695）正文即为报错原文，报告者未追加解决方案；解决方案来自该报错文本自身给出的 offline-mode 指引、hf-mirror 官方用法页与 Manager 文档的 HF_ENDPOINT 说明。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [166] （官方 issue）　We couldn't connect to 'https://huggingface.co' to load this file ... 　https://github.com/Comfy-Org/ComfyUI/issues/5695
  2. [161] （官方文档）　🤗 HF-Mirror — 如何使用HF-Mirror　https://hf-mirror.com/

这条报错要用到的东西

按本条报错所属的类别（网络、下载与访问（含国内网络环境））列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

ComfyUI 权重库（167 个文件 / 约 1187 GB）按 ComfyUI 的 models 目录分好类的 167 个权重文件 / 每个文件一份说明（放哪、被哪些工作流引用） 待挂载
模型档案按仓库看体积，估一下要下多久 板块

同一类别的其他条目

【067】启动或加载工作流时连不上 huggingface.co，控制台报最大重试次数已超过 有来源 【068】SSL 证书校验失败：CERTIFICATE_VERIFY_FAILED unable to get local issuer certificate 有来源 【070】huggingface_hub 本地找不到文件：LocalEntryNotFoundError / EntryNotFoundError 含未核实 【071】Gated 仓库无权访问：需要登录并同意协议（Llama / Flux 等） 含未核实 【072】ComfyUI-Manager 安装节点失败：连不上 GitHub（Failed to connect to github.com port 443） 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库