.NET 8.0 MVC如何配置路由以忽略图片请求？

API 探路者

2026-6-15

解决.NET 8 MVC路由误匹配静态文件的问题

你的问题出在自定义路由/{landingSlug}/{articleSlug}会把/images/something.jpg这类静态文件请求当成符合规则的路由（images被识别为landingSlug，something.jpg被识别为articleSlug），可以通过以下几种方式解决：

方式一：给路由参数添加正则约束

给articleSlug参数添加正则约束，限制它不能包含点号（静态文件通常带扩展名，会包含点号），这样带扩展名的请求就不会匹配该路由：

app.MapControllerRoute(
    name: "ArticlePage",
    pattern: "/{landingSlug}/{articleSlug:regex(^[^.]+$)}",
    defaults: new { controller = "Article", action = "Index" });

方式二：排除特定前缀的路径

如果静态文件都在固定前缀（比如/images/、/css/）下，可以给路由添加约束，排除这些前缀的请求：

app.MapControllerRoute(
    name: "ArticlePage",
    pattern: "/{landingSlug}/{articleSlug}",
    defaults: new { controller = "Article", action = "Index" },
    constraints: new { landingSlug = new NotEqualConstraint("images") });

需要自定义NotEqualConstraint类：

public class NotEqualConstraint : IRouteConstraint
{
    private readonly string _forbiddenValue;

    public NotEqualConstraint(string forbiddenValue)
    {
        _forbiddenValue = forbiddenValue;
    }

    public bool Match(HttpContext? httpContext, IRouter? route, string routeKey, RouteValueDictionary values, RouteDirection routeDirection)
    {
        return !string.Equals(values[routeKey]?.ToString(), _forbiddenValue, StringComparison.OrdinalIgnoreCase);
    }
}

如果要排除多个前缀，可以扩展这个约束支持多值判断。