ASP.NET Core7迁移遇Error CS0535：ApplicationUserManager未实现接口成员

问题场景 #

• 开发环境：ASP.NET Core 7，采用洋葱架构
• 问题现象：从.NET Core 5迁移后，ApplicationUserManager类实现IApplicationUserManager接口时触发编译错误CS0535 'ApplicationUserManager' does not implement interface member 'IApplicationUserManager.NormalizeKey(string)'，相同实现逻辑在.NET Core 5的MVC架构下可正常运行。

代码示例 #

接口定义 IApplicationUserManager #

public interface IApplicationUserManager
{
    // 其他接口成员
    string NormalizeKey(string key);
    // 其他接口成员
}

实现类 ApplicationUserManager（迁移前Core5版本） #

public class ApplicationUserManager : UserManager<ApplicationUser>, IApplicationUserManager
{
    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)
    {
    }

    // 其他自定义实现，未显式实现NormalizeKey
}

问题原因 #

ASP.NET Core Identity从.NET Core 5到7的版本更新中，UserManager<TUser>基类的NormalizeKey方法签名发生了变化：

• Core5中该方法签名为 public virtual string NormalizeKey(string key)
• Core7中更新为 public virtual string? NormalizeKey(string? key)（引入了可空引用类型修饰符）

由于接口IApplicationUserManager仍沿用旧的签名（无?修饰符），导致基类的方法不再被编译器识别为接口成员的实现，触发CS0535错误。

解决方法 #

方法1：显式实现接口成员 #

在ApplicationUserManager中显式实现IApplicationUserManager的NormalizeKey方法，处理签名匹配问题：

public class ApplicationUserManager : UserManager<ApplicationUser>, IApplicationUserManager
{
    // 构造函数保持不变

    string IApplicationUserManager.NormalizeKey(string key)
    {
        // 调用基类方法并处理可空返回值
        return base.NormalizeKey(key) ?? string.Empty;
    }

    // 其他自定义实现
}

方法2：更新接口签名匹配Core7标准 #

如果业务允许，修改IApplicationUserManager的接口定义，使其与Core7中UserManager<TUser>的方法签名一致：

public interface IApplicationUserManager
{
    // 其他接口成员
    string? NormalizeKey(string? key);
    // 其他接口成员
}

修改后，基类的NormalizeKey方法会自动匹配接口成员，无需额外显式实现。

方法3：检查一致性细节 #

• 确认接口与实现类的命名空间无冲突，确保引用的是同一个IApplicationUserManager定义
• 核对方法的参数名称、返回值类型（包括可空修饰符）完全一致

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