QGIS DLL load failed while importing _C 錯誤修正
發布於 更新於
ImportError: DLL load failed while importing _C 表示 Windows 找到了 PyTorch,接著卻拒絕載入其底層某個編譯 DLL。當外掛將 torch 安裝到 QGIS 的 Python 時,您可能會在 QGIS 遇到這個錯誤,我們的外掛也一樣。安裝 Microsoft Visual C++ Redistributable (x64),然後重新啟動 Windows:大多數電腦這樣就能清除錯誤。
Traceback (most recent call last):
File "C:\...\site-packages\torch\__init__.py", line 141, in <module>
raise err
OSError: [WinError 126] The specified module could not be found.
Error loading "C:\...\site-packages\torch\lib\fbgemm.dll" or one of its dependencies.
ImportError: DLL load failed while importing _C: The specified module could not be found.
同一個故障在某些電腦上會指出不同檔案,但下列修正方式相同:
Error loading "C:\...\site-packages\torch\lib\shm.dll" or one of its dependencies.
適用於 Windows 10 和 11、QGIS 3.22 及後續版本,以及 PyTorch 2.4.0 到 2.8.0,亦即隨附 fbgemm.dll 的 Windows wheels。2.9.0 版本移除了該檔案。
如果您的錯誤顯示 [WinError 127] 而不是 126,請先停在這裡。這表示 DLL 已載入,但其中缺少某個符號,原因是套件之間的版本不相容,不是本文所述的錯誤。
快速修正
安裝 Visual C++ Redistributable (x64)
執行 aka.ms/vc14/vc_redist.x64.exe 中的
vc_redist.x64.exe。即使您已經安裝 x86,也要選擇 x64。兩者是分開的套件,而 torch 需要 x64。重新啟動 Windows
這裡需要的是重新啟動電腦,不是重新啟動 QGIS。安裝程式會把部分工作留到重新啟動時完成。
檢查是否有第二個 Python
在命令提示字元中執行
where python。如果顯示多個結果,表示 Anaconda、Miniconda 或獨立安裝的 Python 正在與 QGIS 使用的 Python 競爭。從 PATH 移除該 Python
開啟「開始」,搜尋「環境變數」,選取「編輯系統環境變數」,接著選取「環境變數」、「Path」。刪除您不在 QGIS 中使用的 Python 所對應的項目,然後登出 Windows 再重新登入。
如果錯誤沒有變化,請前往修正 2。
確認是否已修正
從「開始」選單的 QGIS 資料夾開啟 OSGeo4W Shell,然後執行:
python -c "import torch; print(torch.__version__)"
如果單獨一行顯示版本號,且上方沒有 traceback,表示 DLL 已成功載入。現在到真正需要使用它的地方重複測試:在 QGIS 中依序選取「外掛程式」→「Python 主控台」,然後執行 import torch。如果那裡顯示安靜的提示字元,就是您要的結果。如果兩個測試只有一個成功,表示它們使用的是不同的 Python,請回到第 3 步。
修正 2:fbgemm.dll 的相依項遺失
有些電腦已安裝 Redistributable,仍然缺少 libomp140.x86_64.dll。可長期採用的修正方式是升級到 PyTorch 2.9.0 或後續版本,該版本完全不再隨附 fbgemm.dll。如果您必須固定使用較舊版本,PyTorch tracker 上的使用者回報,將隨免費 Visual Studio Community 一起提供的 libomp140.x86_64.dll 複製進來後,就能正常執行。這只是使用者的因應做法,絕不是維護者修正,而且沒有任何 PyTorch wheel 會隨附這個檔案。不要從下載網站取得散裝 DLL。
如果錯誤沒有變化,請前往修正 3。
修正 3:wheel 與電腦不相容
在沒有相符 NVIDIA 驅動程式的電腦上,CUDA build 會在同一行失敗。如果沒有 NVIDIA GPU,請強制使用 CPU build:
pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cpu
如果有 GPU,請使用 PyTorch 安裝頁面針對您的 CUDA 版本提供的指令。在 conda 環境中,請使用 conda 而不是 pip 安裝 torch,讓執行階段函式庫與套件來自同一個位置。
如果錯誤沒有變化,請前往修正 4。
修正 4:防毒軟體在安裝後移除了檔案
開啟「Windows 安全性」,接著依序選取「病毒與威脅防護」、「保護歷程記錄」。還原它從您的 site-packages 資料夾中移除的任何檔案,將該資料夾加入排除項目,然後重新安裝 torch。安裝畫面顯示成功,資料夾看起來也仍然完整,因此畫面上不會直接指出這個原因。
如果錯誤沒有變化,請前往下方的「仍然無法修正?」。
為什麼會發生
PyTorch 提供的是編譯過的 DLL,而不是純 Python。fbgemm.dll 以及 torch/lib 中的相鄰檔案都連結到 Microsoft C runtime,而當 Windows 找不到某個 DLL 自己的相依項時,就會拒絕載入該 DLL。它會在相依鏈最上方的 _C 報告失敗。_C 是負責執行 import 的 torch extension module,因此錯誤訊息才會指出一個明明就在磁碟上的檔案。
第二個原因是 Python 3.8。從該版本開始,只會搜尋 system paths、存放 DLL 或 PYD 檔案的目錄,以及透過 add_dll_directory() 加入的目錄。PATH 和目前工作目錄完全不再使用。因此,同時安裝 Anaconda 和 QGIS 的電腦,可能會將錯誤 Python 的 torch/lib 交給載入器,而錯誤訊息不會告訴您它選中了哪一個。請從 QGIS 自己在「開始」選單中的捷徑啟動 QGIS,不要從曾經執行過 conda activate 的 shell 啟動。
仍然無法修正?
AI Segmentation 是我們提供的、會將 PyTorch 安裝到 QGIS 的 Python 的外掛,因此它最可能讓您遇到這個錯誤。它的雲端模式會在我們的伺服器上執行模型,不需要本機 torch,但這不會替任何其他需要 torch 的外掛修復 torch。請將 QGIS 版本、完整 traceback 以及外掛版本寄到 。我們會告訴您屬於四種修正方式中的哪一種。
常見問題
_C 是負責執行 import 的 torch extension module,因此位於相依鏈最上方,Windows 會在那裡報告失敗。上一行指出的檔案 fbgemm.dll 或 shm.dll 通常確實存在於磁碟上。缺少的是該檔案所依賴的項目。
2.4.0 到 2.8.0 的 Windows wheels 都隨附 fbgemm.dll。2.9.0 版本移除了它,因此升級可以排除這個特定錯誤。_C 的錯誤訊息仍可能因其他原因出現,例如在沒有相符 driver 的電腦上使用 CUDA build。
126 表示 Windows 找不到該 module 或其相依項之一,這就是本文所述的錯誤。127 表示 DLL 已載入,但其中缺少某個 symbol,原因是兩個套件之間的版本不相容。上方任何修正方式都無法解決 127。
不可以。請從免費的 Visual Studio Community 安裝中取得。PyTorch tracker 上回報 workaround 的使用者,就是從那裡取得該檔案。下載網站提供的檔案不一定相同,而且任何 PyTorch Windows wheel 都不會隨附這個檔案。
如果您在 GDAL 上遇到相同錯誤訊息,_gdal 版本的這個錯誤有自己的修正方式。想了解 torch 載入後 AI 在 QGIS 中能做什麼,請從 QGIS AI 中心開始。


