ABP框架中将AppUser自定义属性BusinessId添加到Claims的实现问题

下面是3种可落地的实现思路，按实现复杂度从低到高排序：

方案1：实现IClaimsPrincipalContributor接口（最推荐，轻量无侵入） #

ABP框架提供了声明贡献者扩展点，会在每次构造用户ClaimsPrincipal时自动执行所有贡献者的逻辑，不需要修改任何框架默认服务，也不需要依赖UserManager相关组件：

• 直接实现IClaimsPrincipalContributor接口，代码示例如下：

public class BusinessIdClaimsContributor : IClaimsPrincipalContributor, ITransientDependency
{
    public async Task ContributeAsync(ClaimsPrincipalContributorContext context)
    {
        var currentUser = context.ServiceProvider.GetRequiredService<ICurrentUser>();
        // 未登录用户直接跳过
        if (!currentUser.Id.HasValue)
        {
            return;
        }
        // 直接注入AppUser的泛型仓储，可直接访问所有自定义字段
        var appUserRepo = context.ServiceProvider.GetRequiredService<IRepository<AppUser, Guid>>();
        var appUser = await appUserRepo.GetAsync(currentUser.Id.Value);
        
        // 给当前身份添加自定义声明
        var identity = context.ClaimsPrincipal.Identities.FirstOrDefault();
        identity?.AddClaim(new Claim("business_id", appUser.BusinessId.ToString()));
    }
}

• 优点：无需额外配置，ABP会自动扫描注册该贡献者，JWT令牌、Cookie身份验证场景都适用，不需要改动用户创建、登录逻辑。
• 优化建议：如果访问量较高，可以给BusinessId加分布式缓存，避免每次请求都查库。

方案2：自定义AppUser专属的UserManager #

如果需要在用户创建、更新等环节操作自定义属性，不用自己实现IUserStore等依赖，直接继承ABP已经实现的基础类即可：

• 自定义AppUserManager继承IdentityUserManager<AppUser>，ABP已经内置了AppUser对应的存储实现，直接注入构造参数即可：

public class AppUserManager : IdentityUserManager<AppUser>, ITransientDependency
{
    public AppUserManager(
        IdentityUserStore<AppUser, IIdentityUserRepository> store,
        IOptions<IdentityOptions> optionsAccessor,
        IPasswordHasher<AppUser> passwordHasher,
        IEnumerable<IUserValidator<AppUser>> userValidators,
        IEnumerable<IPasswordValidator<AppUser>> passwordValidators,
        ILookupNormalizer keyNormalizer,
        IdentityErrorDescriber errors,
        IServiceProvider services,
        ILogger<AppUserManager> logger) 
        : base(store, optionsAccessor, passwordHasher, userValidators, passwordValidators, keyNormalizer, errors, services, logger)
    {
    }
}

• 后续直接注入AppUserManager即可访问AppUser的所有自定义属性，调用内置的AddClaimAsync方法就可以把business_id声明持久化到AbpUserClaims表中，后续生成身份时会自动带出该声明。

方案3：扩展用户创建/更新逻辑 #

如果需要把自定义声明持久化存储，可以重写用户创建、更新的服务逻辑：

• 重写IdentityUserAppService的CreateAsync、UpdateAsync方法，在用户数据保存后，直接通过AppUser的仓储拿到自定义属性，调用IIdentityUserClaimRepository直接插入声明记录即可。
• 该方案适合需要固定声明、不需要每次动态生成的场景。

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