解決 IIS 7 部署 .NET 應用程式「BadImageFormatException」錯誤

錯誤現象

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

典型場景：64 位元作業系統（Win7/Server 2008 R2+）部署 32 位元編譯的 .NET 應用程式至 IIS 7/7.5/8.x。

根本原因

應用程式集合區預設以 64 位元模式執行，嘗試載入 32 位元組件（或呼叫 32 位元非託管 DLL），導致位元寬度不匹配。

兩種解決方案

方案一：專案層面——編譯目標平台設為「Any CPU」並勾選「Prefer 32-bit」

1. Visual Studio 專案屬性 → Build
2. Target platform: Any CPU
3. ☑ Prefer 32-bit（.NET 4.5+）
4. 重新建置部署

優點：單一建構輸出可在 32/64 位元環境正確執行，無需調整 IIS 設定。

方案二：伺服器層面——啟用應用程式集合區「啟用 32 位元應用程式」

1. IIS 管理員 → Application Pools
2. 右鍵目標集合區 → Advanced Settings
3. Enable 32-Bit Applications = True
4. 回收集合區生效

優點：不修改程式碼即可相容舊版 32 位元組件；缺點：該集合區內所有應用強制 32 位元模式，可能影響 64 位元原生應用效能。

進階排查：組件繫結失敗日誌

若上述方案無效，啟用 Fusion Log：

reg add HKLM\Software\Microsoft\Fusion /v EnableLog /t REG_DWORD /d 1
reg add HKLM\Software\Microsoft\Fusion /v LogFailures /t REG_DWORD /d 1
reg add HKLM\Software\Microsoft\Fusion /v LogPath /t REG_SZ /d C:\FusionLogs\

重現錯誤後查看 C:\FusionLogs\ 詳細繫結失敗堆疊，精準定位缺失組件與版本衝突。

最佳實務建議

結語

「BadImageFormatException」本質是位元寬度不匹配。優先從編譯端解決（Any CPU），次之隔離集合區（Enable 32-Bit），避免全站降級為 32 位元模式。配合 Fusion Log 可快速定位深層相依性地雷。