laravel 12 时区需三层统一配置：mac 系统设为 asia/shanghai、php 层改 config/app.php、mysql 连接层加 set time_zone='+08:00'、carbon 实例用 tz() 链式转换，缺一不可。
直接说结论：Laravel 12 的时区不能只靠改 config/app.php，Mac 系统时区设对只是基础，关键在三层分离配置——PHP 层、数据库连接层、Carbon 实例层，缺一不可。
Mac 系统时区必须先设为 Asia/Shanghai
哪怕 Laravel 代码全对，Mac 系统时区是 UTC 或 America/Los_Angeles，命令行里 php artisan tinker 中的 now() 仍会输出错误时间，且部分系统级日志（如队列失败记录）也会错位。
- 打开“系统设置” → “通用” → “日期与时间”，点击锁图标解锁
- 勾选“自动设定时区”并确认“隐私与安全性” → “定位服务” → “系统服务”中“设定时区”已开启；若定位不准或企业网络屏蔽，就取消勾选，手动点“设定”→ 搜索框输入
Shanghai→ 选Asia/Shanghai（不是Beijing或Hong_Kong） - 终端验证：
date命令输出应含CST或+0800；再运行php -r "echo date('T e');"，也应显示CST +0800
PHP 层时区：改 config/app.php 但仅影响原生函数和默认 Carbon
这步控制 date()、strtotime() 和无参 Carbon::now()，但它不碰数据库、不改 Eloquent 行为、也不影响 API 返回的 ISO 字符串时区偏移。
- 编辑
config/app.php，找到'timezone' => 'UTC'，改为'timezone' => 'Asia/Shanghai' - 注意：此设置对
Carbon::parse('2026-09-16')生效，但若用户前端提交的是“东京时间字符串”，它会误按上海规则解析——这种场景必须显式传时区：Carbon::parse('2026-09-16', 'Asia/Tokyo') - 重启 Laravel 队列或 Horizon 才能生效（因为它们常驻内存，不读新配置）
MySQL 连接层必须显式设 time_zone = '+08:00'
Laravel 12 默认不给 PDO 连接发 SET time_zone，所以迁移里的 $table->timestamps() 生成的 CURRENT_TIMESTAMP 仍走 MySQL 全局时区（常为 SYSTEM，即 Mac 系统时区——但 Docker 容器或云 RDS 可能是 UTC）。
- 在
config/database.php的 MySQL 配置块中，加入：'options' => [<br> PDO::MYSQL_ATTR_INIT_COMMAND => "SET time_zone = '+08:00'"<br>]
- 执行
php artisan tinker后运行DB::select("SELECT @@session.time_zone as tz")[0]->tz，应返回+08:00 - 仅对 MySQL 有效；PostgreSQL 用户需在
database.php的options里加PDO::ATTR_EMULATE_PREPARES => true并在连接后执行SET TIME ZONE '+08:00'
Carbon 实例转换别用错方法：tz() vs setTimezone()
这是最常踩的坑：一个返回新实例，一个修改原实例。写错会导致时间值没变、API 返回仍是 UTC 字符串、Blade 模板里显示错乱。
-
$c = Carbon::now(); $c->tz('Asia/Shanghai');→$c没变，因为tz()返回新对象，你没接住；正确写法：$c = $c->tz('Asia/Shanghai');或链式Carbon::now()->tz('Asia/Shanghai')->format('Y-m-d H:i') -
$c = Carbon::now(); $c->setTimezone('Asia/Shanghai');→$c被原地改掉，后续所有操作都基于上海时区，但会改变原始时间戳数值（比如从2026-09-16T06:00:00Z变成2026-09-16T14:00:00+08:00），容易在多层转换中出错 - API 输出推荐统一用
toArray()或jsonSerialize()，它们依赖实例当前时区；确保序列化前已调用tz()，否则前端拿到的 ISO 字符串可能带Z（UTC）而非+08:00
真正麻烦的不是设一次时区，而是当用户分布在北京、东京、悉尼，而数据库存的是 UTC、API 要返回各自本地时间、后台任务又要按服务器时间触发——这时候单靠 config/app.php 就完全不够用了，得靠中间件 + 用户模型属性 + Carbon 链式调用分层兜底。
