知仓学习社知仓学习社
装完 xformers 后 torch 被降级、加速库反而让 ComfyUI 崩（xformers 陷阱） / 全站资源搜索
搜索 更新 2026-10-02
报错 061 PyTorch、CUDA 运行库与加速库冲突 含未核实说明

装完 xformers 后 torch 被降级、加速库反而让 ComfyUI 崩（xformers 陷阱）

报错原文（原样） 
xformers is installed but its kernels cannot load, falling back to PyTorch's own attention
（注：以上为转述文本，非逐字原文。）
检索关键词 No module named 'xformers'、xformers 版本与 torch 不匹配、安装 xformers 后崩溃、xformers 让 torch 降级、black images with xformers、pip install xformers!=0.0.18
先看这一句 为了让注意力更快装了 xformers，结果重启后原本正常的出图在第一个采样步就崩，或输出全黑；另一类情况是节点报 No module named 'xformers' / xformers 无法导入，而此前 torch 明明工作正常。
适用版本 全版本通用；Blackwell / 50 系受影响最严重，因为 xformers 在 2025 年早期还没有 Blackwell 构建，装它往往会把 torch 换成不支持 sm_120 的版本。上述“xformers 会悄悄降级 torch”的实测记录出自 2025 年 7 月一位 RTX 5090 用户的排障文章（torch 2.11.0+cu130 被替换）。 · 核实日期 2026-09-26 · 状态 可能已过期，正在复核
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、全部主流环境

现象与触发场景

常见触发场景：

  • 在 Blackwell（50 系）上按教程装 xformers
  • 升级 torch 之后没有同步更新 xformers
  • 装的是与当前 torch 不匹配的 xformers wheel，pip 为了满足依赖把 torch 换成了旧版

根因

  • xformers 是针对特定 torch + CUDA 组合编译的二进制，换 torch 之后旧的 xformers 就不匹配并抛错；同时 pip 在解析 xformers 依赖时可能选择与你当前 torch 不兼容的 wheel，并顺手替换 torch，而替换后的 torch 可能不含 sm_120 kernel。
  • ComfyUI 官方文档记录了一个具体的 xformers 版本 bug：xformers 0.0.18 会导致高分辨率输出全黑，官方给出的修法是安装时排除该版本或直接禁用 xformers。
  • 禁用/去掉 xformers 后 ComfyUI 依然能运行，只是注意力实现回退，说明它不是必需依赖。

解决步骤

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

  1. 先卸载 xformers，确认崩溃是否消失
    xformers 不是 ComfyUI 的必需依赖，卸载后 ComfyUI 会使用其他注意力实现。用便携版解释器卸载，并在启动参数上加 --disable-xformers 作为双重保险。
    .\python_embeded\python.exe -m pip uninstall -y xformers
    .\python_embeded\python.exe -s ComfyUI\main.py --disable-xformers
  2. 卸载后立刻检查 torch 有没有被改动过
    装/卸任何注意力相关库之后都要重新打印 torch 版本，只要 cuda 后缀变了就说明被改过；若被换成不含 sm_120 kernel 的版本，按第 2 条的办法重装 cu128 及以上三件套。
    .\python_embeded\python.exe -c "import torch; print(torch.__version__, torch.version.cuda, torch.cuda.is_available())"
  3. 确实需要 xformers 时，装与当前 torch 版本严格对应的那一版
    安装前先确定当前 torch 的完整版本号（含 cu 后缀），再去找为该版本编译的 xformers wheel，不要用不加约束的 pip install xformers；官方文档还给出过排除特定坏版本的写法。若无论如何都装不上，改用 ComfyUI 自带的注意力后端（--use-pytorch-cross-attention）或 SageAttention 路线。
    .\python_embeded\python.exe -m pip install "xformers!=0.0.18"
    .\python_embeded\python.exe -s ComfyUI\main.py --use-pytorch-cross-attention

验证是否修好

卸载 xformers 后能正常出图且图像不是全黑；torch.__version__ 与卸载前一致（cuda 后缀未变化）；若改用 SageAttention，先跑其自带测试脚本确认注意力后端本身可用。

补充说明

[未核实] xformers 0.0.34 声称支持 PyTorch>=2.10 但实际不支持的 issue（facebookresearch/xformers#1374）只拿到标题，正文未取证，故未写入条目正文。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [136] （官方文档）　Common Issues and Solutions - ComfyUI（Black images with xformers 0.0.1　https://mintlify.wiki/Comfy-Org/ComfyUI/guides/common-issues
  2. [146] （社区）　RTX 5090 survival guide: sm_120, CUDA 12 and 13 side by side, and the 　https://dev.to/madcoolseed/rtx-5090-survival-guide-sm120-cuda-12-and-13-side-by-side-and-the-xformers-trap-25nh
  3. [147] （社区）　ComfyUI on Windows: fixing the CUDA version-mismatch mess - Big Iron　https://www.bigiron.cc/guides/comfyui-on-windows-cuda-version-mismatch-troubleshooting
本条的可靠性边界 下面这些位置带 [未核实] 标记，是采集时没找到一手来源的部分，请自行验证：
  • 补充说明

这条报错要用到的东西

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

环境与依赖配置包依赖版本组合清单 / 环境自检脚本说明 待挂载

同一类别的其他条目

【056】启动或首次生成时报 AssertionError: Torch not compiled with CUDA enabled（装成了 CPU 版 torch） 有来源 【057】50 系显卡第一次卷积就崩：CUDA error: no kernel image is available for execution on the device 含未核实 【058】启动直接崩：torch / torchvision / torchaudio 三者 CUDA 版本不一致 含未核实 【059】节点执行时报 Could not run 'torchvision::nms' / operator torchvision::nms does not exist 含未核实 【060】自定义节点装完 / 更新依赖后 torch 被偷换成 CPU 版（依赖漂移） 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库