答案是依赖注入通过内置容器实现服务的松耦合管理。在Program.cs中注册Scoped、Singleton、Transient生命周期的服务,推荐面向接口编程,在控制器构造函数中注入依赖,注意避免Singleton服务中直接引用Scoped/Transient服务,必要时可通过IServiceProvider手动获取实例,正确使用可提升代码可维护性和测试性。

在 ASP.NET Core 中,依赖注入(Dependency Injection, DI)是框架内置的核心功能之一。它帮助开发者实现松耦合、可测试和可维护的代码结构。下面通过实际示例说明如何在 C# 的 ASP.NET Core 项目中正确使用依赖注入。
什么是依赖注入
依赖注入是一种设计模式,用于将对象的创建和使用分离。类不再自己创建依赖项,而是由外部容器“注入”所需的服务。ASP.NET Core 内置了一个轻量级的服务容器,可以自动管理服务的生命周期并注入到控制器、中间件或其他服务中。
注册服务到依赖注入容器
在 Program.cs 文件中,你可以通过 builder.Services 将服务添加到容器中。常见的注册方式有三种:
- Scoped:每次 HTTP 请求创建一个实例
- Singleton:整个应用生命周期内只创建一个实例
- Transient:每次请求服务时都创建新实例
// Program.cs
var builder = WebApplication.CreateBuilder(args);
// 添加服务到容器
builder.Services.AddScoped
builder.Services.AddSingleton
builder.Services.AddTransient
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
定义接口与实现类
为了更好地使用 DI,推荐面向接口编程。例如:
public interface IUserService
{
string GetUserName(int id);
}
public class UserService : IUserService
{
public string GetUserName(int id)
{
return $"用户_{id}";
}
}
然后在控制器中直接注入:
[ApiController]
[Route("[controller]")]
public class UserController : ControllerBase
{
private readonly IUserService _userService;
public UserController(IUserService userService)
{
_userService = userService;
}
[HttpGet("{id}")]
public IActionResult Get(int id)
{
var name = _userService.GetUserName(id);
return Ok(new { Id = id, Name = name });
} }
服务生命周期注意事项
选择合适的生命周期很重要,错误使用可能导致内存泄漏或数据错乱:
- 数据库上下文通常注册为 Scoped
- 全局配置缓存适合用 Singleton
- 轻量级、无状态工具类可用 Transient
注意:不要在 Singleton 服务中注入 Scoped 或 Transient 服务,除非你手动控制其作用域,否则可能引发意外行为。
从容器中获取服务(不推荐常规使用)
大多数情况下应通过构造函数注入。但在某些场景(如中间件、静态上下文),可以使用服务提供者:
using (var scope = app.Services.CreateScope())
{
var userService = scope.ServiceProvider.GetService
var name = userService?.GetUserName(1);
}
基本上就这些。掌握好依赖注入,能让你的 ASP.NET Core 应用更清晰、更易扩展。









