URL 重寫 (Rewrite) 是打造友好 URL、SEO 優化的標準手段,但帶來一個棘手問題:HttpContext.Request.Url 等屬性返回的是**重寫後的內部路徑**,而非使用者看到的原始友好 URL。當需將原始 URL 作為登入後導向目標、記錄日誌、生成分享連結時,必須還原重寫前地址。
主流 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 |
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();
}
}
同樣友好 URL https://www.example.com/cmt/:
/cmt/ (含前導斜線)。cmt/ (無前導斜線,相對於網站根目錄)。遷移時**必須手動調整每條規則的 Pattern**,移除前導斜線。IIS 匯入功能**不會**自動處理此差異,切勿盲目信任匯入結果。
// 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 應用中,精準還原使用者眼中的友好地址,保障導向、日誌、分享等功能的正確性與一致性。