ASP.NET Core Identity服务异步方法为何无CancellationToken参数？

为什么UserManager.FindByNameAsync这类方法没有CancellationToken参数？ #

Asp.Net Core Identity早期设计时，为了简化API接口，没有给这类常用异步方法暴露取消令牌参数。内部默认通过只读属性传递CancellationToken.None给EF Core相关方法，且该属性不允许外部修改。后续EF Core的存储实现虽已支持取消令牌，但上层UserManager的部分方法未同步更新参数重载。

解决方案 #

1. 升级到.NET 6+版本的Identity #

在.NET 6及以后的Asp.Net Core Identity版本中，官方已为FindByNameAsync、FindByIdAsync等常用方法添加了带CancellationToken参数的重载。直接使用这些重载即可传递取消令牌：

var user = await _userManager.FindByNameAsync(username, cancellationToken);

2. 自定义UserManager扩展方法（适配旧版本） #

如果无法升级框架，可自定义UserManager，添加支持取消令牌的方法，直接调用底层IUserStore的对应方法（IUserStore的方法通常支持CancellationToken）：

步骤1：实现自定义UserManager

public class CustomUserManager<TUser> : UserManager<TUser> 
    where TUser : class
{
    private readonly IUserStore<TUser> _userStore;

    public CustomUserManager(
        IUserStore<TUser> userStore,
        IOptions<IdentityOptions> optionsAccessor,
        IPasswordHasher<TUser> passwordHasher,
        IEnumerable<IUserValidator<TUser>> userValidators,
        IEnumerable<IPasswordValidator<TUser>> passwordValidators,
        ILookupNormalizer keyNormalizer,
        IdentityErrorDescriber errors,
        IServiceProvider services,
        ILogger<UserManager<TUser>> logger) 
        : base(userStore, optionsAccessor, passwordHasher, userValidators, passwordValidators, keyNormalizer, errors, services, logger)
    {
        _userStore = userStore;
    }

    // 自定义带取消令牌的FindByNameAsync
    public async Task<TUser> FindByNameAsync(string userName, CancellationToken cancellationToken)
    {
        if (string.IsNullOrEmpty(userName))
            throw new ArgumentNullException(nameof(userName));

        var normalizedName = NormalizeName(userName);
        // 直接调用UserStore的方法，传递取消令牌
        return await _userStore.FindByNameAsync(normalizedName, cancellationToken);
    }

    // 同理可扩展其他方法，如FindByIdAsync
    public async Task<TUser> FindByIdAsync(string userId, CancellationToken cancellationToken)
    {
        if (string.IsNullOrEmpty(userId))
            throw new ArgumentNullException(nameof(userId));

        return await _userStore.FindByIdAsync(userId, cancellationToken);
    }
}

步骤2：注册自定义UserManager

在Program.cs（或Startup.cs）中替换默认的UserManager注册：

services.AddIdentity<ApplicationUser, IdentityRole>()
    .AddEntityFrameworkStores<AppDbContext>()
    .AddUserManager<CustomUserManager<ApplicationUser>>();

3. 避免反射修改内部属性（不推荐） #

虽然可以通过反射修改UserManager内部的只读取消令牌字段，但这种方式破坏了封装性，框架版本更新可能导致代码失效，因此不建议使用。

自定义UserManager时的常见问题解决 #

如果自定义UserManager时遇到问题，通常是以下原因：

• 未正确注入IUserStore实例：确保构造函数中正确接收并存储IUserStore，直接调用其带取消令牌的方法。
• 框架版本过低：旧版本的IUserStore方法可能不支持CancellationToken，需升级到支持该参数的Identity版本。

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