在当今微服务与领域驱动设计（DDD）盛行的背景下，清洁架构（Clean Architecture）凭借其清晰的依赖倒置原则和层间隔离特性，成为众多.NET开发者构建可维护、可测试后端系统的首选。然而，当业务逻辑要求“自动更新某实体的状态”时——例如用户注册后自动将“待激活”改为“已激活”——许多团队会在遵循清洁架构规则与实现便捷性之间陷入两难。本文将深入解析这一典型场景，并给出符合清洁架构原则的ASP.NET Core API实现方案。

一、背景：状态自动更新的业务场景

假设我们正在开发一个在线课程平台，学员提交注册申请后，系统需要在一段时间后自动将其状态从“待审批”更新为“已激活”，或基于某个外部事件（如支付成功）触发状态变更。在清洁架构中，领域层负责核心业务规则，应用层编排用例，基础设施层处理外部依赖。自动更新状态意味着：业务规则（如“超过24小时自动激活”）应位于领域层，而定时执行或事件响应则由基础设施层负责。如何在不违反依赖方向的前提下实现这一目标？

二、核心挑战：跨层通信的合理边界

许多开发者会尝试在控制器或数据库上下文侧直接编写定时任务，但这样做会导致领域逻辑泄漏到基础设施层，破坏清洁架构的独立性。真正的挑战在于：领域层需要定义“何时更新状态”的规则，但不应感知具体的时间机制或外部事件源。解决方案的关键在于引入“领域事件”与“中介者模式”。

三、解决方案：三步实现清洁架构下的自动状态更新

1. 在领域层定义状态变更规则

首先，在领域实体Enrollment中封装状态变更行为。例如，创建一个方法void Activate()，内部判断当前状态是否允许激活，并在激活后引发一个领域事件EnrollmentActivatedEvent。该事件仅是个简单的类，不包含任何基础设施依赖。

public class Enrollment : AggregateRoot
{
    public EnrollmentStatus Status { get; private set; }

    public void Activate()
    {
        if (Status != EnrollmentStatus.Pending) 
            throw new InvalidOperationException();
        Status = EnrollmentStatus.Active;
        AddDomainEvent(new EnrollmentActivatedEvent(Id));
    }
}

2. 利用中介者与后台托管服务处理定时触发

在应用层，引入MediatR或类似中介者库。当需要定时查询“待处理”注册项时，由应用层定义一个IAutomaticActivationService接口（声明在应用层），然后由基础设施层实现该接口。例如，创建一个BackgroundService，每隔一分钟调用IAutomaticActivationService的方法，该方法查询所有待激活超过24小时的Enrollment，并调用其Activate()方法持久化。

// 基础设施层实现
public class AutomaticActivationService : IAutomaticActivationService
{
    private readonly IRepository<Enrollment> _repository;

    public async Task ActivateEligibleEnrollmentsAsync()
    {
        var pending = await _repository.GetPendingOlderThanAsync(TimeSpan.FromHours(24));
        foreach (var e in pending)
        {
            e.Activate();
            await _repository.UpdateAsync(e);
        }
    }
}

3. 通过领域事件实现解耦通知

状态变更后，领域事件可以派发到其他订阅者（如发送邮件通知）。借助MediatR的INotificationHandler，在应用层中注册处理函数，这样领域层完全不依赖外部服务，实现了真正的隔离。

四、最佳实践与避坑指南

  1. 避免在领域层引入时间依赖：不要直接在领域实体中写DateTime.Now或调用定时器，应由应用层注入时间提供者（如IDateTime接口），便于测试。
  2. 事务一致性与幂等性：自动更新可能因服务中断重复执行，需在基础设施层确保更新操作的幂等性（例如使用乐观锁或版本字段）。
  3. 性能考量：若待处理数据量巨大，可改用数据库级定时任务（如SQL Server Agent）结合领域事件，但注意保持领域逻辑的独立性。
  4. 测试策略：单元测试时，直接调用Activate()并断言事件是否触发，无需依赖后台服务；集成测试则可启动BackgroundService验证完整流程。

五、结语

在清洁架构中实现“自动更新状态”看似复杂，实则只需把握一个核心原则：领域层只描述“能做什么”，不关心“何时做、怎么做”。通过领域事件、应用层服务接口和基础设施层托管服务的三层协作，既能保证架构的纯净度，又能满足实际业务的时间触发需求。这一模式已被众多大型.NET项目验证，是平衡架构严谨性与开发效率的经典实践。对于正苦恼于“清洁架构下的自动化任务”的团队而言，这或许正是你需要的答案。