在C#中实现依赖注入(DI),核心是用 IServiceCollection 注册服务,再通过 ServiceProvider 解析使用。.NET 6+ 默认内置了轻量级 DI 容器,无需额外引用第三方库就能完成绝大多数场景的配置。
基础服务注册方式
注册服务有三种生命周期模式,对应不同使用场景:
Transient(瞬时):每次请求都新建实例,适合无状态、轻量对象,如工具类、DTO映射器 Scoped(作用域):每个请求(HTTP上下文)内共享一个实例,常用于数据库上下文(DbContext) Singleton(单例):整个应用生命周期只创建一次,适合配置管理器、缓存客户端等示例代码:
var builder = WebApplication.CreateBuilder(args); // 接口 IEmailService → 实现类 SmtpEmailService builder.Services.AddTransient<IEmailService, SmtpEmailService>(); builder.Services.AddScoped<AppDbContext>(); // 默认构造函数自动解析 builder.Services.AddSingleton<ICacheProvider, RedisCacheProvider>();
带参数或工厂模式的注册
当构造函数需要运行时参数,或需自定义初始化逻辑时,用工厂委托注册:
// 传入配置值
builder.Services.AddSingleton<IConfigReader>(sp =>
new JsonConfigReader("appsettings.json"));
// 基于其他已注册服务构建
builder.Services.AddScoped<IOrderService>(sp => {
var logger = sp.GetRequiredService<ILogger<OrderService>>();
var db = sp.GetRequiredService<AppDbContext>();
return new OrderService(logger, db);
});
在控制器或服务中使用依赖
只要类构造函数参数类型已在 DI 容器中注册,框架会自动注入:
public class OrdersController : ControllerBase
{
private readonly IOrderService _orderService;
private readonly ILogger<OrdersController> _logger;
public OrdersController(IOrderService orderService, ILogger<OrdersController> logger)
{
_orderService = orderService;
_logger = logger;
}
[HttpGet]
public async Task<IActionResult> Get() => Ok(await _orderService.GetAll());
}
注意:不要手动 new 对象,也不要直接调用
ServiceProvider.GetService()—— 这会破坏可测试性和生命周期管理。
扩展方法封装常用注册逻辑
把重复的注册逻辑抽成扩展方法,提高可读性和复用性:
public static class ServiceCollectionExtensions
{
public static IServiceCollection AddEmailServices(this IServiceCollection services)
{
services.AddTransient<IEmailSender, SmtpSender>();
services.AddSingleton<IEmailTemplateEngine, RazorTemplateEngine>();
return services;
}
}
// 使用时一行搞定
builder.Services.AddEmailServices();
基本上就这些。不复杂但容易忽略的是生命周期匹配——比如把 DbContext 注成 Transient 可能引发连接泄漏,而误设为 Singleton 则导致并发异常。按需选择,别硬套。
