萬盛學電腦網

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

ASP.NET 獲取 URL 重寫前原始地址的通用解決方案

URL 重寫 (Rewrite) 是打造友好 URL、SEO 優化的標準手段,但帶來一個棘手問題:HttpContext.Request.Url 等屬性返回的是**重寫後的內部路徑**,而非使用者看到的原始友好 URL。當需將原始 URL 作為登入後導向目標、記錄日誌、生成分享連結時,必須還原重寫前地址。

核心原理:HTTP 標頭保留原始路徑

主流 URL 重寫模組 (ISAPI_Rewrite、IIS URL Rewrite Module) 在重寫前,會將原始 URL 存入特定 HTTP 標頭,供後端應用讀取:

重寫模組HTTP 標頭鍵名值範例
ISAPI_Rewrite (Helicon Tech)X-Rewrite-URL/products/123/detail.html
IIS URL Rewrite Module (原生)X-Original-URL/products/123/detail.html

通用取得原始 URL 程式碼

public string GetOriginalUrl()
{
    var request = HttpContext.Current.Request;
    string originalPath = null;

    // 1. 優先檢查 ISAPI_Rewrite 標頭
    if (request.Headers["X-Rewrite-URL"] != null)
    {
        originalPath = request.Headers["X-Rewrite-URL"];
    }
    // 2. 次檢查 IIS URL Rewrite 標頭
    else if (request.Headers["X-Original-URL"] != null)
    {
        originalPath = request.Headers["X-Original-URL"];
    }
    // 3. 相容其他模組 (如 UrlRewriter.NET 等)
    else if (request.Headers["X-Rewritten-URL"] != null)
    {
        originalPath = request.Headers["X-Rewritten-URL"];
    }

    if (originalPath != null)
    {
        // 組合完整絕對 URL:協定 + 主機 + 埠口 (非標準埠) + 原始路徑
        var url = new UriBuilder(request.Url.Scheme, request.Url.Host, request.Url.Port, originalPath);
        // 若為標準埠 (80/443),UriBuilder 預設不輸出埠號
        return url.ToString();
    }

    // 4. 回退:無重寫標頭,直接使用當前 URL
    return request.Url.ToString();
}

實戰場景:登入頁保留原始返回地址

// Login.aspx.cs - 頁面載入時儲存原始 URL
protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        string returnUrl = GetOriginalUrl();
        // 排除登入頁自身,避免迴圈
        if (!returnUrl.Contains("Login.aspx", StringComparison.OrdinalIgnoreCase))
        {
            ViewState["ReturnUrl"] = returnUrl;
        }
    }
}

// 登入成功後導向
protected void btnLogin_Click(object sender, EventArgs e)
{
    if (Membership.ValidateUser(txtUser.Text, txtPwd.Text))
    {
        string returnUrl = ViewState["ReturnUrl"] as string ?? "~/Default.aspx";
        FormsAuthentication.RedirectFromLoginPage(txtUser.Text, chkRemember.Checked);
        // 或自導向
        Response.Redirect(returnUrl, false);
        Context.ApplicationInstance.CompleteRequest();
    }
}

遷移陷阱:ISAPI_Rewrite → IIS URL Rewrite 規則差異

同樣友好 URL https://www.example.com/cmt/:

  • ISAPI_Rewrite 規則匹配 /cmt/ (含前導斜線)。
  • IIS URL Rewrite 規則匹配 cmt/ (無前導斜線,相對於網站根目錄)。

遷移時**必須手動調整每條規則的 Pattern**,移除前導斜線。IIS 匯入功能**不會**自動處理此差異,切勿盲目信任匯入結果。

擴充:ASP.NET Core 中的對應做法

// Middleware 中讀取
var originalPath = context.Request.Headers["X-Original-URL"].FirstOrDefault()
                ?? context.Request.Headers["X-Rewrite-URL"].FirstOrDefault();
if (!string.IsNullOrEmpty(originalPath))
{
    context.Request.Path = originalPath; // 重寫 Path 供後續中介軟體使用
}

結語

掌握 X-Rewrite-URL / X-Original-URL 兩大標準標頭,編寫通用取得原始 URL 方法,即可在任何使用主流重寫模組的 ASP.NET 應用中,精準還原使用者眼中的友好地址,保障導向、日誌、分享等功能的正確性與一致性。

copyright © 萬盛學電腦網 all rights reserved