ASP.NET Identity自定义用户名验证异常及取消唯一性问题

第一个问题：重复用户名时ValidateEntity不触发的原因 #

ASP.NET Identity的UserManager.CreateAsync方法在调用EF的SaveChanges（也就是触发ValidateEntity）之前，会先执行内置的唯一性验证——检查用户名/邮箱是否已存在。如果发现用户名重复，它会直接返回失败结果，根本不会走到EF的持久化环节，自然你的ValidateEntity方法就不会被触发。

如何让自定义验证逻辑始终生效？ #

如果你想让自定义用户名验证逻辑不管重复与否都执行，推荐通过扩展UserManager的自定义验证器来实现，这是最贴合Identity框架设计的方案：

1. 创建自定义用户验证器：

public class CustomUserValidator : UserValidator<ApplicationUser>
{
    public CustomUserValidator(UserManager<ApplicationUser> manager) : base(manager)
    {
    }

    public override async Task<IdentityResult> ValidateAsync(ApplicationUser user)
    {
        // 先执行Identity的默认验证逻辑
        var result = await base.ValidateAsync(user);
        
        // 在这里加入你的自定义用户名验证逻辑
        if (string.IsNullOrWhiteSpace(user.UserName) || user.UserName.Contains("forbidden"))
        {
            var errors = result.Errors.ToList();
            errors.Add(new IdentityError { Description = "用户名包含禁用字符或不能为空" });
            result = IdentityResult.Failed(errors.ToArray());
        }
        
        return result;
    }
}

2. 在Startup.cs中注册这个自定义验证器，替换默认逻辑：

public void ConfigureAuth(IAppBuilder app)
{
    // ...其他认证配置代码
    var userManager = new UserManager<ApplicationUser>(new UserStore<ApplicationUser>(new ApplicationDbContext()));
    // 替换默认用户验证器为自定义实现
    userManager.UserValidator = new CustomUserValidator(userManager);
    // ...其他配置
}

这样不管用户名是否重复，你的自定义验证逻辑都会被执行，且会和Identity的默认验证结果合并返回。

第二个问题：添加public new string UserName { get; set; }后出现Name cannot be null or empty错误 #

这个问题的核心是你用new关键字隐藏了IdentityUser基类的UserName属性，但Identity框架内部依然依赖基类的UserName属性进行身份验证、存储等操作。当你只给子类的UserName赋值时，基类的UserName其实还是空值，导致框架抛出“Name不能为空”的错误。

解决方法： #

不要用new来重写UserName属性，推荐以下两种方式：

• 直接使用基类的UserName属性：不需要重新定义，直接在自定义验证逻辑中使用它即可；
• 添加扩展属性+同步逻辑：如果需要额外的用户名相关字段，可以新增一个属性（比如CustomUserName），然后在保存或验证时同步到基类的UserName；
• 自定义EF映射（可选）：如果只是想修改UserName对应的数据库列名，用EF的Fluent API配置即可，不需要隐藏基类属性：

protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    
    // 自定义UserName的数据库列映射
    modelBuilder.Entity<ApplicationUser>()
        .Property(u => u.UserName)
        .HasColumnName("CustomUserName")
        .IsRequired();
}

若坚持使用ValidateEntity方案（不推荐） #

如果你一定要用ValidateEntity做验证，需要绕过Identity的默认唯一性检查，但这种方式会绕开框架的安全机制，需谨慎：

1. 关闭UserManager的默认唯一性验证：

userManager.UserValidator = new UserValidator<ApplicationUser>(userManager)
{
    AllowOnlyAlphanumericUserNames = false,
    RequireUniqueEmail = false, // 若不需要唯一邮箱也可关闭
};

2. 在ValidateEntity中手动实现用户名唯一性检查，确保逻辑覆盖所有场景。

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