ASP.NET Core WebAPI中如何在Startup.cs注册泛型接口

这问题我之前碰过好多次，核心就是要跳出非泛型的注册思维，学会注册开放泛型类型。

首先先确认你的泛型接口和对应的实现类结构应该是类似这样的（举个示例）：

// 泛型接口定义
public interface IApiKeysService<T>
{
    Task<T> GetValidApiKeyAsync(string keyId);
}

// 对应的泛型实现类
public class ApiKeysService<T> : IApiKeysService<T>
{
    // 这里是你的业务逻辑实现
    public async Task<T> GetValidApiKeyAsync(string keyId)
    {
        // 示例逻辑，根据你的实际需求替换
        return default(T);
    }
}

接下来就是关键的注册步骤了，你不能直接写IApiKeysService<T>或者单独注册接口，而是要使用typeof()传入开放泛型类型：

// 在Startup.cs的ConfigureServices方法中完成注册
services.AddScoped(typeof(IApiKeysService<>), typeof(ApiKeysService<>));

为什么这样能行？ #

这里的IApiKeysService<>和ApiKeysService<>是开放泛型的写法，意思是告诉DI容器：“不管后续请求的是IApiKeysService<string>、IApiKeysService<MyCustomModel>还是其他具体泛型实例，你都自动用对应的ApiKeysService<具体类型>来创建实例”。完美解决了你没法提前指定具体T的问题。

怎么使用注册好的服务？ #

当你在控制器或者其他服务里需要使用时，直接在构造函数中注入具体的泛型版本就行，DI容器会自动帮你匹配对应的实现：

[ApiController]
[Route("api/[controller]")]
public class KeysController : ControllerBase
{
    private readonly IApiKeysService<MyCustomKeyModel> _apiKeysService;

    // 构造函数注入具体的泛型实例
    public KeysController(IApiKeysService<MyCustomKeyModel> apiKeysService)
    {
        _apiKeysService = apiKeysService;
    }

    [HttpGet("{keyId}")]
    public async Task<IActionResult> GetKey(string keyId)
    {
        var key = await _apiKeysService.GetValidApiKeyAsync(keyId);
        return Ok(key);
    }
}

避坑提醒 #

• 别尝试写services.AddScoped<IApiKeysService<T>>()：这里的T在Startup.cs中是未定义的类型参数，编译器必然报错
• 别只注册接口不指定实现类：services.AddScoped<IApiKeysService<>>()这种写法无效，DI容器不知道该用哪个类来实现这个接口

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