C# 容器实例生命周期

在 C#(特别是结合 .NET 的依赖注入容器,如 ASP.NET Core 内置的 DI 容器)中,服务(或组件)的生命周期主要有三种:Transient(瞬态)Scoped(作用域)Singleton(单例)。这些生命周期决定了服务实例何时被创建、重用以及销毁。

以下是它们的区别和适用场景:


1. Transient(瞬态)

  • 每次请求都创建一个新实例
  • 适用于轻量级、无状态的服务。
  • 优点:隔离性好,不会因状态共享引发问题。
  • 缺点:频繁创建/销毁可能影响性能(尤其对重量级对象)。
csharp 复制代码
services.AddTransient<IMyService, MyService>();

每次从 DI 容器解析 IMyService 时,都会返回一个全新的 MyService 实例。


2. Scoped(作用域)

  • 在同一个作用域内共享同一个实例,不同作用域使用不同实例。
  • ASP.NET Core 中,一个 HTTP 请求就是一个作用域
  • 适用于需要在一次请求中共享状态的服务(如数据库上下文 DbContext)。
csharp 复制代码
services.AddScoped<IMyService, MyService>();

在同一个 HTTP 请求中多次解析 IMyService,会得到同一个实例;但在不同请求中会得到不同实例。

⚠️ 注意:在非 Web 应用(如控制台程序)中,需要手动创建作用域(通过 IServiceScopeFactory)才能体现 Scoped 行为。


3. Singleton(单例)

  • 整个应用程序生命周期内只创建一个实例,所有请求共享该实例。
  • 适用于全局共享、无状态或线程安全的服务。
  • 优点:节省资源,避免重复初始化。
  • 风险:如果服务持有可变状态,需确保线程安全。
csharp 复制代码
services.AddSingleton<IMyService, MyService>();

整个应用运行期间,无论多少次解析 IMyService,都返回同一个实例。


对比总结

生命周期 创建时机 实例数量 适用场景
Transient 每次请求时 每次都新实例 轻量、无状态、临时对象
Scoped 每个作用域首次请求时 每个作用域一个实例 Web 请求内共享(如 DbContext)
Singleton 首次请求时(或启动时) 全局唯一实例 全局配置、缓存、日志等

补充说明

  • 不能从短生命周期服务注入长生命周期服务(例如:Singleton 服务中注入 Scoped 服务是危险的,因为 Scoped 服务可能依赖于请求上下文,而 Singleton 存活时间更长,会导致"捕获作用域外服务"的异常)。
  • 反之,长生命周期可以安全地注入短生命周期服务(但通常不推荐,因为短生命周期服务可能无法按预期工作)。

示例(ASP.NET Core)

csharp 复制代码
// Program.cs 或 Startup.cs
builder.Services.AddTransient<IOperationTransient, Operation>();
builder.Services.AddScoped<IOperationScoped, Operation>();
builder.Services.AddSingleton<IOperationSingleton, Operation>();

配合一个测试控制器,你可以观察到 GUID(代表实例 ID)的变化情况,验证不同生命周期的行为。


如有使用第三方容器(如 Autofac、Unity 等),概念类似,但 API 可能略有不同。不过 ASP.NET Core 默认 DI 容器已能满足大多数场景。

相关推荐
程序设计实验室9 小时前
C# 扩展方法只会写 this 吗?C# 14 新语法直接把扩展方法玩出了花
c#
唐青枫11 小时前
C#.NET SignalR 深入解析:实时通信、Hub 与连接管理实战
c#·.net
唐宋元明清218817 小时前
.NET Win32磁盘动态卷/跨区卷触发“函数不正确”问题排查
windows·c#·存储
hez201018 小时前
Satori GC:同时做到高吞吐、低延时和低内存占用
c#·.net·.net core·gc·clr
唐青枫1 天前
C#.NET Channel 深入解析:高性能异步生产者消费者模型实战
c#·.net
小峥降临2 天前
Rokid UXR 的手势追踪虚拟中更真实的手实战开发【含 工程源码 和 最终完成APK】
c#
晨星shine6 天前
GC、Dispose、Unmanaged Resource 和 Managed Resource
后端·c#
用户298698530146 天前
.NET 文档自动化:Spire.Doc 设置奇偶页页眉/页脚的最佳实践
后端·c#·.net
用户3667462526746 天前
接口文档汇总 - 2.设备状态管理
c#
用户3667462526746 天前
接口文档汇总 - 3.PLC通信管理
c#