ASP.NET 2.0 URL 對應功能完整指南：urlMappings 設定、舊網址轉向、簡化複雜 URL、安全性與相容性考量

ASP.NET 2.0 內建 urlMappings 功能，透過 web.config 宣告式設定將特定 URL 映射至另一目標 URL，無需程式碼、無需 ISAPI Rewrite、無需 HTTP 模組，即可實現舊網址轉向、簡化複雜 URL、隱藏真實頁面結構等需求。

基本語法與設定

<configuration>
  <system.web>
    <urlMappings enabled="true">
      <add url="~/Homepage.aspx" mappedUrl="~/OriginalHome.aspx" />
      <add url="~/Products/Category.aspx" mappedUrl="~/Catalog/Category.aspx" />
      <add url="~/OldPage.aspx" mappedUrl="~/NewPage.aspx" />
    </urlMappings>
  </system.web>
</configuration>

核心屬性

運作機制

1. 使用者請求 https://site/Homepage.aspx。
2. ASP.NET 執行管線早期（HttpApplication.BeginRequest 階段）攔截請求。
3. 比對 urlMappings 集合，找到匹配項。
4. 內部重寫請求路徑為 mappedUrl（OriginalHome.aspx）。
5. 瀏覽器網址列保持 Homepage.aspx，使用者無感知。
6. 目標頁面正常執行生命週期，Request.RawUrl 仍為原始 URL。

四大核心優勢

進階：支援查詢字串傳遞

urlMappings 僅比對路徑部分，查詢字串自動保留並傳遞至目標頁面：

<add url="~/Search.aspx" mappedUrl="~/SearchResults.aspx" />

限制與注意事項

• 不支援正則表達式：僅精確路徑匹配，無法捕捉動態段落（如 /product/{id}）。
• 不支援萬用字元：每個映射需明確列出。
• 大小寫敏感：依檔案系統/IIS 設定，建議統一小寫。
• 僅適用 .aspx 處理管線：靜態檔案、PHP、ASP 請求不經 ASP.NET 管線，不受影響。
• PostBack 表單 Action：頁面回傳時 <form action 可能為映射後 URL，需配合 Form.Action 修正或使用無表單頁面。

ASP.NET 1.x / 2.0 Beta 相容方案

正式版釋出前，可使用 Steve Smith 部落格提供的 HttpModule 實作：

public class UrlRewriterModule : IHttpModule
{
    public void Init(HttpApplication context)
    {
        context.BeginRequest += OnBeginRequest;
    }
    void OnBeginRequest(object sender, EventArgs e)
    {
        HttpApplication app = (HttpApplication)sender;
        string path = app.Request.Path.ToLower();
        // 簡易映射表
        if (path == "/homepage.aspx") app.Context.RewritePath("/originalhome.aspx");
    }
    public void Dispose() { }
}

web.config 註冊：<add name="UrlRewriter" type="UrlRewriterModule" />

與 ASP.NET 4.0+ Routing 比較

urlMappings 是 ASP.NET 2.0 時代最輕量的 URL 重寫方案，雖功能受限，但零程式碼、宣告式、效能極佳，適合靜態映射、舊網址遷移、簡化 URL 等明確場景。