Yii时区必须在config/main.php统一设为IANA名（如'Asia/Shanghai'），并同步配置MySQL连接层SET TIME_ZONE，否则PHP、MySQL、JS时间解释链路不一致会导致静默错误。
Yii 框架的时区必须在应用层统一配置，否则数据库存取、格式化输出、用户感知时间会不一致——最稳妥的方式是 config/main.php 中设 timeZone，再配合 MySQL 连接层显式同步时区。
config/main.php 里直接配 timeZone
这是绝大多数项目的首选方案，生效范围覆盖 Yii::$app->formatter、date()、模型自动填充的 created_at 等时间字段：
- 值必须是 IANA 时区名，如
'Asia/Shanghai'，不能写'PRC'或'+08:00'（PHP 8.0+ 已弃用 PRC） - 若项目支持多语言用户，此处只设「系统基准时区」，用户个性化时区需额外处理，不能覆盖这里
- 修改后需清空 runtime/cache/ 下的配置缓存，否则可能不生效
MySQL 连接层必须同步设 SET TIME_ZONE
Yii 默认不干预 MySQL 服务端时区，而 MySQL 的 time_zone 系统变量默认是 SYSTEM（即服务器本地时区），和 PHP 层的 timeZone 不一定一致——这会导致 NOW()、CURDATE()、TIMESTAMP 字段行为错乱：
- 在
common/config/db.php的attributes中加一行：PDO::ATTR_INIT_COMMAND => "SET TIME_ZONE = '+08:00'" - 或更推荐：在
vendor/yiisoft/yii2/db/Connection.php的initConnection()方法里插入执行逻辑（参考知识库中 2021 年方案），避免硬编码 +08:00 - 验证方式：执行
SELECT @@time_zone, NOW(), UTC_TIMESTAMP()，确认三者逻辑自洽
动态切换时区要避开 formatter 缓存
用 Yii::$app->timeZone = 'Europe/Berlin' 能即时切换，但 Yii::$app->formatter 默认会缓存日期格式结果，导致「时区变了，显示时间没变」：
- 切换后手动重置 formatter：
Yii::$app->formatter->defaultTimeZone = Yii::$app->timeZone - 或者每次使用前显式指定：
Yii::$app->formatter->asDateTime($timestamp, 'php:Y-m-d H:i:s', 'Europe/Berlin') - 不建议在控制器里频繁调用
setTimeZone()，更适合放在on beforeRequest行为中，且仅对已登录用户生效
真正麻烦的不是设置本身，而是 PHP 层、MySQL 层、浏览器 JS Date 对同一时间戳的解释链路太长——漏掉任意一环，比如忘了改 MySQL 连接初始化命令，就可能出现「数据库里存的是 UTC，PHP 却按上海时区读出来」这种静默错误。
