ASP.NET Core Scoped服务注入循环依赖与装饰器实现问题

1. 多层装饰分离横切逻辑的方案合理性 #

这个思路是行业通用的成熟落地方案，本质是装饰器模式在依赖注入场景下的标准用法，完全符合SOLID设计原则中的单一职责、开闭原则：核心业务类只负责自身核心逻辑，横切逻辑通过独立的装饰层逐层叠加，不需要修改控制器、核心业务类的代码，可维护性和可测试性都很高。

2. 横切逻辑的存放位置与装饰器适用范围 #

日志、缓存、事务、参数校验、熔断重试、权限校验都属于横切关注点，本身就不应该散落在控制器或者核心业务类中，避免和核心逻辑耦合。

• 横切逻辑的常见实现方式包括装饰器、框架过滤器/中间件、AOP拦截器几类，其中装饰器方案完全不耦合特定框架，单元测试成本最低，是非常推荐的实现方式。
• 缓存能力完全可以用相同的装饰层思路实现：比如编写CachedWeatherRepository实现IWeatherRepository，注入缓存组件和下一层IWeatherRepository实例，请求进入时先查缓存，命中直接返回，未命中则调用下一层仓储获取数据、写入缓存后返回。装饰层的叠加顺序可以根据业务需求灵活调整，比如把缓存装饰放在日志装饰外层，就可以同时记录缓存命中/未命中的日志。

3. Scoped生命周期下多层装饰的正确注册方式 #

出现循环依赖的原因很简单：ASP.NET Core原生DI默认对同一接口的多次注册，会以最后一次注册的实现作为注入实例。当LogAwareEmailSenderService注入IEmailSenderService时，容器会尝试解析LogAwareEmailSenderService自身，自然形成循环依赖链。
根据使用的.NET版本，可以选两种注册方式，所有服务都能保持Scoped生命周期：

方式1：兼容所有.NET版本的工厂注册 #

不要重复注册同一接口，通过工厂委托手动构造装饰链即可，核心实现可以单独注册为实现类自身（不要注册为接口）避免冲突：

// 注册基础依赖
builder.Services.AddScoped<ICustomLogger, CustomLogger>();
// 核心服务注册为自身类型，不映射接口，避免和装饰链冲突
builder.Services.AddScoped<EmailSenderService>();
builder.Services.AddScoped<WeatherRepository>();
builder.Services.AddMemoryCache(); // 示例：注册缓存依赖

// 注册邮件服务装饰链：核心实现 -> 日志装饰层
builder.Services.AddScoped<IEmailSenderService>(sp =>
{
    var coreService = sp.GetRequiredService<EmailSenderService>();
    var logger = sp.GetRequiredService<ICustomLogger>();
    return new LogAwareEmailSenderService(logger, coreService);
});

// 注册仓储多层装饰链：核心实现 -> 日志装饰层 -> 缓存装饰层
builder.Services.AddScoped<IWeatherRepository>(sp =>
{
    var coreRepo = sp.GetRequiredService<WeatherRepository>();
    var logger = sp.GetRequiredService<ICustomLogger>();
    var cache = sp.GetRequiredService<IMemoryCache>();
    
    var loggedRepo = new LogAwareWeatherRepository(logger, coreRepo);
    var cachedRepo = new CachedWeatherRepository(cache, loggedRepo);
    return cachedRepo;
});

方式2：.NET 8+ 原生Decorate API #

.NET 8及以上版本的原生DI已经原生支持装饰器注册，不需要手动写工厂，直接按顺序调用Decorate方法即可，容器会自动按注册顺序从内到外包裹装饰层，不会出现循环依赖：

// 先注册核心实现
builder.Services.AddScoped<IEmailSenderService, EmailSenderService>();
// 注册装饰层，自动包裹上一层实现
builder.Services.Decorate<IEmailSenderService, LogAwareEmailSenderService>();

// 多层装饰直接追加Decorate调用即可
builder.Services.AddScoped<IWeatherRepository, WeatherRepository>();
builder.Services.Decorate<IWeatherRepository, LogAwareWeatherRepository>();
builder.Services.Decorate<IWeatherRepository, CachedWeatherRepository>();

4. DI学习资料推荐 #

• 书籍优先看《.NET 依赖注入》，作者是Mark Seemann和Steven van Deursen，是DI领域的权威著作，从基础概念、设计原则、模式落地、容器实现到反模式避坑都有系统讲解，适合从入门到精通系统学习。
• 官方文档中ASP.NET Core依赖注入章节可以作为速查手册，覆盖了原生容器的生命周期、注册方式、基础最佳实践，适合日常开发查用法。
• 落地时刻意遵循几个原则：依赖抽象而非具体实现，避免服务定位器反模式，不要将短生命周期服务注入长生命周期服务，构造函数仅做依赖赋值不执行业务逻辑。

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