使用 Carbon::setTestNow() 可固定测试时间，确保时间相关逻辑的测试稳定；例如设为 '2025-04-05 10:00:00' 后，所有 Carbon::now() 返回该值，便于断言；通过调整测试时间可模拟时间流逝，验证缓存过期等场景；测试结束应调用 Carbon::setTestNow(null) 清除设置，防止影响其他测试。
在 Laravel 测试中，经常需要验证与时间相关的逻辑，比如判断某个记录是否过期、任务是否可执行等。由于实际时间是动态变化的，直接使用 Carbon::now() 会导致测试不稳定或难以断言。为了解决这个问题，Laravel 借助 Carbon 提供了静态方法来“冻结”或“伪造”当前时间。
通过调用 Carbon::setTestNow()，你可以人为设定当前时间的返回值。之后所有对 Carbon::now() 的调用都会返回你指定的时间，直到你清除这个设置。
例如，在测试中：
400-7654-355
use Carbon\Carbon;
public function test_something_happens_at_specific_time()
{
// 设定测试时间为 2025-04-05 10:00:00
Carbon::setTestNow('2025-04-05 10:00:00');
// 此时调用 now() 返回的是设定的时间
$this->assertEquals(
'2025-04-05 10:00:00',
Carbon::now()->format('Y-m-d H:i:s')
);
// 模拟业务逻辑，比如订单创建后两小时过期
$orderTime = Carbon::now();
$expireTime = $orderTime->copy()->addHours(2);
$this->assertFalse($expireTime->isPast()); // 还没过期
}
每次使用 setTestNow(
) 后，建议在测试结束时清除设置，避免影响其他测试用例。可以使用 Carbon::setTestNow(null) 来恢复真实时间。
推荐在 tearDown() 或 afterEach 钩子中清理：
protected function tearDown(): void
{
Carbon::setTestNow(null); // 清除伪造时间
parent::tearDown();
}
有时你需要验证“一段时间后”的行为，比如缓存失效、任务延迟执行等。可以在同一个测试中多次调整测试时间：
public function test_cache_expires_after_ten_minutes()
{
Carbon::setTestNow('2025-04-05 10:00:00');
cache()->put('key', 'value', 10); // 缓存10分钟
// 快进到 10 分钟后
Carbon::setTestNow(Carbon::now()->addMinutes(11));
$this->assertNull(cache()->get('key')); // 缓存已过期
}
基本上就这些。通过 Carbon::setTestNow()，你可以完全掌控测试中的时间流动，让时间相关逻辑的测试变得稳定且可预测。关键是在测试结束后记得清除设置，避免副作用。
