使用Carbon生成指定区间未来日期时遭遇UnreachableException异常问题

问题根源 #

出现Carbon\Exceptions\UnreachableException的核心原因是setRecurrences($amount)强制要求Carbon生成恰好$amount个符合所有过滤规则的日期。当遍历过程中，符合条件的日期数量不足（比如被endDate截断、未来日期不够），Carbon在达到内部最大尝试次数后就会抛出该异常。

你的过滤逻辑会跳过过去日期和超过endDate的日期，但CarbonPeriod会从startDate开始不断累加间隔，直到凑够指定数量的有效日期。如果在遍历范围内无法找到足够的有效日期，就会触发异常：

• 第一个测试场景中，startDate为2024-03-17，endDate为2024-04-01，每周间隔。符合条件的未来日期仅有2024-03-24、2024-03-31（共2个），但要求生成4个，自然无法满足，触发异常。
• 年度场景中，虽然2027-06-02在endDate（2028-04-01）之前，但原代码的setRecurrences逻辑可能因遍历顺序问题，无法正确识别到足够的有效日期，最终触发异常。

解决方案 #

放弃使用setRecurrences($amount)，改为先生成所有符合条件的日期，再截取前$amount个。这样即使符合条件的数量不足，也只会返回实际存在的日期，不会抛出异常。

修正后的代码 #

use Carbon\Carbon;
use Carbon\CarbonInterval;
use Carbon\CarbonPeriod;

$interval = CarbonInterval::week();
$startDate = Carbon::create(2024, 3, 17);
$endDate = Carbon::create(2024, 4, 1);
$amount = 4;

// 定位第一个符合要求的未来起始日期，避免遍历大量过去日期
$firstValidStart = $startDate->isFuture() 
    ? $startDate->copy() 
    : $startDate->copy()->add($interval)->startOfDay();

// 计算合理的周期结束边界：取endDate和基于amount计算的最大日期中的较小值
$maxDate = $firstValidStart->copy()->add($interval->copy()->multiply($amount - 1));
$periodEnd = $endDate ? $endDate->min($maxDate) : $maxDate;

// 生成周期并应用过滤规则
$period = CarbonPeriod::interval($interval)
    ->setStartDate($firstValidStart)
    ->setEndDate($periodEnd)
    ->addFilter(fn(Carbon $carbon) => $carbon->isFuture())
    ->addFilter(fn(Carbon $carbon) => !$endDate || $carbon->isBefore($endDate));

// 截取前$amount个日期
$dates = array_slice($period->toArray(), 0, $amount);

dd($dates);

代码要点说明 #

1. 定位第一个有效起始日期：直接从第一个未来的符合间隔的日期开始，减少不必要的遍历和过滤，提升效率。
2. 计算合理的结束边界：取endDate和基于amount计算的最大日期中的较小值，避免生成超出需求的日期。
3. 替换setRecurrences：改为生成所有符合条件的日期后截取前$amount个，既满足数量需求，又不会在数量不足时抛出异常。
4. 灵活处理endDate：如果endDate为null，则直接生成最多$amount个未来日期。

针对年度测试场景的验证 #

将代码中的参数替换为：

$interval = CarbonInterval::year();
$startDate = Carbon::create(2022, 6, 2);
$endDate = Carbon::create(2028, 4, 1);
$amount = 4;

会正确生成预期的4个日期：

• 2024-06-02
• 2025-06-02
• 2026-06-02
• 2027-06-02

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