.NET 8依赖注入最佳实践：手动注册还是其他模式？

不需要手动注册所有依赖项，.NET 8 提供了多种更高效的批量注册方式，完全适配你项目中有数百个依赖的场景。以下是几种常用方案：

1. 按程序集自动扫描注册 #

通过扫描指定程序集，自动注册所有实现特定接口的类型，这是最常用的批量注册方式。示例代码：

var targetAssembly = typeof(INotificationService).Assembly; // 获取包含服务类的程序集

// 简洁版：注册程序集中所有实现INotificationService的类型为单例
builder.Services.AddSingleton(typeof(INotificationService), targetAssembly);

// 更灵活的扫描配置（支持自定义筛选、生命周期）
builder.Services.Scan(scan => scan
    .FromAssemblies(targetAssembly)
    .AddClasses(classes => classes.AssignableTo<INotificationService>()) // 筛选实现指定接口的类
    .AsImplementedInterfaces() // 注册为其实现的所有接口
    .WithSingletonLifetime()); // 指定生命周期

这种方式会自动把所有INotificationService的实现类注册到容器中，后续你可以通过IEnumerable<INotificationService>注入所有实例。

2. 基于特性标记的注册 #

如果需要为不同服务指定不同生命周期，可以自定义特性来标记服务，再通过扫描自动识别。示例：

// 自定义注册特性
[AttributeUsage(AttributeTargets.Class)]
public class RegisterServiceAttribute : Attribute
{
    public ServiceLifetime Lifetime { get; set; } = ServiceLifetime.Singleton;
}

// 给服务类添加标记
[RegisterService(Lifetime = ServiceLifetime.Singleton)]
public class SmsNotificationService : INotificationService { /* 实现代码 */ }

// 扫描注册逻辑
builder.Services.Scan(scan => scan
    .FromAssemblies(typeof(SmsNotificationService).Assembly)
    .AddClasses(classes => classes.WithAttribute<RegisterServiceAttribute>()) // 筛选带特性的类
    .AsImplementedInterfaces()
    .WithLifetime(type => 
        type.GetCustomAttribute<RegisterServiceAttribute>()?.Lifetime 
        ?? ServiceLifetime.Singleton)); // 读取特性指定的生命周期

3. 模块化拆分注册 #

把不同业务模块的服务注册逻辑封装到扩展方法中，避免Program.cs代码臃肿，同时提升可维护性。示例：

// 扩展方法封装通知服务注册
public static class NotificationServiceExtensions
{
    public static IServiceCollection AddNotificationServices(this IServiceCollection services)
    {
        var assembly = typeof(INotificationService).Assembly;
        services.Scan(scan => scan
            .FromAssemblies(assembly)
            .AddClasses(c => c.AssignableTo<INotificationService>())
            .AsImplementedInterfaces()
            .WithSingletonLifetime());
        return services;
    }
}

// 在Program.cs中调用
builder.Services.AddNotificationServices();

关键注意事项 #

• 批量注册时要注意生命周期的一致性，如果部分服务需要不同生命周期，一定要通过筛选规则或特性标记区分开
• 确保扫描的程序集范围准确，避免误注册不需要的类型
• 对于多实现接口的场景，批量注册后可以直接通过IEnumerable<TInterface>注入所有实现实例，无需手动逐个处理

内容的提问来源于stack exchange，提问作者Craig