如何正确测试含DateTime的服务？多层依赖测试解惑

第一步：修复核心依赖，让时间可注入 #

你的Age类硬编码了new DateTimeImmutable()，这是测试不稳定的根源——每次运行测试的时间不同，结果就会变。解决办法是把时间源抽象成可注入的依赖，比如定义一个Clock接口：

interface Clock
{
    public function now(): DateTimeImmutable;
}

// 生产环境用的真实时钟
class SystemClock implements Clock
{
    public function now(): DateTimeImmutable
    {
        return new DateTimeImmutable();
    }
}

// 测试用的固定时钟
class FixedClock implements Clock
{
    public function __construct(private DateTimeImmutable $fixedTime)
    {
    }

    public function now(): DateTimeImmutable
    {
        return $this->fixedTime;
    }
}

然后改造Age类，注入Clock而不是自己创建时间：

class Age
{
    public function __construct(private Clock $clock)
    {
    }

    public function calculate(DateTimeImmutable $bornAt): int
    {
        $now = $this->clock->now();
        return $bornAt->diff($now)->y;
    }
}

对应的测试用例就可以用固定时钟，保证每次结果一致：

public static function testAge(): void
{
    // 固定测试时的"当前时间"为2023-01-01
    $fixedNow = DateTimeImmutable::createFromFormat('Y-m-d H:i:s', '2023-01-01 00:00:00');
    $clock = new FixedClock($fixedNow);
    
    $bornAt = DateTimeImmutable::createFromFormat('Y-m-d H:i:s', '2000-01-01 00:00:00');
    $age = new Age($clock);

    self::assertEquals(23, $age->calculate($bornAt));
}

第二步：解耦CustomerAgeCalculation #

你的CustomerAgeCalculation存在两个问题：一是硬编码了now和customerBornAt（实际场景中应该从业务逻辑获取，比如用户数据），二是调用age->calculate时参数不匹配。改造后让它依赖Clock，并将用户生日作为输入：

class CustomerAgeCalculation
{
    public function __construct(
        private Age $age,
        private Clock $clock
    ) {
    }

    // 生日从外部传入，而非硬编码
    public function calculate(DateTimeImmutable $customerBornAt): int
    {
        // 保留业务逻辑，比如校验生日有效性等
        // ...

        return $this->age->calculate($customerBornAt);
    }
}

第三步：多层依赖链的测试方案 #

面对MyCustomClass01→MyCustomClass02→…→CustomerAgeCalculation→Age的依赖链，不需要逐层传递参数，分两种场景处理：

1. 单元测试：隔离每个类的依赖 #

针对链路上的每个类，只测试自身业务逻辑，依赖的下一级用Mock对象替代（借助PHPUnit的Mock功能）。

比如测试MyCustomClass02（假设它依赖CustomerAgeCalculation）：

public function testMyCustomClass02(): void
{
    // Mock CustomerAgeCalculation，固定返回值
    $mockAgeCalc = $this->createMock(CustomerAgeCalculation::class);
    $mockAgeCalc->method('calculate')
                ->willReturn(24);

    // 注入Mock对象到MyCustomClass02
    $myClass02 = new MyCustomClass02($mockAgeCalc);
    
    // 测试自身逻辑
    $result = $myClass02->someMethod();
    self::assertEquals(预期值, $result);
}

这种方式只关注当前类的逻辑，无需关心下层依赖的具体实现，只要Mock它们的返回值即可。

2. 集成测试：验证整个链路的协作 #

如果需要验证整个依赖链的协作是否正常（比如数据传递是否正确），不需要Mock所有依赖：

• 用固定时钟替换SystemClock，保证时间稳定；
• 对于链路上的外部服务（比如用户数据服务），可以用Mock或测试数据库；
• 从链路入口（比如MyCustomClass01）发起调用，验证最终结果。

示例：

public function testFullDependencyChain(): void
{
    // 固定全局时间
    $fixedNow = DateTimeImmutable::createFromFormat('Y-m-d H:i:s', '2023-01-01 00:00:00');
    $clock = new FixedClock($fixedNow);

    // 构建真实依赖链，仅Mock必要的外部服务
    $age = new Age($clock);
    $customerAgeCalc = new CustomerAgeCalculation($age, $clock);
    $myClass02 = new MyCustomClass02($customerAgeCalc);
    $myClass01 = new MyCustomClass01($myClass02);

    // 模拟用户生日输入
    $customerBornAt = DateTimeImmutable::createFromFormat('Y-m-d H:i:s', '1999-01-01 00:00:00');
    
    // 调用链路入口方法
    $result = $myClass01->calculateCustomerAge($customerBornAt);
    
    // 验证结果
    self::assertEquals(24, $result);
}

关键原则总结 #

• 抽象不稳定依赖：把DateTime这种随时间变化的依赖抽象成接口，方便测试时替换；
• 单元测试隔离依赖：每个类只测自身逻辑，依赖用Mock，无需关心下层链路；
• 集成测试验证协作：仅在需要验证链路协作时构建完整依赖，用固定时钟保证测试稳定；
• 避免逐层传参：依赖注入容器（如Symfony DI、Laravel容器）可管理依赖，测试时只需替换需要Mock的对象，无需手动逐层传递。

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