ComfyUI が起動しない時の切り分け

ComfyUI の起動失敗は、ただの「インストールミス」ではなく、前は動いていた環境が後から壊れた ことが原因の方が多いです。

まず分類する

A. Python import failure

例:

• No module named 'sqlalchemy'
• No module named 'cv2'
• No module named 'onnxruntime'

B. コア runtime 漂移

• Torch not compiled with CUDA
• CUDA is not available
• AttributeError: module 'torch' ...

C. プラグイン連鎖故障

• あるノード導入後から起動しなくなった
• 多数の custom node が同時に壊れた

D. helper / bootstrap 異常

• helper executable が消えた
• antivirus がファイルを隔離した

最初に探すべきもの

• 最初の IMPORT FAILED
• 最初の ModuleNotFoundError
• 最初の Torch / CUDA / DLL エラー
• 最初の helper missing

最後の行だけ見て判断しないでください。

修復の原則

• 欠 package ならその package だけ直す
• Torch / CUDA が壊れていたら先にコア runtime を戻す
• helper missing なら再インストール前に隔離や削除を確認する
• 既存モデル、workflow、設定があるなら、まず保存優先

再インストールを最後にする理由

再インストールは簡単そうに見えますが、モデル、workflow、plugin 構成を失いやすいです。 壊れた原因が特定できるなら、最小修復の方が安いです。

関連ページ

• ComfyUI Plugin Import Failed
• Dependency Conflicts
• Common Issues
• Troubleshooting Decision Tree