Hyperf模型中serializeDate不生效，需确认是否继承Hyperf\Database\Model\Model并实现JsonSerializable，且仅对date/datetime等Carbon字段生效；优先级上casts覆盖serializeDate，RPC/队列中可能因Normalizable绕过模型序列化逻辑。
Hyperf模型中serializeDate不生效？先确认是否用了JsonSerializable接口
Hyperf的Model类默认不实现JsonSerializable，所以即使你写了serializeDate属性，json_encode()也不会自动调用它。只有显式实现了JsonSerializable（比如继承Hyperf\Database\Model\Model并开启序列化支持），或手动调用toArray()/toJson()时，serializeDate才起作用。
实操建议：
- 确保模型继承的是
Hyperf\Database\Model\Model，而不是Illuminate\Database\Eloquent\Model（Laravel版） - 不要直接
echo json_encode($model)，改用$model->toJson()或$model->toArray() - 若需全局统一行为，可在基类模型中重写
jsonSerialize()方法，内部调用toArray()
serializeDate只对date、datetime字段类型生效
这个属性只影响数据库字段类型为date、datetime、timestamp等被Eloquent自动转为Carbon实例的列。如果你的字段是string类型但存了时间字符串（比如"2024-05-20 14:30:00"），serializeDate完全不会处理它。
常见错误现象：
- 字段在数据库里是
varchar，结果序列化后还是原始字符串，没走格式化 - 字段名拼错，比如写成
created_at_time但$dates数组里漏了它 - 用了
casts配置'created_at' => 'datetime:Y-m-d'，此时serializeDate会被绕过
格式优先级：casts > serializeDate > 默认Carbon::TO_JSON_STRING_FORMAT
当一个字段同时出现在$casts和$dates中时，casts的格式声明会覆盖serializeDate。例如：
protected $casts = [
'created_at' => 'datetime:Y/m/d H:i',
];
这时无论serializeDate设成什么，都无效。
使用场景判断：
- 只想统一改所有时间字段格式 → 用
serializeDate（简洁） - 个别字段要特殊格式（如
published_at输出Y-m-d，updated_at保持完整）→ 用$casts - 需要时区转换（比如转为
Asia/Shanghai）→ 必须在casts里写'datetime:Y-m-d H:i:s:u:Asia/Shanghai'，serializeDate不支持时区
Hyperf 3.x 中serializeDate可能被Hyperf\Contract\Normalizable干扰
如果项目启用了hyperf/json-rpc或自定义了Normalizer，某些序列化流程会跳过模型自身的toArray()逻辑，直接反射取属性，导致serializeDate失效。
排查方式：
- 在模型中加日志，看
toArray()是否被调用 - RPC响应里时间字段是原始
Carbon对象还是字符串？如果是对象，说明没走toArray() - 临时在
toArray()里硬编码修改created_at字段值，观察是否生效 —— 若生效，就是外部序列化路径绕过了模型逻辑
复杂点在于：同一个模型，在HTTP响应里格式正常，但在RPC或队列任务中又变回默认格式。这种场景下，不能只盯着serializeDate，得查清楚数据最终是被谁序列化的。
