ComfyUI よくある問題と迅速な修復方法

ComfyUI に関連するエラー（起動失敗、再接続ループ、読み込みタイムアウトなど）が発生した場合は、ここからトラブルシューティングを始めてください。本ページはよくある故障の総合案内ページです。

特定のカスタムノードのインストールや依存関係の競合などでサーバーがクラッシュし続ける場合は、コマンドを乱発する前に以下の専用ガイドへ進んでください：

• ComfyUI プラグインのインポート失敗を修復する
• ComfyUI の起動失敗を診断して復旧する
• ComfyUI の依存関係競合を解決する
• ComfyUI の再接続エラーを修復する

原因別の対応ナビゲーション

インストールと起動の問題

「CUDA is not available」または「Torch not compiled with CUDA」

原因： PyTorch が CPU 専用版に上書きされてインストールされたか、NVIDIA ドライバの CUDA バージョンと不一致を起こしています。

修復方法：

1. 端末で nvidia-smi を実行し、NVIDIA ドライバが正常に機能しているか確認します。
2. ComfyUI を起動する Python 環境で以下を実行し、CUDA が検出できるかテストします：

python -c "import torch; print(torch.__version__); print(torch.version.cuda); print(torch.cuda.is_available())"

3. ポータブル版を使用している場合、NVIDIA GPU バリアントをダウンロードしていることを確認し、run_nvidia_gpu.bat で実行してください。
4. 出力が False の場合は、Torch not compiled with CUDA enabled 修復ガイド に従い再セットアップしてください。

セキュリティソフトや Windows Defender によるブロック

原因： セキュリティソフトが誤認識によって ComfyUI のバッチファイルや Python 実行ファイルを隔離・ブロックしています。

修復方法：

1. ComfyUI のインストールフォルダをセキュリティソフトの「除外リスト」に登録します。
2. Windows Defender の場合：設定 → 更新とセキュリティ → Windows セキュリティ → ウイルスと脅威の防止 → 設定の管理 → 除外の追加または削除
3. 隔離されたファイルがある場合は復元します。

Windows の最大パス長制限（260文字）

原因： Windows の標準仕様により、カスタムノードフォルダのネストが深すぎるとパスの長さが 260 文字を超えてロードエラーになります。

修復方法： Windows の長パスサポートを有効にします。 PowerShell を管理者権限で開き、以下を実行します：

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

その後、PC を再起動してください。また、ComfyUI は D:\ComfyUI などのなるべく浅いパスにインストールしてください。

実行時の問題

CUDA メモリ不足（Out of Memory / OOM）

原因： グラフィックカードの VRAM 容量に対して、画像解像度が高すぎるか、モデルサイズが大きすぎます。

修復方法：

1. ブラウザのタブやゲームなど、GPU を消費する他のアプリを完全に閉じます。
2. 出力解像度を下げます（例：1024x1024 から 512x512 へ）。
3. 起動用バッチファイル（bat）に --lowvram を追記して実行します。
4. メモリ消費の少ない GGUF 量化モデル（Flux GGUF 等）を使用します。

ワークフローの赤いノード

原因： ロードしたワークフローで使われているカスタムノードが、お使いの環境にインストールされていません。

修復方法：

1. ComfyUI Manager をインストールします。
2. Manager を開き、「Install Missing Custom Nodes」をクリックして自動で不足ノードをインストールします。
3. ComfyUI を完全に再起動します。

「No checkpoint found」 / モデルの一覧が空

原因： モデルフォルダに適切なウェイトファイル（.safetensors）が入っていないか、置く場所を間違えています。

修復方法：

1. 使用したいモデルをダウンロードします。
2. .safetensors ファイルを ComfyUI/models/checkpoints/ ディレクトリに配置します。
3. WebUI のモデル選択欄の横にある「Refresh」を押すか、ComfyUI を再起動します。

※ 各種モデル（LoRA, VAE, ControlNet, GGUF）の正確な配置場所については ComfyUI 中 Safetensors 文件应放在哪里 を参照してください。

生成速度が極めて遅い（CPU 動作）

原因： PyTorch が GPU を認識できず、CPU で画像生成を行っています。

修復方法：

1. 起動時のコンソールを確認し、ご利用のグラフィックボード（NVIDIA GeForce ...）の名前が表示されているか確認します。
2. ポータブル版の場合、必ず run_nvidia_gpu.bat から起動しているか確認します。
3. 手動インストールの場合、CUDA 対応の Torch が有効かテストします：

python -c "import torch; print(torch.cuda.is_available())"

これが False になる場合は、CUDA 対応版の PyTorch を再インストールしてください。

関連ガイド

• 修复损坏的 ComfyUI 便携版依赖而不重装 Torch
• 如何修复 ComfyUI 插件导入失败错误
• ComfyUI 依赖冲突
• 安全安装自定义节点
• ComfyUI 中 Safetensors 文件的存放位置