生成黑图或异常颜色：先定位采样、VAE 与显示环节
任务没有立即报错，却输出黑图、无效像素或明显异常颜色。先判断实际保存文件是否异常，再区分输入、采样、解码和显示问题；黑色预览与黑色成品不能混为同一现象。
现象与适用范围
任务没有立即报错，却输出黑图、无效像素或明显异常颜色。先判断实际保存文件是否异常，再区分输入、采样、解码和显示问题；黑色预览与黑色成品不能混为同一现象。
以下是检索词和可能的警告，不代表同一个案均出现；引用的 issue 中实际出现的是 invalid-cast 警告：
invalid value encountered in cast
black image
NaN
已核对的依据
官方基础流程将采样、VAE 解码和保存分开。历史 issue #1402 包含黑图与无效数值转换警告，但报告者最初对 VAE 精度的归因已划去，本文不把那段猜测作为确定原因。 I18 D11 D03
需要区分的情况
1. 实际像素正常，问题只在前端预览、浏览器或媒体显示环节。
2. 采样或解码出现非有限数值、精度问题或错误配套，最终在保存时表现为黑图。
3. 输入、mask、过强适配或特定参数组合导致结果异常，需要通过最小对照定位。
建议的操作顺序
以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。
第 1 步。 用另一款可信图片查看器检查保存文件，比较预览和成品，保留错误前的警告日志。
第 2 步。 在副本建立与模型及其 VAE 配套的官方或已知可运行基线。只有当该工作流允许省略时，才暂时移除 LoRA、ControlNet、IPAdapter 或精度覆盖；保留必需组件，一次只改一个设置。
第 3 步。 固定 seed 与尺寸，一次恢复一个分支；如果日志出现 NaN/invalid cast，记录第一次出现的位置，不在保存阶段强行替换像素掩盖问题。
第 4 步。 只有模型和节点文档明确允许时才调整 VAE/attention 精度，随后检查内存开销；不能保证 fp32 总能解决黑图。
如何判断处理有效
保存结果可正常读取，像素内容合理，重复最小任务稳定；视觉正常和没有数值警告应共同检查。
注意事项与尚未确认的部分
不存在由黑图外观直接判定唯一原因的通用表。不要因为一个历史 GPU 个案就对所有平台套用其启动参数。
资料复核日期：2026-09-26。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。
原始资料
- I18 · Black images with invalid cast warning。个案，核对：2026-09-26；原始日期：2023-09-02。
- D11 · Text-to-image workflow。核对：2026-09-26。
- D03 · ComfyUI model troubleshooting。核对：2026-09-26。
相关排查与操作
排查下一个可能的原因
同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。
- 采样完成后 VAE 解码爆显存：把解码负载单独检查
VAEDecode采样进度已经结束，但 VAE Decode 或视频解码节点失败，导致没有最终图片或视频。这与采样开始就显存不足不同：已经生成的 latent 仍需要进一步转换为像素。 - Float / Half / BFloat16 不一致：沿调用栈定位失败运算
mat1 and mat2 must have the same dtypedtype 错误不同于矩阵尺寸或设备错误。先看调用栈和不兼容的运算输入；仅凭 KSampler 报错不能判定是哪一组件造成了类型不一致。 - 更新或安装扩展后白屏：分开检查浏览器与 Python 后端
Failed to fetch dynamically imported module浏览器打不开正常画布、控件消失或白屏，但后端终端可能仍在运行。需要区别静态资源加载失败、前端扩展冲突和后端根本没启动，不能看到白屏就重装所有模型。
这篇内容对你有帮助吗？
匿名统计，只记录“有/没有帮助”的计数，不记录账号、IP 地址或设备信息。
资料来源
2026-09-26 复核 ComfyUI 官方流程、模型排查与个案 #1402。NaN 仅作诊断检索词，不是该报告实际日志；本站未运行工作流或 GPU。
01Black images with invalid cast warning资料核对: 2026-09-2602Text-to-image workflow资料核对: 2026-09-2603ComfyUI model troubleshooting资料核对: 2026-09-26