Laravel API返回日期与实际存储日期相差1天问题求助

这是典型的时区不匹配问题——数据库存储的日期是UTC标准时间，而API返回/序列化过程中自动做了时区转换，导致日期偏移一天。以下是具体解决步骤：

• 对齐数据库与API服务时区
  先确认数据库时区（比如MySQL执行SELECT @@global.time_zone;）和API运行环境的时区是否一致。如果数据库存UTC，API需要将其转换为业务所需时区后再返回。

• 修改序列化规则强制指定时区
  若使用ORM框架，直接在序列化层配置日期字段的输出时区，避免自动转换：

  • Python/Django示例：

    from rest_framework import serializers
    import pytz
    
    class YourModelSerializer(serializers.ModelSerializer):
        tanggal_mulai = serializers.DateTimeField(format="%Y-%m-%d", default_timezone=pytz.timezone('Asia/Jakarta'))
        tanggal_selesai = serializers.DateTimeField(format="%Y-%m-%d", default_timezone=pytz.timezone('Asia/Jakarta'))
    
        class Meta:
            model = YourModel
            fields = ['tanggal_mulai', 'tanggal_selesai']
    

  • Java/Spring Boot示例：

    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd", timezone = "Asia/Jakarta")
    private LocalDate tanggalMulai;
    
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd", timezone = "Asia/Jakarta")
    private LocalDate tanggalSelesai;
    

• 数据库查询时直接转换时区
  不想改代码的话，可在查询阶段将UTC日期转为目标时区的日期，比如MySQL：

  SELECT CONVERT_TZ(tanggal_mulai, '+00:00', '+07:00') AS tanggal_mulai,
         CONVERT_TZ(tanggal_selesai, '+00:00', '+07:00') AS tanggal_selesai
  FROM your_table;
  

  替换+07:00为你业务对应的时区偏移量。

• 排查前端解析逻辑
  确认前端是否用new Date()解析日期时自动转成了本地时区，导致显示错误。这种情况直接把日期当作字符串处理即可，无需用Date对象解析。

内容的提问来源于stack exchange，提问作者Richard Kyle