前言
透過 P/Invoke (`DllImport`) 呼叫 C/C++ 撰寫的非受控 DLL 時,最常遇到兩個執行時例外:
- BadImageFormatException:「嘗試載入格式不正確的程式」—— 平台架構不匹配 (x86 vs x64)。
- DllNotFoundException:「無法載入 DLL,找不到指定的模組」—— 相依的 VC++ Runtime 未安裝或路徑錯誤。
本文詳細說明成因與解決步驟。
錯誤一:BadImageFormatException — 平台不匹配
成因
- C# 專案預設 **Any CPU**,在 64 位元 OS 執行時會以 64 位元進程載入。
- 非受控 DLL 多為 **x86 (32-bit)** 編譯,64 位元進程無法載入 32 位元 DLL。
解決:強制 C# 專案以 x86 執行
- 專案右鍵 → **Properties** → **Build**。
- 取消勾選 **Prefer 32-bit** (若勾選則強制 32-bit,但 Any CPU 仍可能在 64-bit 系統以 64-bit 跑)。
- **明確勾選 Platform target: x86** (或 x64,若 DLL 為 64-bit)。
- 或在 `.csproj` 直接設定:
<PlatformTarget>x86</PlatformTarget>。

錯誤二: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 現代版)
- 下載 Dependencies GUI (GitHub: lucasg/Dependencies)。
- 拖入目標非受控 DLL,紅色節點即為缺失的相依項。
- 確認架構 (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) |