.NET 6内置IoC如何从其他程序集注册服务？有无最佳实践？

一、无需第三方包的原生实现 #

内置DI本身就支持从其他程序集注册服务，不需要依赖额外NuGet包，核心思路是反射扫描程序集+批量注册。

1. 定义标记接口/特性 #

先在共享项目里定义标记规则，用来标识需要注册的服务：

// 标记接口示例：按生命周期区分
public interface IScopedService { }
public interface ITransientService { }

// 自定义特性示例：支持指定生命周期和服务接口
[AttributeUsage(AttributeTargets.Class, Inherited = false)]
public class RegisterServiceAttribute : Attribute
{
    public ServiceLifetime Lifetime { get; }
    public Type? ServiceType { get; }

    public RegisterServiceAttribute(ServiceLifetime lifetime, Type? serviceType = null)
    {
        Lifetime = lifetime;
        ServiceType = serviceType;
    }
}

2. 编写批量注册扩展方法 #

创建扩展方法封装扫描和注册逻辑，方便在启动时调用：

public static class ServiceCollectionExtensions
{
    // 按标记接口批量注册
    public static IServiceCollection AddAssemblyServices(this IServiceCollection services, Assembly assembly)
    {
        // 注册Scoped服务
        var scopedTypes = assembly.GetTypes()
            .Where(t => !t.IsAbstract && !t.IsInterface && typeof(IScopedService).IsAssignableFrom(t));
        foreach (var type in scopedTypes)
        {
            // 注册自身，同时自动匹配对应的接口（如IMyService对应MyService）
            var serviceInterface = type.GetInterfaces().FirstOrDefault(i => i.Name == $"I{type.Name}");
            if (serviceInterface != null)
                services.AddScoped(serviceInterface, type);
            else
                services.AddScoped(type);
        }

        // 注册Transient服务
        var transientTypes = assembly.GetTypes()
            .Where(t => !t.IsAbstract && !t.IsInterface && typeof(ITransientService).IsAssignableFrom(t));
        foreach (var type in transientTypes)
        {
            var serviceInterface = type.GetInterfaces().FirstOrDefault(i => i.Name == $"I{type.Name}");
            if (serviceInterface != null)
                services.AddTransient(serviceInterface, type);
            else
                services.AddTransient(type);
        }

        return services;
    }

    // 按自定义特性批量注册
    public static IServiceCollection AddServicesFromAttributes(this IServiceCollection services, Assembly assembly)
    {
        var types = assembly.GetTypes()
            .Where(t => !t.IsAbstract && !t.IsInterface && t.GetCustomAttribute<RegisterServiceAttribute>() != null);
        
        foreach (var type in types)
        {
            var attr = type.GetCustomAttribute<RegisterServiceAttribute>()!;
            var serviceType = attr.ServiceType ?? type;
            
            switch (attr.Lifetime)
            {
                case ServiceLifetime.Scoped:
                    services.AddScoped(serviceType, type);
                    break;
                case ServiceLifetime.Transient:
                    services.AddTransient(serviceType, type);
                    break;
                case ServiceLifetime.Singleton:
                    services.AddSingleton(serviceType, type);
                    break;
            }
        }
        
        return services;
    }
}

3. 在启动类中调用 #

var builder = WebApplication.CreateBuilder(args);

// 加载目标程序集：可通过类型加载或程序集名称加载
var targetAssembly = Assembly.GetAssembly(typeof(YourTypeFromOtherAssembly))!;
// 或 var targetAssembly = Assembly.Load("YourOtherAssemblyName");

// 使用标记接口注册
builder.Services.AddAssemblyServices(targetAssembly);
// 或使用自定义特性注册
builder.Services.AddServicesFromAttributes(targetAssembly);

var app = builder.Build();
// ...后续启动逻辑

二、第三方扩展包的选择（按需使用） #

如果觉得原生反射逻辑繁琐，可以选择轻量的扩展包（基于内置DI扩展，不替换容器）：

• Scrutor：最主流的选择，支持按约定、特性、接口批量注册，语法简洁。示例：

  builder.Services.Scan(scan => scan
      .FromAssemblyOf<YourType>()
      .AddClasses(classes => classes.Where(t => t.Name.EndsWith("Service")))
      .AsImplementedInterfaces()
      .WithScopedLifetime());
  

三、最佳实践 #

1. 精准扫描范围：不要盲目扫描所有程序集，只扫描明确包含服务的目标程序集，减少启动时的反射开销。
2. 优先明确标记：相比类名约定（如以Service结尾），标记接口或特性的规则更清晰，避免误注册，也便于后期维护。
3. 控制反射开销：反射操作耗时，建议仅在启动时执行一次扫描；开发环境可每次启动扫描，生产环境可缓存扫描结果。
4. 减少不必要依赖：原生实现能满足需求时，尽量不引入第三方包，降低项目依赖复杂度；仅在需要装饰器、动态代理等复杂逻辑时，再考虑使用Scrutor这类扩展。
5. 验证注册逻辑：编写单元测试验证服务注册是否正确，避免运行时出现依赖注入失败的问题。

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