ASP.NET Core中静态文件触发Jwt授权过滤器的原因及解决方法

为什么压缩后的静态文件会被过滤器处理？ #

核心问题出在中间件执行顺序和全局过滤器的范围：

1. 你通过AddControllers全局注册了JwtAuthorisationFilter，这个过滤器会作用于所有MVC控制器的请求管道。
2. 生产模式下Umbraco生成的带哈希后缀的静态文件请求，没有被静态文件中间件优先处理，反而落到了MVC的路由匹配逻辑里，被当成了控制器端点请求，因此触发了全局过滤器。
3. 另外，[ApiController]特性只是标记控制器的行为，并不会限制全局过滤器的作用范围——全局过滤器会对所有进入MVC管道的请求生效，不管目标是不是Api控制器。

解决方法 #

1. 调整中间件顺序（最根本的解决方式）

在Startup.cs的Configure方法中，确保静态文件中间件在MVC路由相关中间件之前执行。这样静态文件请求会被直接处理，不会进入MVC的过滤器栈：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 先处理静态文件（包括Umbraco的静态资源）
    app.UseStaticFiles();
    // Umbraco专属中间件也需前置
    app.UseUmbraco()
       .WithMiddleware(u =>
       {
           u.UseBackOffice();
           u.UseWebsite();
       });

    // 再配置路由和端点
    app.UseRouting();
    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
        endpoints.MapUmbraco();
    });
}

2. 给全局过滤器添加跳过条件

如果无法调整中间件顺序，可以在JwtAuthorisationFilter里判断请求是否为静态文件，直接跳过验证：

public class JwtAuthorisationFilter : IAuthorizationFilter
{
    public void OnAuthorization(AuthorizationFilterContext context)
    {
        var path = context.HttpContext.Request.Path.Value;
        // 定义需要跳过的静态文件后缀和路径
        var staticFileExtensions = new[] { ".js", ".css", ".png", ".jpg", ".svg" };
        var isStaticFile = staticFileExtensions.Any(ext => path.EndsWith(ext, StringComparison.OrdinalIgnoreCase)) 
                          || path.StartsWith("/umbraco/js/", StringComparison.OrdinalIgnoreCase)
                          || path.StartsWith("/umbraco/css/", StringComparison.OrdinalIgnoreCase);

        if (isStaticFile)
        {
            // 跳过验证，直接放行
            return;
        }

        // 你的JWT验证逻辑
    }
}

3. 替换全局过滤器为控制器级别注解

放弃全局注册过滤器，改为给需要验证的ApiController单独添加过滤器特性：

// 移除ConfigureServices里的全局过滤器配置
services.AddControllers();

// 在需要的Api控制器上单独添加过滤器
[ApiController]
[JwtAuthorisationFilter]
public class MyApiController : ControllerBase
{
    // 控制器逻辑
}

4. 配置静态文件中间件识别哈希后缀

如果Umbraco生成的带哈希的文件名（如abc.js.AV00AF1234D2）无法被默认静态文件中间件识别，可以自定义匹配规则：

app.UseStaticFiles(new StaticFileOptions
{
    OnPrepareResponse = ctx =>
    {
        // 针对带哈希的静态文件设置正确的Content-Type
        var fileName = ctx.File.Name;
        if (fileName.Contains(".js."))
        {
            ctx.Context.Response.ContentType = "application/javascript";
        }
        else if (fileName.Contains(".css."))
        {
            ctx.Context.Response.ContentType = "text/css";
        }
    },
    // 允许处理未知后缀的静态文件
    ServeUnknownFileTypes = true
});

内容的提问来源于stack exchange，提问作者glenatron