ASP.NET Core 7静态文件访问未跳转自定义登录页问题排查

一、跳转至AWS Cognito/微软默认认证页的原因 #

你配置了OpenIDConnect（对接AWS Cognito）且设置了FallbackPolicy要求全局认证，当/staticfiles路径的请求触发授权校验时，认证中间件会优先启动OIDC的认证挑战流程，而非Cookie认证配置的LoginPath。因为OIDC作为外部认证方案，默认会被优先用于处理未认证的全局授权要求，直接跳转到Cognito的授权端点。

二、现有配置的问题排查点 #

• 中间件顺序错误：若你在UseStaticFiles()之后调用UseAuthentication()和UseAuthorization()，会导致静态文件请求先被返回，认证授权逻辑根本没触发。正确顺序应为：UseAuthentication() → UseAuthorization() → 静态文件处理中间件。
• FallbackPolicy覆盖自定义逻辑：全局FallbackPolicy要求所有请求必须认证，包括/staticfiles路径。此时授权校验会优先触发OIDC的挑战流程，跳过你在StaticFileOptions.OnPrepareResponse中编写的重定向逻辑。
• OnPrepareResponse逻辑缺陷：若你判断用户认证状态的代码有误（比如未正确获取ctx.Context.User.Identity），会导致重定向逻辑不执行。

三、自定义拦截/staticfiles请求的实现方案 #

方案1：针对静态文件路径单独配置授权策略 #

先为/staticfiles路径配置允许匿名的授权策略，避免FallbackPolicy触发OIDC挑战，再在静态文件处理中自行判断认证状态并重定向：

// 配置授权策略
builder.Services.AddAuthorization(options =>
{
    // 全局默认要求认证
    options.FallbackPolicy = new AuthorizationPolicyBuilder()
        .RequireAuthenticatedUser()
        .Build();

    // 为静态文件路径添加允许匿名的策略
    options.AddPolicy("StaticFilesAnonymous", policy => policy.AllowAnonymous());
});

// 针对/staticfiles路径应用策略并配置静态文件
app.UseWhen(context => context.Request.Path.StartsWithSegments("/staticfiles"), appBuilder =>
{
    appBuilder.UseAuthorization(policy => policy.RequirePolicy("StaticFilesAnonymous"));
    appBuilder.UseStaticFiles(new StaticFileOptions
    {
        OnPrepareResponse = ctx =>
        {
            if (!ctx.Context.User.Identity.IsAuthenticated)
            {
                var returnUrl = Uri.EscapeDataString(ctx.Context.Request.Path + ctx.Context.Request.QueryString);
                ctx.Context.Response.Redirect($"/Login?ReturnUrl={returnUrl}");
            }
        }
    });
});

方案2：编写自定义中间件直接拦截 #

创建一个轻量中间件，在静态文件处理前检查用户认证状态，未认证则直接重定向：

// 自定义拦截中间件，放在UseAuthentication()之后、UseStaticFiles()之前
app.Use(async (context, next) =>
{
    if (context.Request.Path.StartsWithSegments("/staticfiles") && !context.User.Identity.IsAuthenticated)
    {
        var returnUrl = Uri.EscapeDataString(context.Request.Path + context.Request.QueryString);
        context.Response.Redirect($"/Login?ReturnUrl={returnUrl}");
        return;
    }
    await next();
});

// 确保中间件顺序正确
app.UseAuthentication();
app.UseAuthorization();
// 上述自定义中间件需放在此处
app.UseStaticFiles(); // 若/staticfiles是单独配置的静态文件目录，对应UseStaticFiles需放在自定义中间件之后

四、核心注意事项 #

• 中间件顺序必须严格遵守：自定义拦截逻辑要在UseAuthentication()之后（才能正确获取用户认证状态）、静态文件处理中间件之前（才能拦截请求）。
• 必须规避FallbackPolicy的影响：要么为/staticfiles配置允许匿名的策略，要么在自定义中间件中提前拦截请求，避免全局授权策略触发OIDC挑战。
• 务必携带ReturnUrl：重定向时带上当前请求的完整路径，确保用户登录后能回到原访问页面。

内容的提问来源于stack exchange，提问作者Sana.91