如何解决Razor应用中Admin权限页面的集成测试302重定向问题？

核心排查方向与解决方案 #

1. 检查自定义认证Handler的Claim类型与生成逻辑

确保你的TestAuthHandler正确生成包含Admin角色的ClaimsPrincipal，且角色Claim的类型为ClaimTypes.Role（系统默认识别的角色Claim类型）。示例代码：

public class TestAuthHandler : AuthenticationHandler<AuthenticationSchemeOptions>
{
    public TestAuthHandler(IOptionsMonitor<AuthenticationSchemeOptions> options, ILoggerFactory logger, UrlEncoder encoder, ISystemClock clock)
        : base(options, logger, encoder, clock)
    {
    }

    protected override Task<AuthenticateResult> HandleAuthenticateAsync()
    {
        // 构造带有Admin角色的身份信息
        var claims = new[]
        {
            new Claim(ClaimTypes.Name, "TestAdmin"),
            new Claim(ClaimTypes.Role, "Admin") // 必须使用ClaimTypes.Role，否则Authorize属性无法识别
        };
        var identity = new ClaimsIdentity(claims, "TestAuthScheme");
        var principal = new ClaimsPrincipal(identity);
        var ticket = new AuthenticationTicket(principal, "TestAuthScheme");

        return Task.FromResult(AuthenticateResult.Success(ticket));
    }
}

2. 替换WebApplicationFactory中的默认认证服务

在自定义WebApplicationFactory中，需要移除原有认证服务，注册自定义认证方案并设置为默认，避免系统触发默认的Cookie登录跳转。示例代码：

public class AdminTestWebApplicationFactory<TStartup> : WebApplicationFactory<TStartup> where TStartup : class
{
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder.ConfigureServices(services =>
        {
            // 移除默认认证服务
            var authService = services.SingleOrDefault(d => d.ServiceType == typeof(IAuthenticationService));
            if (authService != null) services.Remove(authService);

            // 注册自定义认证方案
            services.AddAuthentication("TestAuthScheme")
                .AddScheme<AuthenticationSchemeOptions, TestAuthHandler>("TestAuthScheme", _ => { });

            // 设置默认认证/挑战方案为自定义类型
            services.Configure<AuthenticationOptions>(options =>
            {
                options.DefaultAuthenticateScheme = "TestAuthScheme";
                options.DefaultChallengeScheme = "TestAuthScheme";
            });
        });
    }
}

3. 编写测试用例验证页面访问

使用上述Factory创建客户端，直接请求目标页面，验证返回状态码为200：

[Test]
public async Task AdminAddPage_Authorized_ReturnsOk()
{
    using var factory = new AdminTestWebApplicationFactory<Program>();
    var client = factory.CreateClient();

    var response = await client.GetAsync("/Add");
    Assert.That(response.StatusCode, Is.EqualTo(HttpStatusCode.OK));

    // 用AngleSharp验证页面渲染内容
    var content = await response.Content.ReadAsStringAsync();
    var browsingContext = BrowsingContext.New(Configuration.Default);
    var document = await browsingContext.OpenAsync(req => req.Content(content));
    
    // 示例：验证页面标题
    Assert.That(document.Title, Does.Contain("Add Model"));
}

额外排查点 #

• 确认AddModel页的[Authorize(Roles = "Admin")]属性拼写正确，角色名称大小写与测试中生成的一致（默认角色匹配不区分大小写，但建议保持统一）。
• 检查项目Program.cs/Startup.cs中的授权配置，确保没有额外的全局策略限制Admin角色访问。
• 如果测试中仍返回302，可临时设置AllowAutoRedirect = false，查看响应的Location头，确认跳转目标是否为登录页，进一步定位认证逻辑问题。

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