You need to enable JavaScript to run this app. Laravel Eloquent与原生SQL查询返回的created_at时间戳不一致问题
优惠活动
大模型
产品
解决方案
定价
更多

Laravel Eloquent与原生SQL查询返回的created_at时间戳不一致问题

问题本质

你碰到的时间值不一致,是Eloquent的默认序列化规则导致的,不是配置清理没生效:

  • 原生SQL查询直接返回数据库存储的原始字符串,没有经过框架的二次加工,所以和库里实际存储的2020-12-08 19:44:30完全一致
  • Eloquent查询生成的模型实例,会自动把created_at/updated_at识别为时间字段,转换为Carbon类实例;在模型集合被序列化为JSON响应返回时,框架默认会把Carbon对象强制转换为UTC时区的ISO 8601格式,也就是你看到的带T分隔符、Z(代表UTC时区)后缀的字符串。国内常用的东八区和UTC刚好差8小时,转换后的时间比库里存的本地时间少8小时,和你碰到的两个时间值的差值完全匹配。

就算在config/app.php中配置了应用时区,这个默认的JSON序列化转换规则也不会自动跟随应用时区调整。

对应解决方法
  • 重写模型的日期序列化逻辑,取消强制转UTC的默认行为,在Timeline模型中加入以下代码:
use DateTimeInterface;

class Timeline extends Model
{
    use HasFactory;

    protected $guarded = [];

    /**
     * 自定义日期的序列化输出格式
     */
    protected function serializeDate(DateTimeInterface $date)
    {
        return $date->format('Y-m-d H:i:s');
    }
}

如果需要让项目内所有模型都应用这个输出规则,可以把serializeDate方法写到应用的基类模型中,所有继承基类的模型都会自动生效,不需要在每个业务模型里重复编写。

  • 排查容易造成配置冲突的隐藏项:
    • 检查app/Providers/AppServiceProvider.php的boot方法,是否存在手动设置全局时区为UTC的代码,这类代码会直接覆盖config/app.php的时区配置
    • 检查config/database.php中对应数据库连接的timezone参数,确保连接时区和应用时区对齐,比如东八区对应配置为'+08:00'
  • 如果不需要Eloquent提供的自动时间戳管理能力,可以在模型中设置public $timestamps = false,此时Eloquent不会自动解析转换时间字段,返回结果会和原生SQL查询完全一致。但该方式会失去模型自动更新updated_at字段的能力,非必要不推荐。

内容的提问来源于stack exchange,提问作者stalwart1014

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 17:15:04