C# 依赖注入作用域方法 C# Singleton、Scoped和Transient的区别

来源:这里教程网 时间:2026-02-21 17:39:51 作者:

Singleton 实例在容器生命周期内只创建一次

当你注册为

Singleton
,DI 容器会在第一次请求该服务时创建实例,并一直复用它——哪怕跨多个 HTTP 请求、跨线程、跨作用域。这意味着所有地方拿到的都是同一个对象引用。

适合无状态工具类(如日志记录器

ILogger
)、配置读取器、或需要全局共享状态的组件(比如缓存管理器)。但要注意:如果它内部持有可变状态且没做线程同步,多线程下容易出错。

注册方式:
services.AddSingleton<imyservice myservice>()</imyservice>
不推荐用于依赖
Scoped
服务(如 EF Core 的
DbContext
),否则会引发“Cannot resolve scoped service from root provider”错误
构造函数注入的
Scoped
Transient
服务,在
Singleton
中只会被解析一次(即“快照式绑定”)

Scoped 实例按作用域边界创建,常见于 Web 请求生命周期

ASP.NET Core 默认每个 HTTP 请求就是一个

Scoped
作用域。同一请求内多次
GetRequiredService<t>()</t>
拿到的是同一个实例;不同请求之间则各自独立。

这是 EF Core 的

DbContext
默认注册方式的原因:保证一个请求内数据库操作共享上下文,又避免跨请求状态污染。

注册方式:
services.AddScoped<imyservice myservice>()</imyservice>
在非托管作用域(如后台任务、
Task.Run
)中直接从根容器解析
Scoped
服务会失败,报错:
Cannot resolve scoped service from root provider
若需在后台任务中使用,必须手动创建作用域:
using var scope = app.Services.CreateScope(); scope.ServiceProvider.GetRequiredService<imyservice>()</imyservice>

Transient 每次请求都新建实例,无共享状态

Transient
是最轻量的生命周期,每次调用
GetRequiredService
或构造函数注入时都会 new 一个新对象。没有复用,也没有隐式状态传递风险。

适合无状态、开销小、或需要隔离数据的类型,比如 DTO 映射器、计算工具类、或单元测试中的模拟对象。

注册方式:
services.AddTransient<imyservice myservice>()</imyservice>
性能上比
Scoped
Singleton
略低(对象分配 + GC 压力),但多数场景可忽略
可以安全注入到任何生命周期的服务中(包括
Singleton
),但要注意:如果
Singleton
持有
Transient
实例,那个实例就变成“伪单例”了——它不会更新,也不会重新创建

DI 容器解析失败时的典型错误信息和排查点

最常见的报错是

InvalidOperationException: Cannot resolve scoped service 'MyApp.IDbContext' from root provider.
,本质是试图在没有作用域的上下文中(如静态方法、HostedService 构造函数)直接解析
Scoped
服务。

检查调用栈:是否在
IHostedService.StartAsync
Program.cs
顶层代码、或静态工厂方法里用了
app.Services.GetService<t>()</t>
确认服务注册顺序:后注册的覆盖先注册的,但生命周期不能降级(比如先
AddScoped
AddSingleton
会生效后者)
调试技巧:在服务构造函数里加日志或断点,观察调用次数和线程 ID,能快速识别生命周期是否符合预期 实际项目里最容易被忽略的,是
Singleton
类型中悄悄持有了
Scoped
服务的引用——它不会编译报错,但运行时可能因上下文已释放而抛出
ObjectDisposedException

相关推荐