画像が黒い・色が無効：サンプリング、VAE、表示の失敗を切り分ける
黒い画像の原因を調べる前に、保存した画像とプレビューを比較します。黒いプレビューと、出力ピクセルが実際に無効であることは別の観察結果です。
症状と対象範囲
黒い画像の原因を調べる前に、保存した画像とプレビューを比較します。黒いプレビューと、出力ピクセルが実際に無効であることは別の観察結果です。
検索語と警告の例です。1 件の報告ですべてのエラーが確認されたわけではなく、引用した issue に出ているのは無効な型変換の警告だけです。
invalid value encountered in cast
black image
NaN
出典から確認できること
ComfyUI 公式の基本ワークフローでは、サンプリング、VAE デコード、保存が別の段階として扱われています。過去の issue #1402 には黒い出力と無効な型変換の警告が含まれますが、報告者は当初の VAE 精度に関する仮説を取り消しており、原因が確定したわけではありません。出典 1（英語） 出典 2（英語） 出典 3（英語）
区別すべき状況
1. 保存したピクセルは有効で、フロントエンドのプレビューまたは表示だけに問題がある。
2. サンプリングやデコードで非有限値、精度の問題、コンポーネントの不一致が生じ、保存時に表面化する。
3. 入力、マスク、強いアダプター、または特定のパラメーターの組み合わせについて、最小限の条件で比較する必要がある。
確認手順
以下は引用した資料に基づく編集上の手順です。あなたの環境で原因が確定したことを意味しません。
手順 1. 保存した画像を別の信頼できるビューアーで開き、失敗前に出た警告を保存します。
手順 2. コピー上で、モデルと対応する VAE に合った公式または正常に動作する既知の構成を基準にします。ワークフローで任意の LoRA、ControlNet、IP-Adapter、精度の上書きだけを省き、必須のコンポーネントは残します。設定は一度に一つずつ変更します。
手順 3. シードと解像度を固定し、分岐を一つずつ戻します。保存時にピクセルを置き換えて警告を隠すのではなく、最初に NaN または無効な型変換が発生した段階を記録します。
手順 4. モデルやノードのドキュメントで許可されている場合に限り、VAE またはアテンションの精度を変更し、メモリへの影響を確認します。
完了の確認
保存した出力を問題なく読み取れて、妥当な見た目になり、最小限のタスクを繰り返し実行しても安定することを確認します。数値に関する警告も確認してください。
制限と注意点
見た目だけでは原因を一つに特定できず、fp32 で必ず直るとも限りません。過去の特定 GPU 向けの回避策を、あらゆるプラットフォームに一般化しないでください。
参照した原文資料
- 無効な型変換の警告を伴う黒い画像（英語）（確認日：2026-09-26、個別の報告）
- Text-to-image ワークフロー（英語）（確認日：2026-09-26）
- ComfyUI のモデルに関するトラブルシューティング（英語）（確認日：2026-09-26）
出典の確認日は 2026-09-26 です。ワークフローの実行、GPU の実行、最低メモリ量の測定、実行時の動作保証は行っていません。
関連するトラブルシューティング記事とガイド
次に考えられる原因を確認
同じ症状にも異なる原因があります。関連する記事を順に確認してください。
- サンプリング完了後に VAE がメモリ不足になる：デコードを分けて診断する
VAEDecodeサンプリングが完了しても、潜在画像をピクセルにデコードする処理が残っています。そのため、サンプリング開始時のメモリ不足とは分けて考える必要があります。 - Float、Half、BFloat16 の不一致：失敗した操作を追跡する
mat1 and mat2 must have the same dtypedtype の失敗は、形状やデバイスの失敗とは異なります。traceback と互換性のないオペランド型から調べます。KSampler のエラーだけでは、原因となったコンポーネントを特定できません。 - 拡張機能の更新後に ComfyUI の画面が真っ白になる：フロントエンドとバックエンドの問題を切り分ける
Failed to fetch dynamically imported modulePython サーバーは動作中でも、キャンバスが表示されないことがあります。関係のないモデルを再インストールする前に、静的アセット、JavaScript 拡張機能、バックエンドが利用できない状態を区別します。
この記事は役に立ちましたか？
匿名です。はい・いいえの件数のみ保存し、アカウント、IP アドレス、端末情報は保存しません。
出典と参考資料
ComfyUI 公式のワークフロー／モデルのガイダンスと個別 issue #1402 を、2026-09-26 に再確認しました。NaN は診断用の検索語であり、その報告で観察されたログではありません。ワークフローや GPU の実行は行っていません。
01無効な型変換の警告を伴う黒い画像（英語）出典の確認日: 2026-09-2602Text-to-image ワークフロー（英語）出典の確認日: 2026-09-2603ComfyUI のモデルに関するトラブルシューティング（英語）出典の確認日: 2026-09-26