DLL load failed:DLL を個別にダウンロードせず、ネイティブ拡張を特定する
名前が示された Python モジュールは、不足しているか互換性のない別のランタイムライブラリに依存している場合があります。ネイティブ読み込みの失敗は、最上位の Python パッケージが単に存在しない場合とは異なります。
症状と対象範囲
名前が示された Python モジュールは、不足しているか互換性のない別のランタイムライブラリに依存している場合があります。ネイティブ読み込みの失敗は、最上位の Python パッケージが単に存在しない場合とは異なります。
検索の手掛かりとなるエラーの断片です。ID、値、ファイル名は環境によって変わります。
DLL load failed
The specified module could not be found
WinError 126
出典から確認できること
ComfyUI の報告には _fused と custom_rasterizer_kernel の例があり、NumPy と xFormers はバイナリー互換性について説明しています。Windows のエラー 126 は、モジュールが見つからなかったことを示します。このメッセージだけでは、名前が示された拡張機能と、その依存 DLL のどちらが不足しているのかは特定できません。Windows はモジュール名に基づいて依存ファイルを検索するため、検索パス上の別のコピーが影響する場合もあります。これらの資料が裏付けるのは拡張機能ごとの調査であり、どの状況にも当てはまる単一の DLL 不足の答えではありません。Windows のエラーコード(英語) DLL の検索順序(英語) 出典 1(英語) 出典 2(英語) 出典 3(英語) 出典 4(英語)
区別すべき状況
1. Python のアーキテクチャ、Torch、拡張機能の ABI に互換性がない。
2. 必要なランタイムまたはバックエンドがない。または、検索パスで同じ名前の別のライブラリが優先されている。
3. インストールが不完全か、ノードとパッケージの組み合わせがサポートされていない。
確認手順
以下は引用した資料に基づく編集上の手順です。あなたの環境で原因が確定したことを意味しません。
手順 1. 最初に失敗したネイティブモジュールと完全な traceback を保存します。実際に ComfyUI を実行している Python プロセスの実行ファイルのパスとアーキテクチャ、Python・Torch・拡張機能の各バージョン、インストール元を記録します。システムの python は別の環境を指している場合があります。
手順 2. その環境に名前が示された拡張機能ファイルがあるか確認します。信頼できる拡張機能に限り、同じインタープリターを使って環境のコピーで読み込みを試します。読み込みによってパッケージのコードが実行される場合があります。Visual Studio の開発ツールがすでに使える場合は、dumpbin /DEPENDENTS <extension.pyd> で静的にインポートされる DLL 名を一覧表示できますが、Windows が実際にどの依存ファイルを読み込んだかは証明できません。Microsoft DUMPBIN(英語)
手順 3. 特定できた不足依存ファイルや互換性のないバイナリーを、拡張機能の配布元がサポートする wheel、Torch・CUDA の組み合わせ、またはベンダーのランタイムに照らして確認します。サポート対象の配布物を一式、環境のコピーでテストします。関連のないチュートリアルから wheel や DLL を寄せ集めないでください。
手順 4. ソースからビルドする場合は、コンパイラー、SDK、バージョンの前提条件を確認します。それ以外の場合は、既知の環境を復元するか、その拡張機能を使わない方法を選びます。
完了の確認
完全なワークフローに戻る前に、ネイティブモジュールの読み込みと簡単な処理が成功することを確認します。
制限と注意点
DLL ダウンロードサイトから任意のファイルを System32、Python、プロジェクトにコピーしないでください。実際のバージョンの不整合を隠しながら、悪意のあるコードを持ち込む可能性があります。
参照した原文資料
- SageAttention fused の DLL 読み込み失敗(英語)(確認日:2026-09-26)
- custom_rasterizer_kernel の DLL 読み込み失敗(英語)(確認日:2026-09-26)
- NumPy の読み込みエラーに関するトラブルシューティング(英語)(確認日:2026-09-26)
- xFormers README(英語)(確認日:2026-09-26)
- Microsoft Windows のエラーコード(英語)(確認日:2026-09-26)
- Microsoft DLL の検索順序(英語)(確認日:2026-09-26)
- Microsoft DUMPBIN /DEPENDENTS(英語)(確認日:2026-09-26)
出典と英語原文の確認日:2026-09-26。このサイトでは、ネイティブモジュールの読み込み、DLL の調査、GPU 実行を行っていません。実行時の保証もありません。
関連するトラブルシューティング記事とガイド
次に考えられる原因を確認
同じ症状にも異なる原因があります。関連する記事を順に確認してください。
- NumPy の ABI エラー:_ARRAY_API と dtype size changed
_ARRAY_API not foundこれらのメッセージは通常、ワークフローの接続不良ではなく、NumPy とコンパイル済み拡張機能とのインターフェースに関係します。NumPy を変更する前に、最初に関係する拡張機能を特定します。 - xFormers はインストール済みなのに利用できない:ネイティブ拡張と演算子を確認する
xFormers can't load C++/CUDA extensionspip では xFormers がインストール済みと表示されても、C++/CUDA 拡張の読み込みに失敗したり、入力に対応する アテンション演算子がなかったりすることがあります。パッケージの存在と、使用可能な GPU カーネルは別々に確認します。 - SageAttention または Triton のインポート失敗:プラットフォームとビルドの組み合わせを確認する
No module named 'triton'Python モジュールの不足、Triton 依存関係の不足、Windows の _fused DLL 読み込み失敗は、それぞれ異なる層で起こります。すべての依存関係をまとめてアップグレードしても、原因に沿った修復にはなりません。
この記事は役に立ちましたか?
匿名です。はい・いいえの件数のみ保存し、アカウント、IP アドレス、端末情報は保存しません。
出典と参考資料
2026-09-26 に Microsoft の WinError 126、DLL 検索順序、DUMPBIN の資料に加えて、NumPy・xFormers の資料と ComfyUI の 2 件の報告を確認しました。このサイトでは DLL 読み込み、インストール、GPU 実行、修復を行っていません。
01SageAttention fused の DLL 読み込み失敗(英語)出典の確認日: 2026-09-2602custom_rasterizer_kernel の DLL 読み込み失敗(英語)出典の確認日: 2026-09-2603NumPy の読み込みエラーに関するトラブルシューティング(英語)出典の確認日: 2026-09-2604xFormers README(英語)出典の確認日: 2026-09-2605Microsoft Windows のエラーコード(英語)出典の確認日: 2026-09-2606Microsoft DLL の検索順序(英語)出典の確認日: 2026-09-2607Microsoft DUMPBIN /DEPENDENTS(英語)出典の確認日: 2026-09-26