依赖注入（Dependency Injection，简称DI）是控制反转（IoC）思想的一种具体实现方式，核心是将对象的依赖关系由外部容器来管理和注入，而不是在对象内部自行创建依赖实例。在C#的ASP.NET Core框架中，依赖注入是原生支持的功能，整个框架的很多组件都基于DI构建，掌握其使用方法对开发ASP.NET Core项目至关重要。
依赖注入的基本概念
在理解具体实现之前，需要先明确几个核心概念：
- 服务：指需要被注册到DI容器中的类型，通常是接口及其对应的实现类，也可以是具体的类。
- DI容器：负责管理服务的注册、创建和生命周期的组件，ASP.NET Core中内置的容器是IServiceProvider接口的实现。
- 服务生命周期：指服务实例在容器中的存活时长，ASP.NET Core支持三种生命周期：瞬态、作用域、单例。
ASP.NET Core中注册服务到DI容器
服务的注册通常在项目的Program.cs文件中完成，ASP.NET Core 6及以上版本使用顶级语句，注册逻辑写在WebApplication构建之前。首先需要定义服务对应的接口和实现类，示例如下：
// 定义服务接口
public interface IUserService
{
string GetUserName(int userId);
}
// 定义服务实现类
public class UserService : IUserService
{
public string GetUserName(int userId)
{
// 模拟从数据库获取用户名称的逻辑
return $"用户{userId}";
}
}
接下来在Program.cs中注册该服务，根据需求选择不同的生命周期：
var builder = WebApplication.CreateBuilder(args); // 瞬态生命周期：每次请求服务时都会创建新的实例 builder.Services.AddTransient<IUserService, UserService>(); // 作用域生命周期：每个请求范围内创建同一个实例，不同请求之间实例不同 // builder.Services.AddScoped<IUserService, UserService>(); // 单例生命周期：整个应用程序生命周期内只创建一个实例 // builder.Services.AddSingleton<IUserService, UserService>(); var app = builder.Build(); // 其他中间件配置逻辑 app.MapControllers(); app.Run();
三种生命周期的选择需要根据实际场景决定：如果服务是无状态的，且不需要保持状态，优先选择瞬态；如果服务需要和请求上下文关联，比如数据库上下文，通常使用作用域；如果服务是全局共享的，比如配置类、缓存类，适合使用单例。
在ASP.NET Core中注入服务
服务注册完成后，就可以在需要使用的组件中通过构造函数注入的方式获取服务实例，这是ASP.NET Core中最推荐的注入方式。
在控制器中注入服务
控制器的构造函数中声明需要依赖的服务接口，容器会自动将对应的实例注入进来：
[ApiController]
[Route("api/[controller]")]
public class UserController : ControllerBase
{
private readonly IUserService _userService;
// 构造函数注入，容器自动匹配注册的服务实例
public UserController(IUserService userService)
{
_userService = userService;
}
[HttpGet("{id}")]
public string GetUserName(int id)
{
return _userService.GetUserName(id);
}
}
在其他服务中注入服务
如果自定义的服务也需要依赖其他服务，同样可以通过构造函数注入的方式实现，前提是当前服务本身也已经注册到DI容器中：
// 定义另一个服务接口
public interface IOrderService
{
string GetOrderInfo(int orderId);
}
// 实现类依赖IUserService
public class OrderService : IOrderService
{
private readonly IUserService _userService;
public OrderService(IUserService userService)
{
_userService = userService;
}
public string GetOrderInfo(int orderId)
{
// 使用注入的IUserService实例
var userName = _userService.GetUserName(1);
return $"订单{orderId}属于{userName}";
}
}
之后将IOrderService也注册到容器中，就可以在控制器中同时注入IOrderService和IUserService使用：
// 注册IOrderService，这里使用瞬态生命周期 builder.Services.AddTransient<IOrderService, OrderService>();
其他注入方式说明
除了构造函数注入之外，ASP.NET Core还支持从HttpContext中获取服务，或者使用[FromServices]特性直接在接口方法的参数中注入，但这些方式都不如构造函数注入直观，也不利于单元测试，因此实际开发中更推荐使用构造函数注入。
如果是需要从HttpContext中获取服务，示例代码如下：
[HttpGet("get-service")]
public string GetServiceFromContext()
{
// 从HttpContext的请求服务中获取IUserService实例
var userService = HttpContext.RequestServices.GetRequiredService<IUserService>();
return userService.GetUserName(2);
}
需要注意的是，通过RequestServices获取的服务，其生命周期和当前请求的作用域绑定，如果是单例服务，仍然会返回全局唯一的实例。
常见问题与注意事项
- 服务注册的顺序不影响注入的结果，只要服务已经被注册到容器中，就可以正常注入。
- 避免出现循环依赖的情况，比如服务A依赖服务B，服务B又依赖服务A，这种情况会导致容器创建实例时抛出异常。
- 如果注入的服务是作用域生命周期，不要在单例服务中直接注入，否则会导致作用域服务变成单例，或者引发作用域相关的异常。
- 注册服务时，如果实现类有带参数的构造函数，只要构造函数的参数对应的服务也已经注册到容器中，容器会自动处理参数的注入。
依赖注入的核心目的是解耦，不要为了使用DI而过度设计，对于简单的、无依赖的类，不需要强制注册到容器中，可以直接实例化使用。
C#依赖注入ASP.NET_CoreDI容器修改时间：2026-06-30 15:03:33