トラブルシューティング

ログ内のキーワード: No module named av

PyAV、そのリンク先ライブラリ、外部の FFmpeg 実行ファイルを別々の依存関係として確認してください。

ログ内のキーワード: Descriptors cannot be created directly

古い生成済み Python メッセージコードは、実行時ライブラリと競合する場合があります。環境内の Protobuf 利用パッケージをすべて変更する前に、そのコードを含むパッケージを特定してください。

ログ内のキーワード: Prompt has no outputs

ローダーや中間計算だけのグラフでは、実行する出力が指定されているとは限りません。見た目で一番右にあるノードではなく、有効な結果の出力先を特定してください。

ログ内のキーワード: Address already in use

ComfyUI を繰り返し起動すると、正常に動作している既存のインスタンスと競合することがあります。ポートの競合は、すべての Python プロセスを終了してよい理由にはなりません。

ログ内のキーワード: ResolutionImpossible

依存関係の解決失敗は、pip が要求された制約を満たせなかったことを意味します。再試行する前に、実際の競合と、遅いバックトラッキング、タイムアウト、証明書の失敗を切り分けます。

ログ内のキーワード: No matching distribution found

pip は要求されたパッケージとバージョン、Python、OS、アーキテクチャ、設定済みのインデックスに対応する候補を必要とします。候補がないからといって、プロジェクト自体が存在しないとは限りません。

ログ内のキーワード: CERTIFICATE_VERIFY_FAILED

HTTPS 検証を回避する前に、証明書検証に失敗したホスト名、証明書チェーン、実行中の Python を特定します。

ログ内のキーワード: No module named cv2

不足モジュールやネイティブライブラリの読み込みを調べる前に、インストール済みの OpenCV の種類を特定します。

ログ内のキーワード: No module named onnxruntime

パッケージの検出、ランタイムプロバイダー、モデルを実際に実行するセッションを切り分けます。

ログ内のキーワード: No module named 'nvvfx'

インポート元は、ノード固有のラッパーかネイティブ SDK バインディングかもしれません。ログの一行だけでは、パッケージインデックス上に信頼でき互換性のある配布パッケージがあるとは判断できません。

ログ内のキーワード: No module named nunchaku

wheel のタグを確認し、ComfyUI 拡張機能、ネイティブライブラリ、モデルを分けて調べます。

ログ内のキーワード: invalid_input_type

変換の失敗と、現在のノードの範囲外の値では、確認すべき点が異なります。ノードのコードを変更したり数値を切り詰めたりする前に、送信した値を確認します。

ログ内のキーワード: MPS backend out of memory

Apple シリコンでは、アプリケーション、ブラウザー、モデルの重み、テンソルがメモリ資源を共有します。搭載メモリの全量を一つの生成タスクで使えるわけではありません。

ログ内のキーワード: Float8_e4m3fn

重みの読み込み、逆量子化、演算のどの段階で失敗するかを特定します。ファイルに FP8 と記載されているだけでは、考えられる量子化の実行経路すべてを説明できません。

ログ内のキーワード: No module named mmcv

フル版と lite 版の配布パッケージ、ソースビルド時の失敗、実行時の拡張機能の読み込みを区別します。

ログ内のキーワード: mediapipe

インストール時に依存関係の解決で失敗する場合と、インストール完了後に拡張機能の読み込みで失敗する場合があります。すべてのリリースに過去の制約を適用せず、実際の MediaPipe 配布パッケージを確認します。

ログ内のキーワード: Overlapped Object has pending operation at deallocation

関連する Windows asyncio／Manager の障害と完全な traceback が一致する場合に限り、この方法を使います。イベントループのエラーは、それ以前のネットワーク例外に続いて発生することもあります。

ログ内のキーワード: This action is not allowed with this security level configuration

インストールやコマンドがブロックされても、破損ではなく意図的なポリシー適用の場合があります。拒否された操作と、その変更を許可されている人を確認します。

ログ内のキーワード: ComfyUI-Manager

Comfy Desktop、新しい Manager インターフェース、従来のインストールでは、Manager の表示場所やインストール方法が異なる場合があります。

ログ内のキーワード: Failed to get custom node list

レジストリからの取得、検索フィルター、インストール済みコード、Python のインポートを区別します。

ログ内のキーワード: lora key not loaded

選択可能な LoRA でも互換性のないモデルを対象としている場合や、ワークフローが変更後の出力を迂回している場合があります。目に見える変化が小さいことは観察結果であり、ファイルが破損している証拠ではありません。

ログ内のキーワード: No module named llama_cpp

コンパイラーエラーやモデルエラーをインポート不足と判断する前に、配布パッケージとバックエンドを確認します。

ログ内のキーワード: Return type mismatch between linked nodes

IMAGE、LATENT、MODEL、CONDITIONING はそれぞれ役割が異なります。接続線を引けることやソケットの色が似ていることだけでは、インターフェースが有効だとは判断できません。

ログ内のキーワード: No module named 'pytorch_lightning'

プロジェクトやリビジョンによって、異なる名前空間を使う場合があります。どちらかの配布パッケージをインストールしても、すべての利用側で十分とは限りません。また、チェックポイントのエラーは単なるパッケージ不足ではありません。