萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

C# 呼叫非受控 DLL 兩大常見錯誤與解決方案 (平台不符、缺少 VC++ Runtime)

前言

透過 P/Invoke (`DllImport`) 呼叫 C/C++ 撰寫的非受控 DLL 時,最常遇到兩個執行時例外:

  1. BadImageFormatException:「嘗試載入格式不正確的程式」—— 平台架構不匹配 (x86 vs x64)。
  2. DllNotFoundException:「無法載入 DLL,找不到指定的模組」—— 相依的 VC++ Runtime 未安裝或路徑錯誤。

本文詳細說明成因與解決步驟。

錯誤一:BadImageFormatException — 平台不匹配

成因

  • C# 專案預設 **Any CPU**,在 64 位元 OS 執行時會以 64 位元進程載入。
  • 非受控 DLL 多為 **x86 (32-bit)** 編譯,64 位元進程無法載入 32 位元 DLL。

解決:強制 C# 專案以 x86 執行

  1. 專案右鍵 → **Properties** → **Build**。
  2. 取消勾選 **Prefer 32-bit** (若勾選則強制 32-bit,但 Any CPU 仍可能在 64-bit 系統以 64-bit 跑)。
  3. **明確勾選 Platform target: x86** (或 x64,若 DLL 為 64-bit)。
  4. 或在 `.csproj` 直接設定:<PlatformTarget>x86</PlatformTarget>。

VS Build 設定 x86

錯誤二:DllNotFoundException — 缺少 VC++ Runtime (CRT)

成因

  • C/C++ DLL 以 **動態連結** (`/MD` 或 `/MDd`) 建置,執行時需對應版本的 Visual C++ Redistributable (如 `msvcr120.dll`、`vcruntime140.dll`)。
  • 開發機已安裝 Visual Studio 故正常,部署到乾淨機器即失敗。
  • 錯誤訊息常誤導為「找不到 DLL」,實際是找不到 **DLL 的相依項**。

方案 A:安裝對應版本 VC++ Redistributable (推薦)

  • Visual Studio 2015-2022 共用 **VC++ 2015-2022 Redistributable** (x86/x64/ARM64)。
  • 安裝程式可整合在安裝精靈 (WiX、InstallShield、Inno Setup) 中作為必要條件。

方案 B:靜態連結 CRT (免安裝 Runtime)

在 C/C++ 專案屬性 → **C/C++ → Code Generation → Runtime Library**:

  • Release:`/MT` (Multi-threaded, Static)
  • Debug:`/MTd` (Multi-threaded Debug, Static)

優點:不需額外 DLL。缺點:執行檔體積變大、無法跨 DLL 共用 CRT 狀態 (如 `errno`、檔案控制代碼、靜態變數),**多個 DLL 皆靜態連結時極易出錯**,**不建議**用於插件架構。

方案 C:本地部署必要 DLL (臨時/可攜式)

將以下檔案放在 **與 C# .exe 同目錄** 或 **DLL 同目錄** (Windows 搜尋順序優先):

  • VS2015-2022: `vcruntime140.dll`、`msvcp140.dll`、`concrt140.dll` (若用併發)、`vccorlib140.dll` (若用 C++/CX)。
  • Debug 版需 `vcruntime140d.dll` 等 (僅限內部測試,**不可**散布 Debug DLL)。

可從 `C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Redist\MSVC\\x86\Microsoft.VC14x.CRT` 複製。

偵錯技巧:使用 Dependencies (Dependency Walker 現代版)

  1. 下載 Dependencies GUI (GitHub: lucasg/Dependencies)。
  2. 拖入目標非受控 DLL,紅色節點即為缺失的相依項。
  3. 確認架構 (x86/x64) 是否一致。

總結檢查清單

檢查項目正確做法
C# 專案 Platform Target明確設 x86 或 x64,與非受控 DLL 一致
非受控 DLL 建置配置Release 版 `/MD`,部署機安裝對應 VC++ Redist
DLL 搜尋路徑同目錄、系統目錄、PATH 環境變數;或用 `SetDllDirectory` / `AddDllDirectory` 指定
呼叫慣例Win32 API 預設 `StdCall` (C# `CallingConvention.StdCall`),C++ DLL 若未加 `__stdcall` 需改 `Cdecl`
字串編碼`CharSet.Auto` + `string` (In) / `StringBuilder` (Out)
copyright © 萬盛學電腦網 all rights reserved