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
相关产品推荐
相关产品推荐

