知仓学习社知仓学习社
加载 checkpoint 报 EOFError: Ran out of input / PytorchStreamReader failed（旧式 ckpt 文件损坏或不完整） / 全站资源搜索
搜索 更新 2026-10-02
报错 043 模型与权重文件加载 有来源可查

加载 checkpoint 报 EOFError: Ran out of input / PytorchStreamReader failed（旧式 ckpt 文件损坏或不完整）

报错原文（原样） 
EOFError: Ran out of input
检索关键词 EOFError: Ran out of input、Ran out of input、PytorchStreamReader failed locating file、PytorchStreamReader failed reading zip archive: failed finding central directory、checkpoint is corrupt
先看这一句 加载 .ckpt（或某些 .pth/.pt）模型时直接抛 Python 异常，可能是一句毫无上下文的 Ran out of input，也可能是 PyTorch 流式读取失败，节点直接变红。
适用版本 全版本通用；主要影响旧式 .ckpt 与 .pt/.pth 模型，safetensors 文件不会出现 EOFError（而是报 safetensors 头部错误） · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器

现象与触发场景

常见触发场景：

  • 老式 .ckpt 下载中断，文件被截断
  • 从网盘/浏览器下载时被改名或截断的单文件模型
  • 把非 PyTorch 格式的文件（如只含部分权重的分片）当成完整 ckpt 加载

根因

  • 旧的 .ckpt 格式是把 pickle 与张量数据打包成 zip 的单文件。文件被截断时，pickle 反序列化读到文件末尾、再没有下一个对象可读，就抛出 EOFError: Ran out of input——这个报错本身完全没有提到模型，特别容易被误判。
  • PyTorch 侧的对应报错是 PytorchStreamReader：它读不到 zip 的中央目录或找不到 data/ 下的数据文件，含义同样是「这个 checkpoint 不完整/已损坏」，PyTorch 官方也在补丁里强调这类 miniz 错误基本等同于 checkpoint 损坏。

解决步骤

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

  1. 第一步：确认是文件问题而非节点问题
    查看文件大小是否与来源标注一致；如果这个模型在别人的机器上也报同样的错，或你换个模型就能正常加载，基本可确定是该文件损坏。相关节点（如 segment anything、Frame-Interpolation 等）抛 Ran out of input 时，第一步同样是检查它依赖的那个权重文件是否完整。
    Get-Item .\models\checkpoints\model.ckpt | Select-Object Length
  2. 第二步：重新完整下载，优先选 safetensors 版本
    删除损坏文件后用支持续传与校验的工具重下。如果来源同时提供 .safetensors 与 .ckpt，优先用 safetensors：它不做 pickle 反序列化，二进制截断会给出明确得多的报错，也更安全。下完按模型类型放到 models/checkpoints 等目录。
    hf download <repo_id> model.safetensors --local-dir ./models/checkpoints
  3. 第三步：仍怀疑损坏时做哈希校验
    对来源提供 SHA-256 的文件，本地算一遍并比对；不一致就重下。对于没有官方哈希的来源，至少做「能完整加载一次」的验证，避免在工作流中途才暴露。
    Get-FileHash .\models\checkpoints\model.ckpt -Algorithm SHA256

验证是否修好

模型能正常加载进显存并出现在加载器里；控制台不再出现 EOFError 或 PytorchStreamReader 报错；队列能跑完出图。

补充说明

PytorchStreamReader failed locating file data/... 与 failed reading zip archive: failed finding central directory 属同一族的「checkpoint 损坏」报错，社区案例里见于 RIFE 插帧等节点加载 .pth 时。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [117] （节点仓库 issue）　Getting a "Ran out of input" error from one of the dependencies when c　https://github.com/storyicon/comfyui_segment_anything/issues/47
  2. [118] （官方 issue）　Make it explicit that PyTorchStreamReader miniz errors likely indicate　https://github.com/pytorch/pytorch/pull/170244
  3. [119] （节点仓库 issue）　An error occurs when executing the FILM_VFI node · Issue #90 · Fannove　https://github.com/Fannovel16/ComfyUI-Frame-Interpolation/issues/90

本条报错提到的目录

本条报错的原文或解决步骤里出现了下面这些 models/ 子目录。 权重库里放在这些目录下的文件已按目录列好，可对照确认自己缺的是哪几个。

models/checkpoints/权重库里有 11 个文件放在这个目录 看这一目录

这条报错要用到的东西

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

ComfyUI 权重库（167 个文件 / 约 1187 GB）按 ComfyUI 的 models 目录分好类的 167 个权重文件 / 每个文件一份说明（放哪、被哪些工作流引用） 待挂载
权重库每个文件放哪个目录、文件名怎么写、被哪些工作流引用 板块 模型档案按上游仓库看完整文件树与体积 板块

同一类别的其他条目

【034】加载模型报 Error while deserializing header: HeaderTooLarge（文件根本不是 safetensors） 有来源 【035】加载模型报 MetadataIncompleteBuffer 或 incomplete metadata：文件下载被截断 有来源 【036】下拉框里找不到模型 / 报 Value not in list: ckpt_name not in []（模型放错目录或没刷新） 有来源 【037】LoRA 加载报 lora key not loaded：LoRA 与底模架构不匹配或被当成 checkpoint 加载 有来源 【038】IPAdapter 报 ClipVision model not found：CLIP Vision 是独立文件，需放进 models/clip_vision 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库