跳至正文
ComfyUI WorldBETA
登录
资料整理

Spandrel 已安装仍打不开模型:先查支持的架构

把库的安装、模型架构识别和权重来源分别核对,不因后缀相同就判断能够加载。

更新于 2026-09-25发布修订: 7资料基线: 7

安装成功只解决一层问题

Spandrel 用于识别并加载文档列出的部分 PyTorch 模型架构,并不支持所有检查点。README 用 + 标记仅在 spandrel_extra_arches 中提供的架构;额外包含许可限制更严的架构,因此安装与实际用途都要另行核对。Spandrel README

我们建议收集三份信息

先确认启动 ComfyUI 的同一 Python 能实际导入主包,再记录模型发布者、原始发布页、准确文件与修订,以及调用节点的版本和完整错误。

python -c "import sys; print(sys.executable); import spandrel; print(spandrel.__file__)"

README 列出受支持架构的 .pth、部分 .pt 和 .ckpt,以及 .safetensors;后缀本身不证明架构受支持。缺主包先查解释器与依赖;出现 UnsupportedModelError 或不识别权重字典时,核对该版本的架构注册与真实文件,不直接断定文件损坏。上游贡献指南说明会根据权重键检测架构;改名不能改变架构。文件类型 架构检测

别把补包当成默认授权

若目标架构标有 +,上游示例要求先导入 spandrel_extra_arches,并在使用 ModelLoader 前调用 spandrel_extra_arches.install()。仅查到额外包已安装,不能证明当前节点已经注册这些架构。应核对节点集成及模型、架构的许可;本站不替代实际项目的使用许可判断。额外架构用法

验收怎么写

与一份来源明确、该版本支持的模型对照,分别记录导入、架构识别、模型加载和输出。若只有某个新文件失败,保留完整错误与文件身份供作者核查,不默认重装整个环境。

相关排查

2026-09-26 复核来源并审阅中文。未安装包、加载模型、执行 ComfyUI 或 GPU 复现。这些检查是编辑建议,不表示已诊断你的模型。

还没解决?

排查下一个可能的原因

同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。

  1. Kornia 导入失败:主包、Torch 和可选依赖要分开看No module named kornia先判断主包缺失还是某项功能缺少额外依赖,不把最新安装命令强加给旧节点。
  2. safetensors 模块缺失还是权重文件无法读取?先分阶段排查No module named safetensors用失败阶段区分 Python 依赖和模型文件问题,保留来源、版本、大小与校验记录。
把完整日志粘贴到报错排查工具

这篇内容对你有帮助吗?

匿名统计,只记录“有/没有帮助”的计数,不记录账号、IP 地址或设备信息。

资料来源

2026-09-26 复核 Spandrel 当前 README 与贡献指南的架构注册说明,并审阅中文。未安装包、读取模型文件、执行 ComfyUI 或 GPU。

01Spandrel upstream README资料核对: 2026-09-2602Spandrel architecture contribution guide资料核对: 2026-09-26

报告问题 · 3167afec-679d-5672-8ac2-70bb048db594