1. moss-image.com
  2. 问题排查

MOSS-Image 常见问题与解决方法

竖向条纹、纯噪点、全黑图片、缺少节点、Mac 报错和显存不足:每个问题的原因,以及已经确认有效的解决方法。

MOSS-Image 的大多数问题来自几个原因:ComfyUI 版本太旧、shift 节点用错、SFT 的条纹瑕疵,或者显存不够。 在下面找到你的症状即可。每条方法都链接到确认它的 issue 或模型卡,属于社区方案而非官方方案的,我们会注明。

只想出图?在线生成器运行的是同一个模型,无需任何配置。

速查表

症状最可能的原因解决方法
淡淡的竖向色带SFT 瑕疵Destripe 或 DeBand LoRA,或改用 Base
纯噪点ModelSamplingSD3 节点改用 ModelSamplingAuraFlow 或 ModelSamplingFlux
全黑图片部分开发版上的 --bf16-vae去掉该参数或更新 ComfyUI
“Could not detect model type”、缺少 MOSS 节点ComfyUI 低于 0.42.0更新到 0.42.0 或以上
'NoneType' object has no attribute 'dtype'用旧插件加载 Comfy-Org 文件改用原生 Load Diffusion Model 节点
Cannot convert a MPS Tensor to float64Apple SiliconCPU 时间步补丁
显存不足小显卡加载 bf16 文件int8 模型、w4a8 文本编码器或 GGUF
文字写错没加引号、CFG 太低、开了增强文字加引号,CFG 3,50 步
布局框被忽略开了提示词增强、画布尺寸不一致关闭增强,宽高保持一致

SFT 出现竖向条纹

症状: 画面上有淡淡的竖向色带,在天空、墙面、雾和纯色背景中最明显。宽 1024 像素时间距约 21 像素,768 像素时约 16 像素。

原因: 这是 SFT 权重的瑕疵。用户报告 Base 没有这个问题,换哪个 VAE 都一样。OpenMOSS 还没有在任何一个讨论帖中回复,因此关于“为什么”的解释都尚未确认。

解决方法(均为社区 LoRA,只适用于 SFT;用 LoraLoaderModelOnly 加载):

  1. nynxz Destripe:loras/moss_sft_destripe_top64_bf16.safetensors,只有 1.9 MB。768 像素用 1.0,1024 像素用 1.5;作者说明在 1024 像素下用 1.0,约一半图片仍有淡淡残留。对画面改动最小。
  2. MATLOWAI DeBand:官方 README 中有链接。先用 moss_image_sft_banding_fix_L37-41_bf16.safetensors,强度 1.0。宽图或大面积天空可再加 moss_image_sft_banding_fix_L32-36_extra_bf16.safetensors,强度 1.0。另有更强的完整 LoRA,但对画面改动更大。
  3. 改用 Base。 完全没有这个瑕疵,代价是文字分组不如 SFT 清晰。短提示词时把 CFG 提高到 4–5。

目前没有证据表明单靠调整采样器、步数或 CFG 能去除条纹。这些 LoRA 对文字的影响几乎没有测试过,开启后请检查图中文字。

ComfyUI 中只出纯噪点

症状: 输出是随机噪点,或者 KSampler 报 dtype 错误。

原因: 用 ModelSamplingSD3 节点设置 shift。ComfyUI 维护者在关闭 issue #17119 时给出的就是这个答案。

解决方法: 换成 ModelSamplingAuraFlow 或 ModelSamplingFlux(shift 5)。内置的 MOSS-Image 模板已经这样设置,直接从模板开始最省事。

图片全黑

症状: 每次都输出纯黑图片,控制台有时出现 RuntimeWarning: invalid value encountered in cast。

原因: 在提交 d07dff45 前后的 ComfyUI 开发版中,融合后的 FLUX.2 VAE 用 bf16 解码时会输出 NaN(issue #17317)。

解决方法: 从启动参数中去掉 --bf16-vae,或者更新 ComfyUI。报告者已确认 master 上的提交 fb3befd1 修复了这个问题。

“Could not detect model type”与缺少节点

症状: 出现 RuntimeError: ERROR: Could not detect model type of: …moss_image_…safetensors,CLIP 加载器不接受 moss_image 类型,或者工作流提示缺少 MOSS-Image 节点。

原因: ComfyUI 低于 0.42.0。0.42.0(2026 年 10 月 18 日)是第一个原生支持 MOSS-Image 的稳定版,0.41.x 不支持。

解决方法: 通过 ComfyUI Manager 更新,或执行 git pull 后再运行 pip install -r requirements.txt,让独立的模板包一起更新。原生工作流不需要任何自定义节点。缺少 MOSSImageHFLoader 说明你在用旧版 OpenMOSS 插件的工作流,请改用原生模板。四个文件及存放位置见 ComfyUI 教程。

“'NoneType' object has no attribute 'dtype'”

症状: 加载模型时报 AttributeError: 'NoneType' object has no attribute 'dtype'。

原因: Comfy-Org 的单文件权重把注意力权重合并存储,而旧版 OpenMOSS 插件的加载器要求分开存储(OpenMOSS issue #10)。

解决方法: 用 ComfyUI 原生的 Load Diffusion Model 节点加载 Comfy-Org 文件。插件只用来加载完整的 Diffusers 目录。

显存不足与低显存运行

OpenMOSS 没有公布官方显存要求,关键看你加载了哪些文件。以下文件大小来自 Comfy-Org/MOSS-Image 和 unsloth 的 GGUF 版本:

组件常用的最小版本全精度
扩散模型int8 ConvRot,5.41 GB(GGUF Q4:3.2–3.4 GB)bf16,10.16 GB
文本编码器(Qwen3.5-9B)w4a8 GPTQ,7.34 GBbf16,19.31 GB
VAEflux2-vae_small,0.25 GBflux2-vae,0.34 GB

ComfyUI 不会把所有组件同时放在显卡上,放不下的部分会卸载到内存,速度更慢但能运行。小显卡建议:

  • 使用 moss_image_sft_int8_convrot 和 qwen3.5_9b_w4a8_gptq,官方模板加载的就是这一组。
  • 先用 1 百万像素(1024 × 1024)生成,再考虑更大尺寸。
  • GGUF 适合显存非常小的显卡,但 ComfyUI 维护者认为 int8 比 GGUF 更快,更推荐 int8。

目前还没有经过核实的分显卡测速,因此我们不给出具体显卡的每张耗时。

Mac(Apple Silicon):“Cannot convert a MPS Tensor to float64”

症状: 报错 TypeError: Cannot convert a MPS Tensor to float64 dtype as the MPS framework doesn't support float64.

原因: Diffusers 管线用 float64 计算时间步嵌入,而 MPS 不支持 float64。

解决方法(OpenMOSS issue #23,社区补丁,尚未合并):在 CPU 上计算正弦嵌入,再移回设备。

freq = 10000 ** (-torch.arange(half, device="cpu", dtype=torch.float64) / half)
phase = times.detach().cpu().double()[:, None] * freq
embedding = torch.cat((phase.cos(), phase.sin()), -1).float().to(times.device)

请使用 .cpu().double()。报告者发现在 MPS 上 .to("cpu", torch.float64) 会静默返回全零,导致输出噪点。打补丁后,一台 64 GB 的 M5 Pro 以 25 步、CFG 2.5 生成 1024 × 1024 用时 89 秒。16 GB 的 Mac 目前还没有成功运行的报告。

文字写错或乱码

根据官方用户指南和我们自己的测试:

  • 把要出现的文字放进引号,一字不差。
  • 自己换行:在引号内直接写出换行。
  • 长提示词用 CFG 3(短提示词 3–6),50 步。CFG 太低会让文字乱掉。
  • 文字必须准确时关闭提示词增强,它会改写你的提示词。
  • 画面描述用英文最稳;图中的文字可以是中文或英文。
  • 少步数 LoRA 用文字准确度换速度,最终出字请用完整步数。

更多写法见提示词库。

布局框被忽略

  • 布局工作流中关闭提示词增强,它可能丢掉框。
  • 生成尺寸要与布局的宽高完全一致,且都是 16 的倍数。
  • 坐标格式为 [y_min, x_min, y_max, x_max],原点在画布中心,y 轴向下。布局编辑器会帮你自动生成,布局教程解释了换算方法。

背景发虚、景深太浅

多位用户反映默认景深很浅。目前没有经过验证的解决方法,OpenMOSS 也还没有回复。可以试着把场景描述为全景清晰(例如“deep focus, everything in focus”),但我们还没有测量它的效果。

生成太慢

默认质量需要 50 步。社区少步数 LoRA,例如 lodestones 的 8 步 DMD,可以降到 4–8 步、CFG 1,但画面会明显变化,文字也可能出错。官方蒸馏模型尚未发布,OpenMOSS 表示正在开发。

编辑现有照片

官方模型只支持文生图。社区的编辑 LoRA 可在 ComfyUI 开发分支上使用(支持代码于 2026 年 10 月 22–23 日合并,尚未进入稳定版)。本站在线生成器不提供编辑功能。

Hugging Face 下载到哪里

OpenMOSS 的脚本使用 Hugging Face 缓存。想把 27 GB 的 Diffusers 仓库放到其他位置,可在启动前设置 HF_HUB_CACHE=/path/to/cache,或用 hf download OpenMOSS-Team/MOSS-Image-SFT --local-dir /path 下载到指定目录,再让程序指向该目录。

我们如何核对本文:每条方法都链接到报告它的 issue、讨论帖或模型卡,社区方案均已注明。最后核对于 2026 年 10 月 27 日。我们没有在自己的显卡上复现这些方法。

常见问题

MOSS-Image SFT 为什么会出现竖条纹?

这是 SFT 版本已知的瑕疵:淡淡的竖向色带,宽 1024 像素时间距约 21 像素,Base 没有这个问题。OpenMOSS 尚未回应。社区的 Destripe LoRA(768 像素用 1.0,1024 像素用 1.5)可以在大多数图片中去除,或者改用 Base。

MOSS-Image 在 ComfyUI 里为什么只出噪点?

通常是因为工作流用了 ModelSamplingSD3 节点设置 shift。ComfyUI 维护者已确认这一点:改用 ModelSamplingAuraFlow 或 ModelSamplingFlux,或者直接从内置的 MOSS-Image 模板开始。

MOSS-Image 生成的图片为什么全黑?

2026 年 10 月下旬的部分 ComfyUI 开发版中,融合后的 FLUX.2 VAE 在 bf16 下会输出 NaN。去掉启动参数 --bf16-vae,或者更新 ComfyUI:报告者已确认后续的 master 提交修复了这个问题。

MOSS-Image 需要多少显存?

OpenMOSS 没有公布官方数字。int8 扩散模型为 5.41 GB,Comfy-Org 最小的文本编码器为 7.34 GB,放不下的部分 ComfyUI 会自动卸载到内存。GGUF 版本的扩散模型最小约 3 GB。8 GB 显卡可以跑,但会更慢。

MOSS-Image 能在 Mac 上运行吗?

可以,在 Apple Silicon 上通过 Diffusers 运行,但需要一个小补丁:时间步嵌入使用 float64,而 MPS 不支持。社区报告的修复是在 CPU 上计算这一步。一台 64 GB 的 M5 Pro 用 25 步生成 1024 × 1024 用时 89 秒。

参考资料