C# ASP.NET Core泛型仓储类型转换异常解决方案咨询

问题根源 #

IGenericSecretRepository<T> 默认是不变泛型接口，即便 T 继承自 SecretBase，IGenericSecretRepository<T> 也无法直接转换为 IGenericSecretRepository<SecretBase>，这就是 InvalidCastException 的核心原因。

方案1：通过协变接口实现安全转换（优先推荐） #

如果你的泛型接口仅将 T 作为返回值（无接收 T 作为参数的方法），可以将接口声明为协变，从而支持子类泛型接口向父类泛型接口的转换。

步骤1：修改泛型接口为协变

// 给泛型参数T添加out关键字，声明为协变接口
public interface IGenericSecretRepository<out T> where T : SecretBase
{
    T GetById(int id);
    // 注意：不能有诸如 void Add(T entity) 这类接收T作为参数的方法
}

步骤2：建立名称与Secret类型的映射

手动或通过反射构建名称到具体 Secret 类型的映射：

// 手动维护映射（如果类型固定）
private static readonly Dictionary<string, Type> _secretTypeMap = new()
{
    {"UserSecret", typeof(UserSecret)},
    {"OrderSecret", typeof(OrderSecret)},
    // 补充剩余52个类型映射
};

// 或通过反射自动构建（推荐，避免手动维护）
private static Dictionary<string, Type> BuildSecretTypeMap()
{
    var map = new Dictionary<string, Type>();
    var assembly = Assembly.GetExecutingAssembly();
    
    // 扫描所有实现IGenericSecretRepository<T>的仓储类，提取对应的T类型
    var repositoryTypes = assembly.GetTypes()
        .Where(t => !t.IsAbstract && !t.IsInterface)
        .Select(t => new
        {
            RepositoryType = t,
            GenericInterface = t.GetInterfaces().FirstOrDefault(i => 
                i.IsGenericType && i.GetGenericTypeDefinition() == typeof(IGenericSecretRepository<>))
        })
        .Where(x => x.GenericInterface != null);

    foreach (var rt in repositoryTypes)
    {
        var secretType = rt.GenericInterface.GetGenericArguments()[0];
        // 以Secret类型名称作为映射key，可自定义规则
        map[secretType.Name] = secretType;
    }
    return map;
}

步骤3：从DI容器获取并转换实例

利用ASP.NET Core的依赖注入容器，根据名称获取对应仓储实例，再通过协变接口安全转换：

public IGenericSecretRepository<SecretBase> GetRepositoryByName(string name, IServiceProvider serviceProvider)
{
    var typeMap = BuildSecretTypeMap(); // 或直接使用预定义的_secretTypeMap
    if (!typeMap.TryGetValue(name, out var secretType))
        throw new ArgumentException($"不存在名为 {name} 的Secret类型", nameof(name));

    // 构造泛型接口类型
    var repositoryInterfaceType = typeof(IGenericSecretRepository<>).MakeGenericType(secretType);
    // 从DI获取实例
    var repository = serviceProvider.GetService(repositoryInterfaceType);
    
    // 协变接口支持安全转换
    return repository as IGenericSecretRepository<SecretBase>;
}

方案2：引入非泛型基接口（兼容有输入参数的接口） #

如果你的泛型接口包含接收 T 作为参数的方法（无法使用协变），可以定义一个非泛型基接口，统一操作入口。

步骤1：定义非泛型基接口

public interface ISecretRepository
{
    // 声明所有需要的通用操作，返回父类SecretBase
    SecretBase GetById(int id);
    // 如需新增通用方法，在这里补充
}

步骤2：让泛型接口继承非泛型接口

public interface IGenericSecretRepository<T> : ISecretRepository where T : SecretBase
{
    // 重写方法返回具体T类型
    new T GetById(int id);
    // 现在可以保留接收T的方法
    void Add(T entity);
}

步骤3：仓储类显式实现非泛型接口

public class UserSecretRepository : IGenericSecretRepository<UserSecret>
{
    // 实现泛型接口的方法，返回具体类型
    public UserSecret GetById(int id)
    {
        // 具体业务逻辑
    }

    // 显式实现非泛型接口，适配父类返回值
    SecretBase ISecretRepository.GetById(int id)
    {
        return GetById(id);
    }

    public void Add(UserSecret entity)
    {
        // 具体业务逻辑
    }
}

步骤4：通过非泛型接口获取实例

public ISecretRepository GetRepositoryByName(string name, IServiceProvider serviceProvider)
{
    var typeMap = BuildSecretTypeMap();
    if (!typeMap.TryGetValue(name, out var secretType))
        throw new ArgumentException($"不存在名为 {name} 的Secret类型", nameof(name));

    var repositoryInterfaceType = typeof(IGenericSecretRepository<>).MakeGenericType(secretType);
    return serviceProvider.GetService(repositoryInterfaceType) as ISecretRepository;
}

辅助：批量注册仓储到DI容器 #

避免手动注册54个仓储类，可通过反射批量注册：

// 在Program.cs的DI配置中
var assembly = Assembly.GetExecutingAssembly();
var repositoryTypes = assembly.GetTypes()
    .Where(t => !t.IsAbstract && !t.IsInterface)
    .Select(t => new
    {
        ImplementationType = t,
        ServiceType = t.GetInterfaces().FirstOrDefault(i => 
            i.IsGenericType && i.GetGenericTypeDefinition() == typeof(IGenericSecretRepository<>))
    })
    .Where(x => x.ServiceType != null);

foreach (var rt in repositoryTypes)
{
    builder.Services.AddScoped(rt.ServiceType, rt.ImplementationType);
}

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