Laravel 12 默认使用 Carbon 3.x，需替换弃用方法、严格处理 null/空字符串、统一用 serializeDate() 控制序列化格式、显式指定时区与时间戳源、模板中强制格式化输出。
Carbon 3 是 Laravel 12 默认集成的时间类（Laravel 12 要求 PHP 8.2+，并默认使用 Carbon 3.x），相比 Carbon 2 有若干**破坏性变更**，常见报错多源于方法弃用、行为调整或类型约束收紧。修改代码兼容的核心不是“降级”，而是按新版语义重写关键逻辑。
检查并替换已移除或废弃的方法
Carbon 3 移除了多个易混淆的静态构造方法和别名：
-
不再支持
Carbon::now('Asia/Shanghai')—— 改用Carbon::now()->tz('Asia/Shanghai')或Carbon::now('Asia/Shanghai')仍可工作，但推荐链式tz()更清晰； -
废弃
Carbon::createFromFormat()的宽松模式：若传入无效日期（如'2023-02-31'），Carbon 2 可能静默修正为2023-03-03，而 Carbon 3 默认抛InvalidFormatException；必须显式加setStrictMode(false)才保留旧行为，但更推荐先校验再解析； -
移除
Carbon::resetToStringFormat()和Carbon::setToStringFormat()—— 全局字符串格式化已由serializeDate()统一接管（见下文）； -
不再自动转换
null或空字符串：Carbon::parse(null)在 Carbon 2 返回当前时间，在 Carbon 3 直接抛异常；务必前置判断：if ($dateStr) { $carbon = Carbon::parse($dateStr); }。
修复 JSON 序列化与模型字段格式问题
Laravel 12 + Carbon 3 对 $casts 和序列化更严格，尤其影响 API 响应：
- 模型中写
'published_at' => 'datetime:Y-m-d H:i'仍有效，但注意：该格式仅作用于toArray()/toJson()，$model->published_at仍是完整 Carbon 实例，可继续调format('H:i:s')； - 全局统一格式，必须在基模型中覆盖
serializeDate()，不能依赖Carbon::serializeUsing()（它已被 Carbon 3 弃用）； - 若字段是
DATE类型（非 DATETIME），且定义为'starts_on' => 'date'，它序列化后是字符串"Y-m-d"，**不是 Carbon 实例**，不能链式调用diffInDays()—— 需先Carbon::parse($model->starts_on)； - 数据库列类型必须匹配：VARCHAR 存日期字符串 →
$casts会静默失效，format()报 “Call to a member function format() on string” —— 先改字段类型为DATE或DATETIME。
处理时区与时间戳创建的安全写法
Carbon 3 强化了时区一致性，默认更倾向 UTC 操作：
- 从 Unix 时间戳创建，禁用
new Carbon($timestamp)（隐式本地时区风险）；改用：Carbon::createFromTimestampUTC($ts)（明确 UTC 源）或Carbon::createFromTimestamp($ts, 'Asia/Shanghai')（明确源时区）； - 入库前存 UTC：
$model->published_at = now()->utc();；
查出后转用户时区：$model->published_at->tz($userTimezone)->format('Y-m-d H:i')； - 比较两个时间时，直接用
$a->gt($b)或$a > $b即可 —— Carbon 3 内部自动归一到 UTC，结果可靠；避免用strtotime()手动转。
模板层与访问器中的安全实践
Blade 中直接输出时间容易触发隐式 __toString()，导致格式不可控或时区错乱：
- 禁止写
{{ $post->created_at }}—— 它可能输出带微秒的 ISO 字符串，前端解析异常； - 强制格式化：
{{ $post->created_at->format('Y-m-d H:i') }}或使用访问器：public function getCreatedAtForViewAttribute() { return $this->created_at->tz('Asia/Shanghai')->format('m/d Y g:i A'); }，视图中写{{ $post->created_at_for_view }}； - 批量操作日期（如循环列表）时，避免在 Blade 中反复
Carbon::parse()—— 提前在控制器中处理好数组，传入已格式化的字符串或 Carbon 实例。
