用途:为 .NET 10 项目提供依赖注入(DI)的实践规范与模式参考,帮助开发者正确注册与解析服务。
核心原则:默认使用构造函数注入(主构造函数更简洁),不使用服务定位器或属性注入;注册接口而非具体类型,如 services.AddScoped<IOrderService, OrderService>();生命周期必须匹配,单例不得依赖作用域或瞬态服务,这是最常见的 DI 缺陷。
主要能力与模式:
- 键控服务(.NET 8+):用 AddKeyedScoped 注册同一接口的多个实现,通过 [FromKeyedServices("email")] 特性或 IServiceProvider.GetRequiredKeyedService 解析,替代手写工厂。
- 装饰器模式:定义接口与基础实现后,用 LoggingOrderService 等装饰类包裹,配合 Scrutor 的 Decorate<IOrderService, LoggingOrderService>() 注册,用于日志等横切关注点。
- 约定注册(Scrutor):通过 Scan 按程序集与接口约定批量注册,并指定 Transient 或 Scoped 生命周期。
- 工厂模式:用 AddScoped 委托结合配置与 ActivatorUtilities.CreateInstance 在运行时选择实现。
- 选项注册:AddOptions<JwtOptions>().BindConfiguration("Jwt").ValidateDataAnnotations().ValidateOnStart(),以 IOptions<T> 注入。
反模式:单例中捕获作用域服务(如 DbContext)会导致内存泄漏与数据陈旧,应改用 IServiceScopeFactory 创建作用域;不要把所有服务都注册为单例,有可变状态或依赖 DbContext 的服务应使用 Scoped。
决策参考:无状态服务用 Scoped 或 Transient;配置与缓存用 Singleton;DbContext 用 Scoped;多实现用键控服务;横切行为用装饰器;约定注册用 Scrutor;运行时选择用工厂委托;强类型配置用 AddOptions<T>().BindConfiguration()。
限制:资料未提供具体版本兼容范围、性能数据或完整项目示例,实际使用需结合项目验证。