自定义IdentityServer的IdentityUser实体移除默认字段遇SQL异常求助

我之前也踩过几乎一模一样的坑——AspNetIdentity和IdentityServer4对默认字段的依赖比看起来要深得多，尤其是重命名或移除默认字段时，必须把所有关联配置同步到位，不然就会出现找不到列的SQL异常。下面是我亲测有效的修复步骤：

1. 彻底同步User实体的属性映射 #

你自定义的User继承自IdentityUser<int>，但默认的IdentityUser自带很多属性（比如NormalizedUserName、AccessFailedCount），仅改DbContext映射是不够的，必须确保实体属性和数据库列完全对应：

示例代码： #

// 自定义User实体
public class User : IdentityUser<int>
{
    // 如果你只是重命名数据库列，不需要改属性名，直接在映射里指定列名即可
    // 比如把NormalizedEmail映射到数据库的NormalisedEmail列
    // 但如果连属性名都要改，就得显式覆盖原属性并配置
    // 这里更稳妥的方式是保留原属性名，仅映射列名：
    // public override string NormalizedEmail { get; set; }
}

// 在ApplicationDbContext的OnModelCreating中配置映射
protected override void OnModelCreating(ModelBuilder builder)
{
    base.OnModelCreating(builder); // 必须先调用base方法，不然Identity的默认映射会丢失

    // 配置User实体的自定义映射
    builder.Entity<User>(b =>
    {
        // 重命名默认列
        b.Property(u => u.NormalizedEmail).HasColumnName("NormalisedEmail");
        b.Property(u => u.NormalizedUserName).HasColumnName("NormalisedUserName");

        // 如果要移除默认字段（比如AccessFailedCount、LockoutEnabled）：
        // 注意：这些字段是AspNetIdentity内置逻辑依赖的，直接移除会导致UserManager报错
        // 如果你不需要锁定功能，可以先禁用相关选项，再配置列映射（或忽略）
        b.Property(u => u.AccessFailedCount).HasColumnName("YourCustomAccessFailedCount"); // 或者用.HasDefaultValue(0)
        b.Property(u => u.LockoutEnabled).HasColumnName("YourCustomLockoutEnabled").HasDefaultValue(false);
    });

    // 检查自定义关联表的外键映射（比如AccountValidatationAccountId）
    builder.Entity<AccountValidation>(b =>
    {
        b.HasOne(v => v.User)
         .WithMany(u => u.AccountValidations)
         .HasForeignKey(v => v.AccountId) // 实体属性名
         .HasColumnName("AccountValidatationAccountId"); // 数据库列名
    });
}

2. 确保IdentityServer4使用你的自定义User实体 #

IdentityServer默认会依赖AspNetIdentity的默认用户类型，必须显式指定你的自定义User：

// Startup.cs 或 Program.cs
services.AddIdentityServer()
    .AddAspNetIdentity<User>() // 这里一定要指定你的自定义User实体
    .AddConfigurationStore(options =>
    {
        options.ConfigureDbContext = b =>
            b.UseSqlServer(connectionString,
                sql => sql.MigrationsAssembly(typeof(ApplicationDbContext).Assembly.FullName));
    })
    .AddOperationalStore(options =>
    {
        options.ConfigureDbContext = b =>
            b.UseSqlServer(connectionString,
                sql => sql.MigrationsAssembly(typeof(ApplicationDbContext).Assembly.FullName));
    });

// 同时确保Identity服务注册也用自定义User
services.AddDefaultIdentity<User>(options => 
    options.SignIn.RequireConfirmedAccount = true)
    .AddEntityFrameworkStores<ApplicationDbContext>();

3. 处理默认字段移除的依赖问题 #

像AccessFailedCount、LockoutEnabled这类字段是AspNetIdentity的UserManager内置逻辑依赖的（比如用户锁定、失败登录计数），如果你的数据库里没有这些字段，不能直接删除属性，得：

• 先在Identity配置中禁用相关功能：

  services.AddDefaultIdentity<User>(options =>
  {
      options.Lockout.AllowedForNewUsers = false; // 禁用新用户锁定功能
      options.Lockout.MaxFailedAccessAttempts = 0; // 关闭失败登录计数
  });
  

• 然后在DbContext中配置这些字段为数据库的默认值，避免SQL报错：

  builder.Entity<User>(b =>
  {
      b.Property(u => u.AccessFailedCount).HasDefaultValue(0);
      b.Property(u => u.LockoutEnabled).HasDefaultValue(false);
  });
  

4. 验证迁移和数据库结构 #

修改映射后，必须重新生成并应用EF迁移，确保数据库结构和代码映射完全一致：

# 生成新的迁移脚本
dotnet ef migrations add UpdateUserSchema
# 应用到数据库
dotnet ef database update

如果是对接现有数据库，建议手动对比迁移脚本和现有表结构，避免自动迁移破坏数据。

5. 调试定位问题 #

如果还是报错，开启EF Core的SQL日志，查看生成的SQL语句，就能精准定位哪个查询引用了不存在的列：

services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlServer(connectionString)
           .LogTo(Console.WriteLine, LogLevel.Information));

运行程序后，控制台会输出所有EF生成的SQL，找到报错的查询，针对性修复映射即可。

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