使用 carbon::setTestNow() 可固定测试时间，确保时间相关逻辑的测试稳定；例如设为 ‘2025-04-05 10:00:00’ 后，所有 Carbon::now() 返回该值，便于断言；通过调整测试时间可模拟时间流逝，验证缓存过期等场景；测试结束应调用 Carbon::setTestNow(NULL) 清除设置，防止影响其他测试。
在 laravel 测试中，经常需要验证与时间相关的逻辑，比如判断某个记录是否过期、任务是否可执行等。由于实际时间是动态变化的，直接使用 Carbon::now() 会导致测试不稳定或难以断言。为了解决这个问题，Laravel 借助 Carbon 提供了静态方法来“冻结”或“伪造”当前时间。
使用 Carbon::setTestNow() 固定测试时间
通过调用 Carbon::setTestNow()，你可以人为设定当前时间的返回值。之后所有对 Carbon::now() 的调用都会返回你指定的时间，直到你清除这个设置。
例如，在测试中：
use CarbonCarbon; 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()，你可以完全掌控测试中的时间流动，让时间相关逻辑的测试变得稳定且可预测。关键是在测试结束后记得清除设置，避免副作用。