当前位置：首页 > news >正文

Scrutor实战：5分钟搞定.NET依赖注入的批量注册与装饰器模式

news 2026/5/12 1:08:41

Scrutor实战：5分钟掌握.NET依赖注入的高级技巧

在.NET生态中，依赖注入(DI)已经成为现代应用程序开发的基石。然而随着项目规模扩大，手动注册成百上千的服务不仅耗时耗力，还容易出错。这正是Scrutor大显身手的时刻——这个轻量级库能让你用最优雅的方式解决批量注册难题，同时解锁装饰器模式等高级特性。

1. Scrutor核心功能解析

Scrutor并非替代.NET内置的DI容器，而是为其添加了程序集扫描和智能注册能力。它通过扩展方法的形式无缝集成到IServiceCollection中，主要解决三类问题：

批量服务注册：自动发现并注册程序集中的接口与实现类
条件筛选：基于命名规则、特性标记等条件过滤需要注册的类型
装饰器增强：在不修改原有类的情况下，通过装饰器添加横切关注点

典型的应用场景包括：

// 传统手动注册方式 services.AddTransient<IMyService, MyService>(); services.AddScoped<IOrderService, OrderService>(); // ...其他数十个类似注册 // 使用Scrutor后的等效操作 services.Scan(scan => scan .FromAssemblyOf<Startup>() .AddClasses() .AsMatchingInterface());

2. 五分钟快速上手指南

2.1 环境准备

首先通过NuGet安装Scrutor：

dotnet add package Scrutor

2.2 基础批量注册

假设我们有以下服务结构：

public interface IDataProcessor { void Process(); } public class SqlDataProcessor : IDataProcessor { /* 实现 */ } public class NoSqlDataProcessor : IDataProcessor { /* 实现 */ }

传统方式需要逐个注册，而Scrutor只需：

services.Scan(scan => scan .FromAssemblyOf<IDataProcessor>() .AddClasses(classes => classes.AssignableTo<IDataProcessor>()) .AsImplementedInterfaces() .WithScopedLifetime());

2.3 高级筛选技巧

Scrutor支持多种筛选条件组合：

筛选条件	示例代码	适用场景
命名约定	`.Where(t => t.Name.EndsWith("Repo"))`	遵循特定命名规范的项目
特性标记	`.Where(t => t.IsDefined(typeof(ExportAttribute)))`	需要显式标记的服务
继承关系	`.AssignableTo<BaseService>()`	具有共同基类的服务族

3. 装饰器模式实战

装饰器模式是Scrutor的另一大杀器，特别适合处理日志记录、缓存等横切关注点。假设我们要为所有处理器添加执行时间记录：

public class TimingDecorator<T> : T where T : class { private readonly T _inner; private readonly ILogger _logger; public TimingDecorator(T inner, ILogger logger) { _inner = inner; _logger = logger; } // 通过反射动态代理所有方法 public override object? Invoke(MethodInfo method, object?[]? args) { var sw = Stopwatch.StartNew(); try { var result = method.Invoke(_inner, args); _logger.LogInformation($"方法 {method.Name} 执行耗时: {sw.ElapsedMilliseconds}ms"); return result; } finally { sw.Stop(); } } } // 注册方式 services.Decorate(typeof(MyService), typeof(TimingDecorator<>));

4. 生产环境最佳实践

4.1 性能优化策略

程序集范围控制：精确指定扫描范围而非全程序集

// 推荐做法 services.Scan(scan => scan .FromAssemblies(typeof(ServiceA).Assembly, typeof(ServiceB).Assembly) // 其他配置... ); // 避免做法 services.Scan(scan => scan .FromApplicationDependencies() // 可能扫描不必要的程序集 );

4.2 异常处理模式

当使用装饰器链时，建议采用责任链模式：

services.Decorate<IMyService, ValidationDecorator>(); services.Decorate<IMyService, LoggingDecorator>(); services.Decorate<IMyService, CircuitBreakerDecorator>(); // 执行顺序：Validation → Logging → CircuitBreaker → 原始实现

4.3 与第三方库集成

Scrutor可以与其他DI增强库协同工作，比如：

Autofac：通过Populate方法结合使用
SimpleInjector：利用其原生装饰器系统
Lamar：与扫描功能互补

5. 疑难问题解决方案

常见问题1：装饰器导致循环依赖

解决方案：确保装饰器构造函数不依赖被装饰服务本身，必要时使用Lazy

常见问题2：泛型服务注册失败

// 正确注册泛型服务的方式 services.Scan(scan => scan .FromAssemblyContaining<GenericService<>>() .AddClasses(classes => classes.AssignableTo(typeof(IGenericService<>))) .AsImplementedInterfaces());

性能对比数据：