萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET eurl.axd HttpException 解決方案:IIS 6.0 多版本共存衝突修復

錯誤現象

System.Web.HttpException: Path '//eurl.axd/' was not found.

在 IIS 6.0 同時啟用 ASP.NET 2.0 與 4.0 時,舊版應用程式可能拋出此異常。

根因分析

  1. ASP.NET 4.0 引入「無副檔名 URL」特性,內部傳遞特殊路由給處理程序
  2. 若網站根目錄配置為 4.0,但虛擬目錄/子應用程式仍運行 2.0
  3. ASP.NET 2.0 無法識別 4.0 注入的 eurl.axd 路徑標記
  4. 2.0 嘗試尋找實體檔案 eurl.axd 失敗,拋出 404/HttpException

三種解決方案(按推薦順序)

方案一:統一應用程式池版本(最徹底)

將所有應用程式遷移至相同 .NET 版本(建議 4.0+),消除版本衝突根源。

  • IIS 管理器 → 應用程式池 → 設定 .NET Framework 版本
  • 需驗證相容性,修正 Breaking Changes

方案二:隔離不同版本應用(架構層面)

將 ASP.NET 2.0 應用移至獨立網站/應用程式池,避免版本混合。

  • 建立新網站 → 指向 2.0 應用程式目錄
  • 指派專用應用程式池(.NET 2.0)
  • 配置獨立域名/端口/主機標頭

方案三:關閉 ASP.NET 4.0 無副檔名 URL 處理(註冊表快速修復)

適用於無法立即重構遷移的緊急情況。

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ASP.NET\4.0.30319.0]
"EnableExtensionlessUrls"=dword:00000000

操作步驟

  1. 開啟 regedit
  2. 導航至 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ASP.NET\4.0.30319.0
  3. 新建 DWORD (32-bit) 值:名稱 EnableExtensionlessUrls,數值 0
  4. 管理員執行 iisreset 重啟 IIS 生效

PowerShell 一鍵執行

Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ASP.NET\4.0.30319.0" `
    -Name "EnableExtensionlessUrls" -Value 0 -Type DWord -Force
iisreset

驗證修復

  • 重現原錯誤頁面,確認不再拋出 eurl.axd 異常
  • 檢查應用程式正常路由功能(MVC/WebForms/Web API)
  • 監控事件檢視器 System/Application 日誌確無新錯誤

副作用與風險

影響範圍說明
ASP.NET 4.0 應用無副檔名 URL(如 /api/users、/home/index)將無法路由,需在 RouteConfig 明確映射或恢復 .aspx/.ashx 後綴
ASP.NET 2.0 應用修復 eurl.axd 錯誤,恢復正常運行
整體架構掩蓋了架構債務,長期仍需統一版本或隔離部署

現代環境補充

IIS 7.0+ (整合管線模式) 已不存在此問題。.NET Core / .NET 5+ 完全獨立於 IIS 管線,透過 Kestrel + 反向代理運行,徹底避免版本衝突。新專案請直接採用現代技術棧。

結語

eurl.axd 錯誤是 IIS 6 時代多版本共存的典型產物。註冊表修復屬「止血」手段,架構隔離為「治本」之道。隨著 Windows Server 2003/IIS 6 進入生命週期終點,建議規劃遷移至支援中的作業系統與 .NET 版本。

copyright © 萬盛學電腦網 all rights reserved