TP6模型中空值默认转null，应通过$type配置（如'string'转''、'integer'转0）或访问器精细控制；批量查询需显式调用toArray()或each触发转换，datetime类型须带格式才兼容NULL。
空值字段在TP6模型中默认返回null，但前端常要空字符串或0
ThinkPHP 6 的 ORM 默认将数据库 NULL 值映射为 PHP null，这在 JSON 输出时会变成 null 字段，前端容易报错或渲染异常。比如 user.nickname 是 NULL，API 返回 {"nickname": null}，而业务实际希望是 {"nickname": ""}。
不建议全局用 json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PARTIAL_OUTPUT_ON_ERROR) 强转，那只是掩盖问题——空值语义丢失，且无法区分“本意就是 null”和“数据库没填”。
推荐做法是在模型层做细粒度控制：
- 对字符串字段，用
protected $type = ['nickname' => 'string'];，TP 会自动把NULL转成'' - 对整型字段（如
status），设'status' => 'integer'，NULL会转成0（注意：不是0的业务含义，而是类型兜底） - 若需保留
NULL语义（例如“未知状态”不能等同于“0”），改用访问器：public function getNicknameAttr($value) { return $value === null ? '' : $value; }
使用toArray()时，NULL未被$type转换？检查是否启用了auto_write_timestamp或软删除
常见陷阱：明明写了 $type = ['name' => 'string']，但调用 $user->toArray() 后 name 还是 null。大概率是因为该模型开启了 auto_write_timestamp 或继承了 SoftDelete，导致 TP 内部跳过了字段类型转换流程。
立即学习“PHP免费学习笔记（深入）”；
验证方式：打印 $user->getData() 和 $user->toArray() 对比，前者走原始数据+类型转换，后者可能绕过。
解决方法：
- 优先用
$user->toArray(['name', 'email'])显式指定字段，触发类型转换 - 或统一改用
$user->toJSON()，它强制走序列化器逻辑，$type生效 - 禁用软删除字段的自动处理：在模型中加
protected $withTrashed = false;，避免干扰
批量查询时NULL格式化失效？collection对象不自动应用$type
Db::table('user')->select() 返回的是原生数组，$type 完全不生效；UserModel::select() 返回 Collection，但它默认只对单个模型实例做类型转换，批量时不会逐条调用 toArray()。
现象：查出 10 条用户，nickname 全是 null，即使模型定义了 'nickname' => 'string'。
正确做法：
- 用
UserModel::select()->each(function ($item) { return $item->toArray(); });手动触发每条的类型转换 - 更高效：直接用
UserModel::field('id,name,nickname')->select()->toArray()，显式字段 +toArray()组合可激活类型处理 - 终极方案：写一个复用的
formatNulls()辅助函数，对结果数组做递归填充：array_map(fn($v) => is_null($v) ? '' : $v, $row)，但仅限简单场景，会丢失字段语义
JSON输出时日期字段也变null？datetime类型配置必须带格式
数据库 created_at 为 NULL 时，即使设了 'created_at' => 'datetime'，toArray() 仍返回 null，因为 TP 的 datetime 类型转换器默认只处理非空值。
必须显式指定格式才能启用空值兼容：
-
'created_at' => 'datetime:Y-m-d H:i:s'——NULL会转为空字符串 -
'created_at' => 'datetime:timestamp'——NULL转为0 - 如果想保持
NULL，就别配datetime类型，改用访问器：public function getCreatedAtAttr($value) { return $value ? date('Y-m-d H:i:s', $value) : null; }
注意：timestamp 格式下，NULL → 0 对应 Unix 时间起点，前端 new Date(0) 会显示 1970 年，务必确认业务能否接受。
