萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

IIS 部署報錯「試圖載入格式不正確的程式集」完整解決方案

錯誤現象

將 ASP.NET / WCF 專案發布至 IIS (64 位元作業系統) 後運行報錯:

試圖載入格式不正確的程式集 (BadImageFormatException)。

根因分析

位元數不匹配:應用程式編譯目標為 **x86 (32 位元)** 或 **Any CPU (Prefer 32-bit 勾選)**,但 IIS 應用程式集區預設以 **64 位元模式** 運行,導致 32 位元組件無法在 64 位元進程中載入。

兩大解決方案

方案一:啟用應用程式集區 32 位元相容模式 (推薦、無需重裝 IIS)

  1. 開啟 IIS 管理器 (inetmgr)。
  2. 左側連線面板選中 應用程式集區。
  3. 右鍵目標應用程式集區 (如 DefaultAppPool 或專案專用集區) → 進階設定。
  4. 找到 啟用 32 位元應用程式 → 設為 True。
  5. 點擊確定,集區自動回收,應用程式重新以 32 位元模式載入。
    啟用 32 位元應用程式設定

方案二:註冊 32 位元 ASP.NET (僅限舊版/特殊需求,不推薦)

將 IIS 核心切換為 32 位元模式,**影響全機器所有應用程式集區**。

# 1. 解除註冊 64 位元 ASP.NET
%windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -u

# 2. 註冊 32 位元 ASP.NET
%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i

⚠️ 此操作會導致同一台伺服器上**無法同時運行 64 位元與 32 位元應用**,現代環境極不推薦。

後續常見衍生錯誤:無法寫入 Temporary ASP.NET Files

啟用 32 位元模式後,若出現:

無法寫入 Temporary ASP.NET Files

解決:

  1. 檢查目錄是否存在:%windir%\Microsoft.NET\Framework64\v4.0.30319\Temporary ASP.NET Files (64 位元) 與 Framework\v4.0.30319\Temporary ASP.NET Files (32 位元)。
  2. 若不存在,**手動建立**對應 32 位元框架目錄下的 Temporary ASP.NET Files 資料夾。
  3. 授予 IIS 應用程式集區身分識別 (預設 IIS AppPool\) 或 IIS_IUSRS 群組對該資料夾的 **讀寫/修改** 權限。

現代最佳實踐:編譯目標 Any CPU + 取消 Prefer 32-bit

**優勢:** 單一建構產物同時支援 32/64 位元 IIS,無需配置集區相容模式,效能最佳 (64 位元更大記憶體空間、更多暫存器)。

總結

「格式不正確的程式集」99% 是 **32 位元組件跑在 64 位元 IIS 集區**。**首選方案:應用程式集區進階設定 → 啟用 32 位元應用程式 = True**。長遠規劃請遷移至 .NET Core/.NET 5+ 並編譯為 64 位元原生,徹底告別位元數地獄。

copyright © 萬盛學電腦網 all rights reserved
專案類型建議設定
.NET Framework (舊版 csproj)Build → 勾選 Prefer 32-bit → **取消勾選** (或明確 Target Platform = x64)
.NET Core / .NET 5+ (SDK-style csproj)預設即為跨平台,無 32/64 位元問題,RuntimeIdentifier 控制發布架構