ASP.NET Core 2.0 Identity自定义表配置及JWT认证问题求助

Hey there! 基于你描述的场景——用ASP.NET Core 2.0 Identity配合自定义单用户表（无角色、声明）、EF Core 2.0做JWT认证，我整理了这类场景下最容易踩的坑和对应的解决办法，你可以对照看看是不是你遇到的问题：

1. 自定义User类与Identity映射配置错误 #

这是最常见的问题，很多人会忽略自定义用户类和DbContext的正确绑定：

• 确保你的自定义用户类继承IdentityUser<TKey>（或实现IUser<TKey>），比如用int做主键：

public class AppUser : IdentityUser<int>
{
    // 这里加你的自定义字段，比如FullName、PhoneNumber等
}

• 在DbContext中指定使用你的自定义用户类，同时可以移除不需要的角色/声明相关表：

public class AppDbContext : IdentityDbContext<AppUser, IdentityRole<int>, int>
{
    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }

    protected override void OnModelCreating(ModelBuilder builder)
    {
        base.OnModelCreating(builder);
        // 移除不需要的角色、用户角色关联、用户声明表
        builder.Entity<IdentityRole<int>>().ToTable(null);
        builder.Entity<IdentityUserRole<int>>().ToTable(null);
        builder.Entity<IdentityUserClaim<int>>().ToTable(null);
    }
}

2. JWT Token生成未正确关联自定义用户信息 #

即使不用角色和声明，生成JWT时也需要确保从自定义表中正确获取用户，并添加必要的核心Claims：

[HttpPost("login")]
public async Task<IActionResult> Login([FromBody] LoginRequest model)
{
    var user = await _userManager.FindByNameAsync(model.Username);
    if (user == null || !await _userManager.CheckPasswordAsync(user, model.Password))
    {
        return Unauthorized("用户名或密码错误");
    }

    // 只添加JWT必需的Claims，无需额外角色/声明
    var claims = new[]
    {
        new Claim(JwtRegisteredClaimNames.Sub, user.Id.ToString()),
        new Claim(JwtRegisteredClaimNames.UniqueName, user.UserName),
        // 可选：添加你的自定义字段，比如new Claim("FullName", user.FullName)
    };

    var key = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(_config["Jwt:SecretKey"]));
    var creds = new SigningCredentials(key, SecurityAlgorithms.HmacSha256);

    var token = new JwtSecurityToken(
        issuer: _config["Jwt:Issuer"],
        audience: _config["Jwt:Audience"],
        claims: claims,
        expires: DateTime.Now.AddHours(2),
        signingCredentials: creds);

    return Ok(new { AccessToken = new JwtSecurityTokenHandler().WriteToken(token) });
}

3. Identity服务配置未适配无角色/声明场景 #

在Startup.cs的ConfigureServices中，要明确指定使用自定义用户类，并且可以关闭不需要的角色功能：

// 如果你完全不需要角色，用AddIdentityCore替代AddIdentity
services.AddIdentityCore<AppUser>(options =>
{
    // 配置密码、锁定等规则，根据你的需求调整
    options.Password.RequireDigit = false;
    options.Password.RequireUppercase = false;
    options.Lockout.MaxFailedAccessAttempts = 5;
})
.AddEntityFrameworkStores<AppDbContext>()
.AddDefaultTokenProviders();

// 配置JWT认证
services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(options =>
    {
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateIssuer = true,
            ValidateAudience = true,
            ValidateLifetime = true,
            ValidateIssuerSigningKey = true,
            ValidIssuer = Configuration["Jwt:Issuer"],
            ValidAudience = Configuration["Jwt:Audience"],
            IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(Configuration["Jwt:SecretKey"]))
        };
    });

别忘了在Configure方法中启用认证和授权中间件：

app.UseAuthentication();
app.UseAuthorization();

4. EF Core迁移生成多余表 #

如果执行迁移时生成了角色、声明相关的表，打开生成的迁移文件，删除所有和AspNetRoles、AspNetUserRoles、AspNetUserClaims相关的CreateTable、AddColumn代码，再执行迁移即可。

如果你的问题不在上述场景里，可以具体描述下错误信息、异常堆栈或者预期与实际不符的行为，这样能更精准地帮你定位问题！

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