萬盛學電腦網

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

ASP.NET URL 重寫與通配符映射實戰

需求

將 `https://yyjcw.com/a.aspx?name=llinzzi` 映射為美觀網址 `https://yyjcw.com/llinzzi` 或 `https://yyjcw.com/llinzzi/`。

挑戰

  1. ASP.NET 2.0 內建 `` **不支援通配符**。
  2. IIS 6 僅對註冊副檔名 (如 `.aspx`) 的請求交給 ASP.NET 處理,無副檔名請求直接回 404。

解決方案:NBear.Web UrlRewriteModule

1. 註冊 HttpModule (web.config)

<configuration>
  <configSections>
    <section name="UrlRewriteRules" type="NBear.Web.Modules.UrlRewriteRules, NBear.Web" />
  </configSections>

  <UrlRewriteRules>
    <Rule key="/(.*)/" value="/a.aspx?name=$1" />
    <Rule key="/(.*)"  value="/a.aspx?name=$1" />
  </UrlRewriteRules>

  <system.web>
    <httpModules>
      <add name="UrlRewriteModule" type="NBear.Web.Modules.UrlRewriteModule, NBear.Web" />
    </httpModules>
  </system.web>
</configuration>

2. IIS 6 關鍵設定:通配符應用程式對應

  1. IIS 管理器 → 網站/虛擬目錄 → 右鍵「內容」 → 「主目錄」 → 「配置」。
  2. 點選「通配符應用程式對應」 → 「插入」。
  3. 可執行檔:`C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll`
  4. **取消勾選「確認檔案存在」** (關鍵!否則無副檔名請求會被 IIS 直接 404)。

原理解析

IIS 6 處理管線:

  1. ISAPI 篩選器 (依序執行)
  2. **通配符應用程式對應** (此處掛載 `aspnet_isapi.dll`,所有請求進入 ASP.NET)
  3. 一般應用程式對應 (依副檔名分派)
  4. 靜態檔案處理

掛載通配符對應後,`/llinzzi` 進入 ASP.NET → `UrlRewriteModule` 攔截 → 依規則重寫為 `/a.aspx?name=llinzzi` → 正常執行。

驗證步驟

  1. 設定通配符對應後,測試 `https://yyjcw.com/llinzzi/` → 成功。
  2. 將 `index.aspx` 設為預設文件,測試 `https://yyjcw.com/llinzzi/` → 成功 (需確認目錄存在或再寫一條 Rule)。

遷移至 IIS 7+ 整合模式

<system.webServer>
  <modules runAllManagedModulesForAllRequests="true">
    <add name="UrlRewriteModule" type="NBear.Web.Modules.UrlRewriteModule, NBear.Web" />
  </modules>
  <rewrite>
    <rules>
      <rule name="UserFriendly" stopProcessing="true">
        <match url="^([^/]+)/?$" />
        <action type="Rewrite" url="/a.aspx?name={R:1}" />
      </rule>
    </rules>
  </rewrite>
</system.webServer>

內建 URL Rewrite Module 取代第三方元件,效能更好、設定更直觀。

常見坑

  • 忘記取消勾選「確認檔案存在」→ 404 不進 ASP.NET。
  • 規則順序錯誤:詳細規則應在通用規則之前。
  • 重寫後 QueryString 遺失:NBear 模組會自動保留原 QueryString 並合併。
  • 無限重寫迴圈:Rule 產生的 URL 再次符合同一 Rule,需加 `stopProcessing` 或調整 Pattern。
copyright © 萬盛學電腦網 all rights reserved