Scrutor项目中的泛型服务扫描问题解析

在.NET依赖注入领域，Scrutor是一个广受欢迎的库，它扩展了Microsoft.Extensions.DependencyInjection的功能，提供了强大的程序集扫描和自动注册能力。本文将深入分析一个从Scrutor 5.1.2升级到6.0.1版本时出现的泛型服务扫描问题。

问题背景

开发者在项目中使用了Scrutor来扫描并注册实现了泛型接口IVectorCollectionIndexingService<>的服务。在5.1.2版本下工作正常，但在升级到6.0.1版本后，这些服务不再被自动注册。

核心代码分析

典型的扫描注册代码如下所示：

var vectorCollectionIndexingServiceType = typeof(IVectorCollectionIndexingService<>);
services.Scan(s => s
    .FromAssemblies(vectorCollectionIndexingServiceType.Assembly)
    .AddClasses(c => c
        .AssignableTo(vectorCollectionIndexingServiceType)
        .Where(t => t.IsClass && !t.IsAbstract && t != typeof(TicketVectorIndexingService))
    )
    .AsImplementedInterfaces(t => t.GetGenericTypeDefinition() == vectorCollectionIndexingServiceType)
    .WithSingletonLifetime()
);

版本差异原因

经过深入分析，发现问题根源在于Scrutor 6.0.0版本引入了一个重要的行为变更：默认情况下，AddClasses方法现在只会扫描公共(public)类型。而在5.x版本中，即使没有显式指定，该方法也会扫描所有可见性级别的类型。

解决方案

要解决这个问题，有两种方法：

1. 将相关类型改为public：确保所有需要被扫描注册的类型都具有public可见性

2. 显式指定扫描非公共类型：修改扫描配置，添加publicOnly: false参数

.AddClasses(c => c
    .AssignableTo(vectorCollectionIndexingServiceType)
    .Where(t => t.IsClass && !t.IsAbstract && t != typeof(TicketVectorIndexingService)),
    publicOnly: false
)

最佳实践建议

1. 版本升级注意事项：在升级Scrutor到6.0.0及以上版本时，需要检查所有使用AddClasses的地方，确认是否需要扫描非公共类型

2. 类型可见性设计：从设计角度考虑，服务实现类通常应该设计为public，因为它们是供DI容器创建和管理的

3. 测试验证：在升级后，应该增加测试用例来验证所有预期的服务都被正确注册

总结

这个案例展示了依赖注入库在版本升级时可能带来的行为变化。Scrutor 6.0.0版本通过明确AddClasses方法的默认行为，使其更符合方法签名所表达的意图，提高了API的清晰度和一致性。开发者在升级时需要注意这类行为变更，并根据实际情况调整代码。