「無法載入檔案或組件...嘗試載入格式不正確的程式」完整排查指南：x86/x64/Any CPU 平台不匹配解決方案

錯誤訊號

System.BadImageFormatException: 無法載入檔案或組件 "XXX" 或其相依性之一。
嘗試載入格式不正確的程式。

核心原因：**進程位元數（32/64-bit）與被載入組件的目標平台不一致**。

快速對照表：專案建置目標 vs. 執行環境

Visual Studio 設定步驟

1. 專案右鍵 → Properties → Build 分頁。
2. 取消勾選 Prefer 32-bit（若目標為 64-bit 進程）。
3. Platform target 選擇：
   • Any CPU（未勾 Prefer 32-bit）→ 64-bit OS 上跑 64-bit，32-bit OS 上跑 32-bit。
   • x86 → 強制 32-bit，適合需載入 32-bit COM/.native DLL 的情境。
   • x64 → 強制 64-bit，較少用（除非明確需 64-bit 指令集）。

常見情境與對策

情境一：參考 32-bit 唯獨 DLL（Oracle Client、舊版 COM、C++ SDK）

現象：64-bit IIS 載入失敗。

方案 A（推薦）：專案設為 x86，整個進程以 32-bit 執行。

方案 B：IIS 應用程式集區 → Advanced Settings → Enable 32-Bit Applications = True，專案維持 Any CPU (Prefer 32-bit)。

情境二：專案標記 Any CPU (Prefer 32-bit)，但在 64-bit IIS 上報錯

原因：Prefer 32-bit 勾選時，Any CPU 會在 64-bit OS 上以 **32-bit** JIT，但若 IIS 集區 Enable 32-Bit Applications = False，進程為 64-bit，載入 32-bit 組件失敗。

修正：取消勾選 Prefer 32-bit，或開啟集區 32-bit 相容模式。

情境三：依賴 64-bit 原生庫（如某些高效能數學庫、x64 專用驅動）

專案必須設為 x64 或 Any CPU (Prefer 32-bit = false)，且 IIS 集區 Enable 32-Bit Applications = False。

診斷工具：CorFlags.exe

CorFlags.exe MyAssembly.dll
// 輸出範例
Version   : v4.0.30319
CLR Header: 4.0
PE        : PE32
CorFlags  : 0x3
ILONLY    : 1
32BITREQ  : 1   ← 1 表示強制 32-bit (x86)
32BITPREF : 0   ← 1 表示 Prefer 32-bit
Signed    : 0

• 32BITREQ=1 → x86
• 32BITREQ=0, 32BITPREF=1 → Any CPU (Prefer 32-bit)
• 32BITREQ=0, 32BITPREF=0, PE=PE32+ → x64

進階：側邊載入與 probing privatePath

若專案採用插件架構，不同插件可能針對不同平台編譯。建議：

• 主程式編譯為 Any CPU (Prefer 32-bit = false)。
• 32-bit 插件放入 bin\x86\，64-bit 插件放入 bin\x64\。
• App.config 設定 <probing privatePath="x86;x64" />，執行時由 CLR 依進程位元數自動載入正確資料夾。

總結檢查清單

1. 確認目標伺服器 OS 位元數。
2. 確認 IIS 應用程式集區 Enable 32-Bit Applications 設定。
3. 確認專案 Platform target 與 Prefer 32-bit 組合。
4. 若引用第三方原生 DLL，用 CorFlags 或 dumpbin /headers 驗證其位元數。
5. 所有專案在方案層級統一 Configuration Manager 平台設定，避免混合。

依循上述原則，即可徹底根治 BadImageFormatException，實現跨平台穩定部署。