一文搞懂.NET 中的依赖注入:软件工程师的秘密武器

想象一下正在组装一台台式电脑：CPU 并非直接焊接在主板上，而是通过插槽固定。这样做的好处显而易见——当需要升级处理器或更换故障部件时，无需更换整块主板，只需轻轻松开卡扣即可完成替换。

在软件工程中，依赖注入（Dependency Injection，DI）正是这个“CPU 插槽”。对于 .NET 应用开发而言，依赖注入不仅是“锦上添花”的设计模式，更是框架的核心组成部分。本文将系统解析依赖注入的本质、价值及在 .NET 中的最佳实践①。

依赖注入的本质：控制反转

在讨论“注入”之前，先理解“依赖”的含义。若类 A 需要类 B 协作完成任务，则 A 依赖 B，B 即为依赖项。

传统方式：紧耦合的陷阱

publicclassComputer{private Cpu _cpu;publicComputer()    {// 问题：Computer 被硬编码绑定到 IntelCoreI7，无法替换this._cpu = new IntelCoreI7();     }}

此设计中，Computer 直接创建 IntelCoreI7 实例，导致：

• 无法在不修改 Computer 代码的前提下更换 CPU 型号；
• 单元测试时需实例化真实 Cpu，难以隔离测试；
• 违反“开闭原则”，系统扩展性受限②。

依赖注入：控制反转的实现

publicclassComputer{privatereadonly ICpu _cpu;// 通过构造函数注入依赖，解耦具体实现publicComputer(ICpu cpu)    {        _cpu = cpu;    }}

此方式将对象创建责任从类内部转移到外部容器，实现控制反转（Inversion of Control, IoC）：

• Computer 仅依赖 ICpu 接口，不关心具体实现；
• 外部容器负责提供 ICpu 实例，支持灵活替换（Intel、AMD、Apple Silicon 随意切换）；
• 为单元测试、配置管理奠定基础③。

为何依赖注入至关重要？

1. 提升可维护性

当需要将 CPU 从 Intel Core i7 升级到 AMD Ryzen 9 时，无需修改 Computer 的代码，仅需调整依赖注册配置。这种“开闭原则”实践显著降低系统维护成本。

2. 增强可测试性（核心价值）

单元测试时，可注入模拟实现（Mock）替代真实依赖：

// 测试代码示例var mockCpu = new Mock<ICpu>();mockCpu.Setup(c => c.Execute()).Returns(true);var computer = new Computer(mockCpu.Object);// 测试 Computer 逻辑，无需运行真实 CPU 指令

此模式使测试聚焦于被测类本身，避免外部依赖干扰④。

3. 提升系统灵活性

需要将数据源从 SQL Server 切换至 MongoDB？仅需在依赖注册处调整一行代码：

// 原注册builder.Services.AddScoped<IDatabase, SqlDatabase>();// 新注册builder.Services.AddScoped<IDatabase, MongoDatabase>();

业务逻辑层无需任何修改，实现“一处配置，全局生效”⑤。

.NET 服务生命周期：三大核心模式

.NET 内置的依赖注入容器通过生命周期管理控制服务的创建与销毁。选错生命周期是 .NET DI 中最常见的缺陷来源，需深入理解三者差异：

1. Transient（瞬时）：AddTransient

工作机制：每次请求服务时创建全新实例。

// 注册builder.Services.AddTransient<ILogger, ConsoleLogger>();// 使用public class ServiceA(ILogger logger) { }public class ServiceB(ILogger logger) { }// ServiceA 与 ServiceB 获得的 logger 实例不同

适用场景：无状态、轻量级服务（如格式化工具、验证器）。

注意事项：频繁创建实例可能增加内存压力，避免用于持有状态的服务⑥。

2. Scoped（作用域）：AddScoped

工作机制：每个作用域（如 HTTP 请求）内创建单例，同一作用域内共享实例。

// 注册builder.Services.AddScoped<IOrderRepository, OrderRepository>();// 在同一个 HTTP 请求中public class OrderController(IOrderRepository repo1) { }public class OrderService(IOrderRepository repo2) { }// repo1 与 repo2 是同一实例

适用场景：请求级状态管理，如 Entity Framework Core 的 DbContext。

⚠️ 关键警告：切勿将 Scoped 服务注入 Singleton 服务，否则会导致捕获依赖（Captive Dependency）——Scoped 服务被永久持有，失去作用域隔离，可能引发数据库连接泄漏等严重问题⑦。

3. Singleton（单例）：AddSingleton

工作机制：首次请求时创建实例，应用生命周期内全局共享。

// 注册builder.Services.AddSingleton<ICacheService, MemoryCacheService>();// 所有请求共享同一缓存实例public class ProductController(ICacheService cache) { }

适用场景：全局配置、缓存服务、昂贵资源的复用。

注意事项：需确保线程安全，避免状态污染⑧。

实战：.NET Web API 中的依赖注入

步骤 1：定义契约与实现

// 接口定义publicinterfaceIEmailService{Task SendEmailAsync(string to, string subject, string body);}// 具体实现publicclassSendGridEmailService : IEmailService{privatereadonly HttpClient _httpClient;publicSendGridEmailService(HttpClient httpClient)    {        _httpClient = httpClient;    }publicasync Task SendEmailAsync(string to, string subject, string body)    {// 调用 SendGrid API 发送邮件await _httpClient.PostAsJsonAsync("https://api.sendgrid.com/v3/mail/send", new { to, subject, body });    }}

步骤 2：在 Program.cs 中注册服务

var builder = WebApplication.CreateBuilder(args);// 注册依赖：生命周期 + 实现类型builder.Services.AddScoped<IEmailService, SendGridEmailService>();// 可选：配置依赖的构造参数builder.Services.AddHttpClient<SendGridEmailService>(client =>{    client.BaseAddress = new Uri("https://api.sendgrid.com");    client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");});var app = builder.Build();

步骤 3：在控制器或端点中注入使用

// Minimal API 示例app.MapPost("/register", async (    RegisterRequest request,     IEmailService emailService) =>{// .NET 自动解析并注入 IEmailService 实现await emailService.SendEmailAsync(        request.Email, "欢迎注册", "感谢您的注册！");return Results.Ok(new { message = "注册成功" });});// Controller 示例[ApiController][Route("api/[controller]")]publicclassUserController : ControllerBase{privatereadonly IEmailService _emailService;// 构造函数注入publicUserController(IEmailService emailService)    {        _emailService = emailService;    }    [HttpPost("register")]publicasync Task<IActionResult> Register(RegisterRequest request)    {await _emailService.SendEmailAsync(request.Email, "欢迎", "谢谢");return Ok();    }}

高级实践：避免常见陷阱

1. 捕获依赖（Captive Dependency）

错误示例：

// ❌ 错误：Singleton 服务持有 Scoped 服务builder.Services.AddSingleton<ICacheManager, CacheManager>();builder.Services.AddScoped<IDatabase, SqlDatabase>();public class CacheManager(IDatabase db) { } // db 被永久持有！

解决方案：

• 避免在 Singleton 中直接注入 Scoped 服务；
• 如需使用，通过 IServiceScopeFactory 动态创建作用域：

public class CacheManager(IServiceScopeFactory scopeFactory){publicasync Task<T> GetAsync<T>(string key)    {usingvar scope = scopeFactory.CreateScope();var db = scope.ServiceProvider.GetRequiredService<IDatabase>();returnawait db.GetAsync<T>(key);    }}

2. 循环依赖

问题：ServiceA 依赖 ServiceB，ServiceB 又依赖 ServiceA，导致容器无法解析。

解决方案：

• 重构设计，提取公共接口；
• 使用 Lazy<T> 延迟解析；
• 采用事件驱动或中介者模式解耦⑨。

3. 过度注入

问题：构造函数参数过多，违反单一职责原则。

解决方案：

• 使用参数对象（Parameter Object）聚合相关依赖；
• 考虑使用 Facade 模式封装复杂依赖⑩。

结语

依赖注入不是学术概念，而是专业 .NET 应用的“粘合剂”。通过将对象创建责任从类内部转移到框架容器，开发者能够编写出易于变更、便于测试、支持扩展的代码。

下次编写新类时，请先思考：这个依赖应该由类自身创建，还是通过注入获得？答案往往决定了系统的长期可维护性。

★

💡 核心原则：

• 依赖接口而非实现；
• 通过构造函数注入必需依赖；
• 根据服务特性选择合适生命周期；
• 警惕捕获依赖等常见陷阱。

参考资料

① Microsoft. Dependency injection in ASP.NET Core. https://learn.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection② Martin Fowler. Inversion of Control Containers and the Dependency Injection pattern. https://martinfowler.com/articles/injection.html③ Microsoft. Service lifetimes in ASP.NET Core. https://learn.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection#service-lifetimes④ Roy Osherove. The Art of Unit Testing. Manning Publications, 2013.⑤ Microsoft. Best practices for dependency injection. https://learn.microsoft.com/en-us/dotnet/core/extensions/dependency-injection-guidelines⑥ Andrew Lock. Understanding Scoped services in ASP.NET Core. https://andrewlock.net/understanding-scoped-services-in-asp-net-core/⑦ Microsoft. Captive dependency detection. https://learn.microsoft.com/en-us/dotnet/core/extensions/dependency-injection-guidelines#disposable-transient-services-captured-by-container⑧ Ben Watson. Writing High-Performance .NET Code. 2nd ed., 2018.⑨ Mark Seemann. Dependency Injection in .NET. Manning Publications, 2019.⑩ Steve Smith. Avoiding Over-Injection in ASP.NET Core. https://ardalis.com/avoiding-over-injection-in-asp-net-core/