ASP.NET Core MVC中用户名或邮箱唯一的注册功能问题

你遇到的问题是因为启用RequireUniqueEmail = true后，Identity的默认验证逻辑和你的[EmailAddress]属性共同作用，导致空邮箱触发格式错误，同时这个设置还会强制空邮箱也必须唯一，这和你“邮箱可空但不唯一”的需求冲突。下面分步骤解决：

1. 修复空邮箱的格式验证错误 #

你的InputModel中Email字段标记了[EmailAddress]，这个属性会把空字符串判定为无效邮箱。我们需要让这个验证只在邮箱不为空时生效，有两种方法：

方法一：自定义条件邮箱验证属性 #

创建一个自定义验证属性，只在邮箱非空时检查格式：

public class EmailAddressIfNotEmptyAttribute : ValidationAttribute
{
    protected override ValidationResult IsValid(object value, ValidationContext validationContext)
    {
        var email = value as string;
        if (string.IsNullOrWhiteSpace(email))
        {
            return ValidationResult.Success;
        }

        return new EmailAddressAttribute().IsValid(email)
            ? ValidationResult.Success
            : new ValidationResult("请输入有效的邮箱地址");
    }
}

然后替换InputModel中的[EmailAddress]：

public class InputModel {
    //[Required] //根据角色在服务器端验证
    [EmailAddressIfNotEmpty]
    [Display(Name = "Email")]
    public string Email { get; set; }
    //[Required] //根据角色在服务器端验证
    [Display(Name = "Username")]
    public string UserName { get; set; }
    [Required]
    [Display(Name = "Name")]
    public string Name { get; set; }
}

方法二：在Post方法中手动清理验证错误 #

如果不想自定义属性，可以在OnPostAsync里手动移除空邮箱的格式错误：

public async Task<IActionResult> OnPostAsync(string returnUrl = null) {
    string username = Input.UserName ?? Input.Email;

    // 当邮箱为空时，移除EmailAddress的验证错误
    if (string.IsNullOrWhiteSpace(Input.Email))
    {
        ModelState.Remove(nameof(Input.Email));
    }

    if (ModelState.IsValid) {
        var user = new ApplicationUser {
            UserName = username,
            Email = Input.Email?.Trim(),
            Name = Input.Name,
        };

        // 手动验证非空邮箱的唯一性
        if (!string.IsNullOrWhiteSpace(Input.Email))
        {
            var existingUser = await _userManager.FindByEmailAsync(Input.Email);
            if (existingUser != null)
            {
                ModelState.AddModelError(nameof(Input.Email), "该邮箱已被注册");
                return Page();
            }
        }

        var result = await _userManager.CreateAsync(user, Input.Password); // 记得替换成你的密码字段
        if (result.Succeeded)
        {
            // 这里添加你的注册成功逻辑，比如登录、跳转等
            return LocalRedirect(returnUrl ?? "/");
        }
        foreach (var error in result.Errors)
        {
            ModelState.AddModelError(string.Empty, error.Description);
        }
    }

    // 验证失败时返回页面
    return Page();
}

2. 调整Identity配置以匹配需求 #

默认的RequireUniqueEmail = true会强制**所有邮箱（包括空值）**都唯一，这意味着如果有两个用户邮箱为空，会触发唯一性错误，不符合你“邮箱可空但不唯一”的需求。所以我们需要关闭这个设置，改为手动验证非空邮箱的唯一性：

services.AddIdentity<ApplicationUser, IdentityRole>(options => {
    // 关闭默认的邮箱唯一验证，改为手动处理
    options.User.RequireUniqueEmail = false;
    // 保持用户名的唯一性（Identity默认已开启）
    options.User.RequireUniqueUserName = true;
})
.AddEntityFrameworkStores<ApplicationDbContext>()
.AddDefaultTokenProviders();

最终效果验证 #

调整后，你的注册逻辑会满足以下场景：

• 用户只填邮箱、不填用户名：用户名自动设为邮箱，验证邮箱格式和唯一性，通过则注册成功
• 用户只填用户名、不填邮箱：跳过邮箱验证，直接注册（允许多个用户邮箱为空）
• 用户同时填用户名和邮箱：验证邮箱格式和唯一性，用户名保持唯一，通过则注册成功

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