Scrutor：.NET 依赖注入自动化的优雅实现

在现代 .NET 开发中，依赖注入（DI）已经成为标配功能。手动注册每一个服务，不仅代码繁琐、重复度高，还容易出现漏注册、错注册的问题，给项目维护带来负担。Scrutor 是一款轻量的 NuGet 扩展库，基于约定优于配置的思想，让 .NET 依赖注入实现全自动注册，大幅简化开发流程。

本文结合实际项目经验，详解 Scrutor 的核心用法、场景适配和最佳实践，帮你快速落地自动化 DI。

一、什么是 Scrutor

Scrutor 由开发者 Kristian Hellang 打造，是 ASP.NET Core 原生 DI 容器的扩展库。它不改变原生 DI 的核心逻辑，只提供程序集扫描、批量筛选、自动注册的能力，让服务注册从手动编写变成自动匹配。

核心优势

• 告别重复代码，统一注册规则，降低维护成本
• 严格遵循 DRY 原则，保证全项目服务注册逻辑一致
• 完美支持 Scoped/Transient/Singleton 三种生命周期
• 过滤、命名、继承、泛型等灵活配置，适配各类项目结构
• 无侵入式设计，兼容原生 DI，可随时切换回手动注册

二、首选推荐：标记接口模式（企业级最佳实践）

这是我在实际项目中长期使用的方案，简洁、易维护、可读性强，也是中大型项目的最优选择。

2.1 定义生命周期标记接口

先创建三个空接口，仅用于标记服务的生命周期，无任何业务逻辑：

/// <summary>
/// Scoped 生命周期标记接口
/// </summary>
public interface IScopedDependency { }

/// <summary>
/// Transient 生命周期标记接口
/// </summary>
public interface ITransientDependency { }

/// <summary>
/// Singleton 生命周期标记接口
/// </summary>
public interface ISingletonDependency { }

2.2 封装统一自动注入配置

写一个扩展方法，一次性完成所有标记服务的扫描注册，后续无需修改：

public static class DependencyInjectionExtensions
{
    public static IServiceCollection AddAutoDependencyInjection(this IServiceCollection services)
    {
        // 扫描项目所有程序集，自动匹配标记接口的服务
        services.Scan(scan => scan
            .FromApplicationDependencies()
            
            // 注册 Scoped 服务
            .AddClasses(classes => classes.AssignableTo<IScopedDependency>())
            .AsImplementedInterfaces()
            .WithScopedLifetime()
            
            // 注册 Transient 服务
            .AddClasses(classes => classes.AssignableTo<ITransientDependency>())
            .AsImplementedInterfaces()
            .WithTransientLifetime()
            
            // 注册 Singleton 服务
            .AddClasses(classes => classes.AssignableTo<ISingletonDependency>())
            .AsImplementedInterfaces()
            .WithSingletonLifetime()
        );
        return services;
    }
}

2.3 极简使用方式

新增服务时，只需要实现对应的标记接口，无需编写任何注册代码：

// 业务接口继承 IScopedDependency，标记生命周期
public interface IUserService : IScopedDependency
{
    Task<UserInfo> GetUserByIdAsync(Guid userId);
}

// 实现类无需额外配置
public class UserService : IUserService
{
    public Task<UserInfo> GetUserByIdAsync(Guid userId)
    {
        // 业务实现
        return Task.FromResult(new UserInfo());
    }
}

推荐理由

• 零配置：新增服务只加一个接口，完全不用管注册逻辑
• 高可读：一眼就能看出服务的生命周期，代码自解释
• 强类型：编译期检查，避免运行时注册错误
• 易维护：全项目统一规则，新人上手无成本

三、常用实用用法

除了标记接口，Scrutor 还支持多种扫描规则，适配不同项目场景。

3.1 基于命名约定注册

适合命名规范严格的现有项目，按类名后缀批量注册：

services.Scan(scan => scan
    .FromAssemblyOf<Program>()
    // 自动注册所有以 Service 结尾的类
    .AddClasses(classes => classes.Where(type => type.Name.EndsWith("Service")))
    .AsImplementedInterfaces()
    .WithScopedLifetime()
    
    // 自动注册所有以 Repository 结尾的仓储类
    .AddClasses(classes => classes.Where(type => type.Name.EndsWith("Repository")))
    .AsImplementedInterfaces()
    .WithScopedLifetime()
);

3.2 基于命名空间注册

适合按模块分层的项目，按命名空间批量注册：

services.Scan(scan => scan
    .FromAssemblyOf<Program>()
    // 注册应用服务层
    .AddClasses(classes => classes.InNamespaces("MyProject.Application.Services"))
    .AsImplementedInterfaces()
    .WithScopedLifetime()
    
    // 注册数据仓储层
    .AddClasses(classes => classes.InNamespaces("MyProject.Infrastructure.Repositories"))
    .AsImplementedInterfaces()
    .WithScopedLifetime()
);

3.3 基于基类注册

适合封装通用基类的项目，批量注册继承基类的所有子类：

// 抽象基类，封装通用日志、工具方法
public abstract class BaseService
{
    protected readonly ILogger<BaseService> _logger;
    protected BaseService(ILogger<BaseService> logger) => _logger = logger;
}

// 自动扫描注册所有继承 BaseService 的类
services.Scan(scan => scan
    .FromAssemblyOf<BaseService>()
    .AddClasses(classes => classes.InheritedFrom<BaseService>())
    .AsSelf()
    .WithScopedLifetime()
);

3.4 注册为自身类型

适合CQRS 命令/查询模式，直接注册实现类本身：

services.Scan(scan => scan
    .FromAssemblyOf<Program>()
    .AddClasses(classes => classes.AssignableTo<ICommandHandler>())
    .AsSelf() // 不注册接口，直接注册类本身
    .WithTransientLifetime()
);

// 使用时直接获取实现类
var handler = _serviceProvider.GetRequiredService<CreateUserCommandHandler>();

3.5 自定义注册策略

控制重复服务的注册行为，避免冲突：

services.Scan(scan => scan
    .FromAssemblyOf<Program>()
    .AddClasses(classes => classes.AssignableTo<IValidator>())
    .UsingRegistrationStrategy(RegistrationStrategy.Skip) // 跳过已存在的注册
    .AsImplementedInterfaces()
    .WithTransientLifetime()
);

可选策略：

• Append：追加注册（默认）
• Skip：跳过已注册服务
• Replace：替换已注册服务

四、高级进阶用法

4.1 装饰器模式

Scrutor 原生支持装饰器，轻松实现日志、缓存、事务等横切逻辑：

// 核心服务 + 装饰器都实现同一接口
public interface IOrderService { void CreateOrder(); }
public class OrderService : IOrderService { }
public class LoggingOrderDecorator : IOrderService { }

// 先注册核心服务
services.Scan(scan => scan.FromAssemblyOf<IOrderService>().AddClasses().AsImplementedInterfaces().WithScopedLifetime());

// 叠加装饰器（执行顺序：后注册的先执行）
services.Decorate<IOrderService, LoggingOrderDecorator>();

4.2 条件过滤注册

通过特性标记，跳过不需要自动注册的服务：

// 自定义跳过特性
[AttributeUsage(AttributeTargets.Class)]
public class SkipAutoRegistrationAttribute : Attribute { }

// 扫描时排除标记类
services.Scan(scan => scan
    .FromApplicationDependencies()
    .AddClasses(classes => classes
        .AssignableTo<IScopedDependency>()
        .Where(t => !t.HasAttribute<SkipAutoRegistrationAttribute>())
    )
    .AsImplementedInterfaces()
    .WithScopedLifetime()
);

// 使用：标记无需自动注册的类
[SkipAutoRegistration]
public class TestService : IScopedDependency { }

4.3 批量注册泛型服务

适配仓储模式等泛型接口，自动注册封闭泛型：

services.Scan(scan => scan
    .FromAssemblyOf<IRepository<>>()
    .AddClasses(classes => classes.AssignableTo(typeof(IRepository<>)))
    .AsClosedTypesOf(typeof(IRepository<>))
    .WithScopedLifetime()
);

// 直接使用
var userRepo = _serviceProvider.GetRequiredService<IRepository<User>>();

---

五、各注册方式对比

注册方式	优点	缺点	推荐指数
标记接口	零配置、可读性高、编译期检查	需要定义空接口	⭐⭐⭐⭐⭐
命名约定	无需改代码、快速迁移	强依赖命名规范	⭐⭐⭐
命名空间	分层清晰、模块化管理	需维护命名空间	⭐⭐⭐⭐
基类继承	统一通用逻辑	类耦合度偏高	⭐⭐⭐
注册自身	适配 CQRS 模式	面向实现编程，灵活性低	⭐⭐⭐

---

六、落地最佳实践

6.1 分层扫描注册

按项目架构分层注册，职责清晰，便于排查问题：

// 应用层注册
public static IServiceCollection AddApplicationLayer(this IServiceCollection services)
{
    services.Scan(scan => scan
        .FromAssemblyOf<ApplicationLayerMarker>()
        .AddClasses(classes => classes.AssignableTo<IScopedDependency>())
        .AsImplementedInterfaces()
        .WithScopedLifetime()
    );
    return services;
}

// 基础设施层注册
public static IServiceCollection AddInfrastructureLayer(this IServiceCollection services)
{
    services.Scan(scan => scan
        .FromAssemblyOf<InfrastructureLayerMarker>()
        .AddClasses(classes => classes.AssignableTo<IRepository>())
        .AsImplementedInterfaces()
        .WithScopedLifetime()
    );
    return services;
}

6.2 自动+手动注册配合

自动注册通用服务，手动注册特殊配置服务：

// 批量自动注册
services.AddAutoDependencyInjection();

// 手动注册特殊服务（带自定义配置）
services.AddScoped<IPaymentService>(sp =>
{
    var config = sp.GetRequiredService<IOptions<PaymentConfig>>();
    return new AlipayPaymentService(config.Value.AppId);
});

6.3 测试环境适配

单元测试中，直接用 Mock 覆盖自动注册的服务：

// 测试项目重写注册
services.AddScoped<IUserService, MockUserService>();
services.AddScoped<IOrderService, MockOrderService>();

---

七、总结

Scrutor 让 .NET 依赖注入从手动编码 变成自动匹配，不同注册方式对应不同项目场景：

• 新项目搭建 → 标记接口模式（首选）
• 老项目迁移 → 命名约定模式
• 模块化架构 → 命名空间模式
• CQRS 架构 → 注册自身模式

标记接口模式是最推荐的方案，它兼顾简洁性、可读性和可维护性，能显著提升开发效率，降低团队协作成本，是企业级 .NET 项目的标配实践。

公众号【.NET修仙日记】