ASP.NET「無法載入檔案或組件 XXX，嘗試載入格式不正確的程式」完整排查與解決方案

錯誤完整訊息

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

此錯誤核心原因：**位元數不匹配**——64 位元進程嘗試載入 32 位元組件，或反之。

典型觸發情境

• 開發機為 64 位元 OS (Win7 x64/Win10 x64)，本機 IIS Express (32 位元) 執行正常
• 部署至 64 位元 IIS，應用程式集區預設「啟用 32 位元應用程式 = False」
• 專案參考了 32 位元原生 DLL (C++ CLI、COM、Oracle Client、Crystal Reports 等)
• 專案目標平台設為 x86 或 Any CPU (Prefer 32-bit)，但 IIS 以 64 位元執行

三大解決方案（依優先序）

方案一：調整 IIS 應用程式集區啟用 32 位元模式（最快、最常用）

1. 開啟 IIS 管理員 → 應用程式集區
2. 右鍵選中網站對應的集區 → 進階設定
3. 找到 「啟用 32 位元應用程式」 → 設為 True
4. 回收應用程式集區或執行 iisreset

原理：強制 w3wp.exe 以 32 位元 (WoW64) 執行，可載入 32 位元相依組件。

方案二：專案明確指定目標平台為 x86（編譯期固定）

1. 專案右鍵 → 屬性 → 建置 分頁
2. 取消勾選 「優先選擇 32 位元」 (Prefer 32-bit)
3. 明確選擇 目標平台: x86
4. 重新建置部署

效果：編譯輸出強制 32 位元 PE 格式，即使 IIS 為 64 位元也會在 WoW64 下執行。

方案三：完整 64 位元化（根治，需所有相依項支援 64 位元）

• 專案目標平台設為 Any CPU，且 取消勾選 Prefer 32-bit
• 所有參考組件 (NuGet 套件、自訂 DLL、原生 DLL) 必須提供 64 位元版本
• IIS 應用程式集區保持 啟用 32 位元 = False (預設)

適用場景：純 .NET 專案、或所有第三方庫已支援 64 位元 (如 Oracle.ManagedDataAccess、Microsoft.Data.SqlClient 等)。

進階診斷技巧

1. 開啟 Fusion 繫結記錄（精確定位失敗組件）

註冊表路徑: HKLM\Software\Microsoft\Fusion
新增 DWORD: EnableLog = 1
新增 DWORD: LogFailures = 1
新增 DWORD: LogResourceBinds = 1
新增 String: LogPath = C:\FusionLogs\ (需預先建立資料夾，且 IIS_IUSRS 有寫入權限)

重現錯誤後，查看 C:\FusionLogs\ 下的 HTML 記錄，即可看到確切失敗的組件名稱、版本、公開金鑰、搜尋路徑。

2. 使用 CorFlags 工具檢查組件位元數

Developer Command Prompt:
corflags YourAssembly.dll

輸出範例:
Version   : v4.0.30319
CLR Header: 2.5
PE        : PE32
CorFlags  : 0x3
ILONLY    : 1
32BITREQ  : 1  <-- 此為 1 表示強制 32 位元
32BITPREF : 0
Signed    : 0

• PE32 + 32BITREQ=1 = 僅 32 位元
• PE32 + 32BITPREF=1 = Any CPU Prefer 32-bit
• PE32+ = 64 位元

3. Process Explorer 即時檢查 w3wp.exe 位元數

Sysinternals Process Explorer → View → Select Columns → Process Image → 勾選 Platform。觀察 IIS 工作進程顯示 32-bit 或 64-bit。

常見相依組件 32/64 位元對照表

決策流程圖

發生 BadImageFormatException
        │
        ▼
是否有 32 位元原生相依項 (C++ DLL, COM, 舊版 Oracle, Jet)？
        │
   ┌────┴────┐
   是        否
   │         │
   ▼         ▼
方案一/二  方案三 (純 .NET 專案)
(最省事)   (最乾淨)

總結

BadImageFormatException 90% 以上為位元數不匹配。優先嘗試「IIS 集區啟用 32 位元」或「專案指定 x86」快速解決；長期專案規劃應評估全面 64 位元化，移除 32 位元相依，獲得更大記憶體空間與效能優勢。

1. 上一篇文章： ASP.NET 整合 Indy TIdFTP 實現 FTP 上傳下載與斷點續傳完整指南
2. 下一篇文章： ASP.NET 使用 ALinq 操作 MySQL：從 ADO.NET 到 LINQ 的完整遷移指南

ASP.NET 基礎

解決 Visual Studio 2015 缺少報表控件 (ReportViewer) 問題

問題現象 VS2015 工具箱中找不到 `ReportVie

ASP.NET Core 整合 KindEditor 實現圖片上傳功能完整教程

KindEditor 是經典的輕量級富文本編輯器，雖然停止更

Visual Studio 2012 + OpenCV 2.4.9 完整安裝配置圖文教程 (含環境變數、屬性頁、測試代碼)

前言 Visual Studio 2012 (VC11) 配

ASP.NET MVC JavaScriptResult 回傳動態腳本實作範例

前言 JavaScriptResult 讓控制器直接回傳可執