Laravel配置America/Sao_Paulo时区后，查询返回UTC时间而非存储时间

DevOps 小满

2026-7-19

解决Laravel查询日期返回UTC而非配置时区的问题

针对你遇到的问题——已经在config/app.php设置了'timezone' => 'America/Sao_Paulo'，数据保存时时间正确，但查询返回UTC时间，试试以下几个解决步骤：

配置数据库连接时区
打开config/database.php，找到对应数据库（比如MySQL）的连接配置，添加时区参数：
```
'mysql' => [
    // 其他原有配置...
    'timezone' => 'America/Sao_Paulo',
],
```
注意：如果你的数据库版本不支持时区名称（比如MySQL 5.6及以下），可以用UTC偏移量代替：'timezone' => '-03:00'

确保模型字段正确转换为Carbon实例
在对应模型中，通过$casts属性将日期字段明确转为datetime类型，让Laravel自动处理时区转换：

class YourModel extends Model
{
    protected $casts = [
        'created_at' => 'datetime:Y-m-d H:i:s',
        'updated_at' => 'datetime:Y-m-d H:i:s',
        // 替换成你的自定义日期字段
        'custom_date_field' => 'datetime:Y-m-d H:i:s',
    ];
}

清除配置缓存
修改配置后，需要清除缓存让新配置生效：
```
php artisan config:clear
php artisan cache:clear
```
检查数据库全局时区设置
登录数据库执行以下SQL，确认数据库本身的时区配置：
```
SELECT @@global.time_zone, @@session.time_zone;
```
如果返回的不是America/Sao_Paulo或对应偏移量，需要修改数据库的配置文件（比如MySQL的my.cnf或my.ini），添加或修改：
```
default-time-zone = 'America/Sao_Paulo'
```
修改后重启数据库服务。