Qwen-Image 2.1常见问题排查清单模型加载失败、显存溢出、出图异常的终极解决方案【免费下载链接】Qwen-Image-2.1项目地址: https://ai.gitcode.com/hf_mirrors/Comfy-Org/Qwen-Image-2.1Qwen-Image 2.1 是面向文生图与图像编辑的高性能扩散模型本仓库HuggingFace 镜像 / Comfy-Org提供了适配 ComfyUI 的完整模型文件。本文是一份Qwen-Image 2.1 常见问题排查清单按「模型加载失败 → 显存溢出OOM→ 出图异常」三大高频问题逐项排查帮你快速定位并解决 ComfyUI 中跑不通、跑不动、跑不好的情况。一、动手前先认识模型文件三大目录各司其职排查任何问题的第一步是确认你拿对了文件。本仓库按 ComfyUI 的标准目录结构组织共 8 个模型文件目录文件大小作用扩散模型diffusion_models/qwen_image_2.1_bf16.safetensors13.25 GB核心 DiT 主干bf16 全精度扩散模型diffusion_models/qwen_image_2.1_int8_convrot.safetensors6.76 GB核心 DiT 主干int8 量化省显存文本编码器text_encoders/qwen3vl_8b_bf16.safetensors16.33 GBQwen3-VL 8Bbf16 全精度文本编码器text_encoders/qwen3vl_8b_int8_convrot.safetensors8.71 GBQwen3-VL 8Bint8 量化文本编码器text_encoders/qwen3vl_8b_w4a8.safetensors5.88 GBQwen3-VL 8Bw4a8最省显存文本编码器text_encoders/qwen3.5_9b_qwen_image_2.1_pe_t2i.int8_convrot.safetensors8.82 GB提示词增强模型文生图专用文本编码器text_encoders/qwen3.5_9b_qwen_image_2.1_pe_i2i.int8_convrot.safetensors8.82 GB提示词增强模型图像编辑专用VAEvae/qwen_image_2.1_vae_bf16.safetensors0.63 GB图像解码器出图必需小贴士pe_t2i/pe_i2i两个提示词增强Prompt Enhance编码器只有在工作流启用了该节点时才需要平时可以不下载直接省掉约 17 GB 磁盘和可观的显存占用。模型文件应放在哪里下载后按 README.md 所示结构将文件放入 ComfyUI 安装目录的models/下 ComfyUI/ └── models/ ├── diffusion_models/ ← 放 2 个 qwen_image_2.1_* 扩散模型 ├── text_encoders/ ← 放 qwen3vl_8b_* 与 pe_* 编码器 └── vae/ ← 放 qwen_image_2.1_vae_bf16二、模型加载失败按顺序逐项排查的 5 步法1. 检查是否克隆到的是 LFS 占位符最高频原因本仓库模型文件通过 Git LFS 存储。如果 clone 时没有启用 LFS下载到的只是几百字节的文本指针文件ComfyUI 会报safetensors: magic number not matching、file truncated等加载失败错误。判断方法用文件管理器或ls -lh查看正常文件应为 GB 级如 bf16 扩散模型约 13.25 GB若只有几 KB即为占位符需重新带 LFS 拉取git clone https://gitcode.com/hf_mirrors/Comfy-Org/Qwen-Image-2.1 cd Qwen-Image-2.1 git lfs pull2. 确认文件放对了目录diffusion_models/、text_encoders/、vae/三个目录各司其职VAE 放进扩散模型目录、编码器放进 VAE 目录都会导致 ComfyUI 列表里根本看不到文件。对照上文「模型文件应放在哪里」一节的目录树核对即可。3. 检查文件名与版本是否配套Qwen-Image 2.1 的 VAE 是 qwen_image_2.1_vae_bf16.safetensors请确认没有误用旧版 Qwen-Image1.x的模型文件——版本混用会出现「加载报错」或「节点无可选模型」。4. 加载阶段的 OOM 也属于「加载失败」如果报错是CUDA out of memory且发生在加载/首次推理阶段说明你选了全精度文件但显存不足跳到下一节按显存档位换量化版本。5. 磁盘空间与完整性全部 8 个文件合计约 70 GB其中任意两个「主力」文件bf16 组合就需约 30 GB 磁盘空间。磁盘写满也会导致文件截断、加载失败下载完成后建议核对一遍文件大小与上表是否一致。三、显存溢出OOM自救指南按显存档位选对模型ComfyUI 跑 Qwen-Image 2.1 显存不够时最直接的解法就是换量化版本。以下为经验参考档位GPU 显存扩散模型文本编码器备注≥ 24 GBqwen_image_2.1_bf1613.25 GBqwen3vl_8b_bf1616.33 GB全精度质量优先16 GBqwen_image_2.1_int8_convrot6.76 GBqwen3vl_8b_int8_convrot8.71 GB画质损失很小性价比首选12 GB 左右qwen_image_2.1_int8_convrot6.76 GBqwen3vl_8b_w4a85.88 GB最省显存组合建议再降分辨率⚠️ VAE0.63 GB任何档位都不可省且无量化版本属固定开销。换完量化模型仍 OOM按此顺序再压一压关闭提示词增强节点pe_t2i/pe_i2i编码器各自还要额外占用约 8.8 GB 级别的显存普通出图完全可以不用降低生成分辨率先以较低分辨率验证流程跑通再逐步上调确认模型卸载机制正常ComfyUI 默认会把不用的模型移出显存同时挂多个大模型的工作流会显著加剧峰值占用检查后台占卡程序浏览器硬件加速、其他渲染进程常是隐形显存杀手。四、出图异常排查糊图、色偏、重复纹理的三大成因1. 图像整体发糊、发灰、偏色 → VAE 问题这是最典型的 VAE 症状。检查两点工作流中 VAE 节点是否确实加载了 qwen_image_2.1_vae_bf16.safetensors而不是默认 VAE 或其他模型的 VAE解码VAE Decode节点是否接在扩散模型输出之后——漏接会导致输出 latent 被错误解码。2. 文字乱码、主体漂移 → 文本编码器与任务类型不匹配文生图任务请搭配t2i方向的提示词增强模型pe_t2i图像编辑任务请搭配i2i方向pe_i2i混用或版本不配套会出现语义理解偏差、编辑效果「改不动」或「乱改」的情况。3. 分辨率与宽高比异常Qwen-Image 2.1 对高分辨率长边支持较好但极端宽高比如 1:5 横幅容易出现主体拉伸或重复纹理。建议常用比例1:1、4:3、3:2、16:9内创作特殊比例先低分辨率试跑确认效果再出成品。五、30 秒快速自查清单排查 Qwen-Image 2.1 出问题时按下面这张清单从上到下过一遍可解决绝大多数问题文件大小是否为 GB 级而非几 KB 的 LFS 占位符文件是否放在diffusion_models/、text_encoders/、vae/对应目录所选模型档位是否与你的显存匹配见第三节对照表是否开启了用不到的提示词增强节点VAE 节点加载的是否为qwen_image_2.1_vae_bf16文本编码器类型t2i / i2i是否与任务匹配后台是否有其他程序占用显存按此清单逐项核对即可让 Qwen-Image 2.1 在 ComfyUI 中稳定跑起来。祝出图顺利 【免费下载链接】Qwen-Image-2.1项目地址: https://ai.gitcode.com/hf_mirrors/Comfy-Org/Qwen-Image-2.1创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考