为什么Laravel API Resource中created_at格式和BaseModel设置不一致

开发者阿泽

2026-10-5

问题原因

你在BaseModel中重写的serializeDate方法，仅在直接对Eloquent模型执行toArray()/toJson()序列化时生效，只有直接在控制器返回模型实例的场景才会调用该方法。
你在API Resource的toArray方法中直接读取$this->created_at属性时，拿到的是原始的Carbon对象，不会触发模型的serializeDate逻辑。Laravel的API Resource在最终序列化响应时，会对Carbon对象调用默认的toJSON()方法，该方法的输出格式和你自定义的toIso8601String()结果不一致，因此出现格式被修改的问题。

解决方案

你可以选择任意一种方式统一格式：

Resource中手动调用自定义格式方法
直接在Resource中对日期字段调用你需要的格式方法即可：
```
'created_at' => $this->created_at->toIso8601String(),
```
全局修改Carbon的序列化默认格式
在AppServiceProvider的boot方法中添加全局配置，让所有Carbon对象序列化时都使用你指定的格式：
```
use Carbon\Carbon;

public function boot()
{
    Carbon::serializeUsing(function ($carbon) {
        return $carbon->toIso8601String();
    });
}
```
在Resource中复用模型的序列化方法
如果你不想单独处理每个日期字段，也可以直接调用模型已经重写好的序列化方法：
```
'created_at' => $this->serializeDate($this->created_at),
```