ASP.NET MVC 路由約束實戰：使用正則與 IRouteConstraint 保護參數類型

預設路由 {controller}/{action}/{id} 會匹配 /Product/blah 這類非數字 ID，導致模型繫結失敗或例外。本文示範兩種路由約束寫法，確保 URL 參數符合預期格式。

問題重現

routes.MapRoute("Product", "Product/{productId}",
    new { controller="Product", action="Details" });
// Details(int productId) 會嘗試將 "blah" 轉 int → 拋出例外

方案一：內嵌正則約束（簡單場景）

routes.MapRoute("Product", "Product/{productId}",
    new { controller="Product", action="Details" },
    new { productId = @"\d+" }); // 僅匹配純數字

現在 /Product/blah 將不再匹配此路由，轉交給下一條路由或 404。

方案二：實作 IRouteConstraint（複雜邏輯）

當約束涉及資料庫查詢、快取檢查等複雜邏輯時，實作介面：

public class ProductExistsConstraint : IRouteConstraint {
    public bool Match(HttpContextBase httpContext, Route route,
        string parameterName, RouteValueDictionary values, RouteDirection routeDirection) {
        if (!values.ContainsKey(parameterName)) return false;
        string val = values[parameterName] as string;
        if (string.IsNullOrEmpty(val)) return false;
        // 例如：檢查產品是否存在於快取/資料庫
        return ProductCache.Exists(val); 
    }
}
// 註冊
routes.MapRoute("Product", "Product/{productId}",
    new { controller="Product", action="Details" },
    new { productId = new ProductExistsConstraint() });

常用正則約束速查

最佳實踐

• 約束放在路由層，而非 Controller 內判斷，符合「失敗快速」原則。
• 複雜約束類建議無狀態、可重用，避免在 Match 中做重 IO 操作；必要時引入快取。
• 單元測試路由：使用 RouteCollection + Mock<HttpContextBase> 驗證匹配/不匹配案例。