.NET 5 ASP.NET Core MVC Identity 多用户类型报未注册Default令牌提供程序错误
问题根因与解决方案
核心触发原因
- 当前配置存在多套独立Identity服务并行注册的问题:
- 单独针对基类
HedgehogUserAccount调用了AddIdentity,这套服务会为基类注册全套令牌提供程序 - 又分别针对两个子类
UserAccount、CustomerAccount调用AddIdentityCore注册独立的UserManager、SignInManager服务
- 单独针对基类
- Identity的令牌提供程序是和当前服务链绑定的泛型用户类型严格匹配的:
- 针对
UserAccount调用GenerateEmailConfirmationTokenAsync时,会从当前UserManager<UserAccount>绑定的令牌服务集合中,查找名为Default的IUserTwoFactorTokenProvider<UserAccount> - 手动添加Default条目时触发重复key报错的原因是,
AddDefaultTokenProviders()本身就会在ProviderMap中写入Default条目;运行时仍报找不到提供程序的本质是,AddIdentityCore的调用链没有正确绑定令牌提供程序的具体实现类型,解析时找不到匹配的实例
- 针对
- 跨用户类型复用同一套
IdentityRole存储,本身就违反Identity的设计约束:UserManager、RoleManager都是按泛型类型隔离的服务,跨类型绑定同一套角色存储会导致权限校验、令牌生成全链路异常。
具体修正步骤
1. 清理冗余的Identity注册
完全移除针对基类HedgehogUserAccount的AddIdentity注册,将两个子类的注册逻辑从AddIdentityCore替换为完整的AddIdentity,避免服务隔离、认证配置缺失的问题,参考配置:
// 注册后台用户体系 services.AddIdentity<UserAccount, IdentityRole>(options => { options.SignIn.RequireConfirmedAccount = true; }) .AddEntityFrameworkStores<ApplicationDbContext>() .AddDefaultTokenProviders() .AddDefaultUI(); // 注册前台客户体系 services.AddIdentity<CustomerAccount, IdentityRole>(options => { options.SignIn.RequireConfirmedAccount = true; }) .AddEntityFrameworkStores<ApplicationDbContext>() .AddDefaultTokenProviders() .AddDefaultUI();
说明:
AddIdentity会自动完成Cookie认证配置、令牌服务绑定的全流程初始化;AddIdentityCore仅注册核心业务服务,不会自动绑定认证管道,也不会正确完成令牌提供程序的类型匹配,这是之前注册失效的隐藏原因。
2. 删除所有手动调整令牌提供程序的冗余代码
- 移除之前手动往
options.Tokens.ProviderMap添加Default条目的逻辑 - 移除之前手动调用
AddTokenProvider指定具体实现类型的逻辑
按照Identity的默认设计,调用AddDefaultTokenProviders()后会自动为当前绑定的TUser类型注册三个默认提供程序:
- 名为
Default的TotpSecurityStampBasedTokenProvider<TUser>(即双因素、邮件确认流程默认使用的提供程序) - 名为
Email的邮件专用提供程序 - 名为
Phone的短信专用提供程序
只要服务注册没有跨类型冲突,调用GenerateEmailConfirmationTokenAsync时就会自动匹配到正确的提供程序,不会再抛出找不到Default提供程序的异常。
3. 有效性验证
调试时可以在注册页面的OnPostAsync方法中临时输出当前_userManager.Options.Tokens.ProviderMap的键值集合,确认存在Default、Email、Phone三个条目,且对应描述符的实现类型是具体的泛型实现类(而非抽象接口类型),即可确认配置生效。
内容的提问来源于stack exchange,提问作者AntimatterHedgehog
相关产品推荐
相关产品推荐

