如何在ASP.NET Core中扩展UserManager添加自定义查询方法

方法一：使用扩展方法（推荐新手） #

这种方式无需修改原有UserManager的注册逻辑，通过静态扩展类快速添加自定义方法，操作最简便。

1. 确认ApplicationUser定义
   你已完成这一步，确保类包含目标字段：

   public class ApplicationUser : IdentityUser
   {
       public string UserCreatedUserName { get; set; }
   }
   

2. 添加唯一索引（可选但推荐）
   由于该字段是唯一字符串，在ApplicationDbContext的OnModelCreating中添加唯一索引，既提升查询性能，也能保证数据唯一性：

   protected override void OnModelCreating(ModelBuilder builder)
   {
       base.OnModelCreating(builder);
   
       builder.Entity<ApplicationUser>()
           .HasIndex(u => u.UserCreatedUserName)
           .IsUnique();
   }
   

3. 创建UserManager扩展类
   新建静态类实现自定义查询方法：

   using Microsoft.AspNetCore.Identity;
   using Microsoft.EntityFrameworkCore;
   
   public static class UserManagerExtensions
   {
       /// <summary>
       /// 通过UserCreatedUserName查询用户
       /// </summary>
       /// <param name="userManager">UserManager实例</param>
       /// <param name="userCreatedUserName">用户自定义唯一用户名</param>
       /// <returns>匹配的ApplicationUser，无匹配则返回null</returns>
       public static async Task<ApplicationUser> FindByUserCreatedUserNameAsync(this UserManager<ApplicationUser> userManager, string userCreatedUserName)
       {
           // 直接通过UserManager的Users集合（IQueryable）执行查询
           return await userManager.Users
               .FirstOrDefaultAsync(u => u.UserCreatedUserName == userCreatedUserName);
       }
   }
   

4. 使用自定义方法
   在控制器或服务中注入UserManager<ApplicationUser>后直接调用：

   public class AccountController : Controller
   {
       private readonly UserManager<ApplicationUser> _userManager;
   
       public AccountController(UserManager<ApplicationUser> userManager)
       {
           _userManager = userManager;
       }
   
       public async Task<IActionResult> GetUserByCustomName(string customUserName)
       {
           var user = await _userManager.FindByUserCreatedUserNameAsync(customUserName);
           if (user == null)
           {
               // 处理用户不存在的逻辑
               return NotFound();
           }
           // 后续业务逻辑
           return View(user);
       }
   }
   

方法二：继承UserManager创建自定义管理器 #

如果需要添加更多自定义逻辑（比如额外用户验证、自定义令牌生成等），可以直接继承UserManager：

1. 创建自定义ApplicationUserManager

   using Microsoft.AspNetCore.Identity;
   using Microsoft.EntityFrameworkCore;
   using Microsoft.Extensions.Logging;
   using Microsoft.Extensions.Options;
   
   public class ApplicationUserManager : UserManager<ApplicationUser>
   {
       public ApplicationUserManager(
           IUserStore<ApplicationUser> store,
           IOptions<IdentityOptions> optionsAccessor,
           IPasswordHasher<ApplicationUser> passwordHasher,
           IEnumerable<IUserValidator<ApplicationUser>> userValidators,
           IEnumerable<IPasswordValidator<ApplicationUser>> passwordValidators,
           ILookupNormalizer keyNormalizer,
           IdentityErrorDescriber errors,
           IServiceProvider services,
           ILogger<UserManager<ApplicationUser>> logger)
           : base(store, optionsAccessor, passwordHasher, userValidators, passwordValidators, keyNormalizer, errors, services, logger)
       {
       }
   
       /// <summary>
       /// 通过UserCreatedUserName查询用户
       /// </summary>
       public async Task<ApplicationUser> FindByUserCreatedUserNameAsync(string userCreatedUserName)
       {
           return await Users.FirstOrDefaultAsync(u => u.UserCreatedUserName == userCreatedUserName);
       }
   }
   

2. 注册自定义UserManager
   在Program.cs中替换默认的UserManager注册：

   builder.Services.AddIdentity<ApplicationUser, IdentityRole>()
       .AddEntityFrameworkStores<ApplicationDbContext>()
       .AddUserManager<ApplicationUserManager>() // 注册自定义管理器
       .AddDefaultTokenProviders();
   

3. 注入并使用
   注入ApplicationUserManager代替原UserManager<ApplicationUser>：

   public class AccountController : Controller
   {
       private readonly ApplicationUserManager _userManager;
   
       public AccountController(ApplicationUserManager userManager)
       {
           _userManager = userManager;
       }
   
       public async Task<IActionResult> GetUserByCustomName(string customUserName)
       {
           var user = await _userManager.FindByUserCreatedUserNameAsync(customUserName);
           // 后续业务逻辑
           return View(user);
       }
   }
   

可选优化：大小写不敏感查询 #

如果需要忽略用户名大小写（例如"UserName"和"username"视为同一用户），修改查询语句：

return await userManager.Users
    .FirstOrDefaultAsync(u => u.UserCreatedUserName.Equals(userCreatedUserName, StringComparison.OrdinalIgnoreCase));

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