ThinkPHP模型对象不能直接json_encode，应先调用toArray()转换为数组再编码；需注意hidden/visible控制、时间格式配置、关联数据append、type转换生效范围及API响应的显式数据处理。
ThinkPHP模型对象直接json_encode失败
直接对 ThinkPHP 的模型对象（比如 User::find(1) 返回的实例）调用 json_encode，结果通常是空对象 {} 或报错 Recursion detected。这是因为模型对象内部有大量闭包、资源句柄和循环引用（如 self::$model、$this->data 和 $this->relation 互相持有），PHP 原生序列化无法安全处理。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 永远不要对模型对象裸调
json_encode - 优先用模型自带的
toArray()转为纯数组再编码：$user = User::find(1);<br>echo json_encode($user->toArray());
- 若需保留部分隐藏字段（如
create_time被设置为hidden），可在模型中临时关闭：$user->visible(['id', 'name', 'create_time']);<br>echo json_encode($user->toArray());
使用toJson()方法但时间格式不对
toJson() 看似方便，但默认会把 datetime 字段转成 ISO8601 字符串（如 "2024-05-20T14:23:01+00:00"），而前端常要 "2024-05-20 14:23:01" 这类格式，且时区可能错乱。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在模型类中统一配置时间输出格式：
protected $dateFormat = 'Y-m-d H:i:s';
- 若只针对某次查询调整，用
withAttr显式转换：$user = User::withAttr('create_time', function($value) {<br> return $value ? date('Y-m-d H:i:s', strtotime($value)) : null;<br>})->find(1);<br>echo $user->toJson(); - 注意：一旦用了
withAttr，该字段就不再走$dateFormat，两者不要重复配置
关联数据没被包含进 JSON
调用 $user->toJson() 或 $user->toArray() 默认不加载关联模型（如 profile、posts），即使你之前写了 with('profile')，也仅在查询时预载入，不会自动进入序列化结果。
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 必须显式调用
append方法声明要导出的关联：$user = User::with('profile')->find(1);<br>$user->append(['profile']); // 这行不能少<br>echo $user->toJson(); - 如果关联字段名和关联方法名不一致（如方法叫
userProfile()，想暴露为profile），需在模型里定义getProfileAttr访问器，或改用visible+toArray() - 深层嵌套关联（如
user→profile→avatar）需逐级append，ThinkPHP 不支持点号路径写法
API 接口返回 JSON 时的常见遗漏点
控制器里写 return json($user) 看似没问题，但容易忽略底层行为：ThinkPHP 的 json() 辅助函数会对传入值做类型判断，若传入模型对象，它内部其实已调用了 toArray()；但如果模型里重写了 toArray() 或定义了大量 getxxxAttr，结果可能和预期不一致。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 接口层尽量明确数据形态，避免依赖框架隐式转换：
return json(['code' => 0, 'data' => $user->hidden(['password'])->toArray()]);
- 检查模型是否启用了
type转换（如'status' => 'integer'），这类转换只在toArray()中生效，toJson()会跳过，导致数字变字符串 - 若用
Resource类（V6.1+），务必确认toArray()方法里已手动处理了所有需要的字段，包括关联、格式化、权限过滤等——它不会自动继承模型的hidden或visible
最稳妥的做法是：先用 toArray() 得到确定结构的数组，再封装进标准响应体。模型对象不是数据容器，只是数据构造器；JSON 输出前，它早该“卸妆”完毕了。
