Hyperf模型casts不生效主因是未触发属性访问逻辑，仅显式调用getAttribute()、toArray()或访问驼峰属性时才执行；绕过模型的原生查询、直接读attributes或getAttributes()均无效，且受MySQL严格模式、空值、格式非法等影响。
Hyperf 模型 casts 不生效的常见原因
Hyperf 的 Model 类默认不自动调用 casts 转换，除非你显式调用 toArray()、jsonSerialize() 或访问 $model->attributes 以外的属性（如 $model->created_at）。直接从 $model->getAttributes() 或原始查询结果中取值，casts 完全不会触发。
这导致一个典型问题：数据库里存的是 TINYINT(1)，模型定义了 'is_active' => 'boolean'，但 $user->is_active 返回的是整数 1 而非 true。
- 只在构造模型后首次访问字段时触发 cast（惰性转换），且仅限于“访问属性”而非“读取原始数据”
-
find()、first()等方法返回的模型对象，其casts是延迟应用的，不是查询时就转换 - 使用
selectRaw()、DB::table()->get()等绕过模型的查询，casts完全无效
如何确保查询结果字段被正确 cast
最可靠的方式是让模型真正“走一遍访问逻辑”，而不是依赖原始数组。以下操作能强制触发 casts：
- 用
$model->getAttribute('field')替代直接读$model->field—— 这会经过getAttribute()方法，触发 cast - 调用
$model->toArray()后再取值，该方法内部遍历所有casts并转换 - 对集合调用
mapInto()或each()触发每个模型的属性访问，避免批量漏转 - 避免在模型外用
DB::select()或Query\Builder直接查原生数组，这类结果永远不走casts
示例：$user = User::find(1); echo gettype($user->is_active); // int；echo gettype($user->getAttribute('is_active')); // boolean
cast 失败的隐藏陷阱：MySQL 的严格模式与类型推导
Hyperf 使用 PDO 默认获取的是字符串类型字段值（即使数据库是 INT 或 BOOLEAN），而 casts 中的 'integer'、'boolean' 依赖 PHP 类型转换函数（如 (int)、filter_var(..., FILTER_VALIDATE_BOOLEAN)）。当字段值是空字符串 ''、NULL 字符串或带空格的数字（如 " 1 "）时，转换会静默失败或返回意外值。
- MySQL 开启
STRICT_TRANS_TABLES时，TINYINT存2可能被截断为1，但 PHP 仍收到字符串"1"，cast 成true—— 表面正常，实则数据已失真 -
casts对'datetime'和'date'依赖Carbon::parse()，若数据库字段含非法格式（如"0000-00-00"），会抛异常而非静默 fallback - 自定义 cast 类必须实现
get()和set()，否则字段写入/读取都跳过转换
更健壮的替代方案：用 Attribute + Cast 组合控制
Hyperf 2.2+ 支持 Laravel 风格的访问器（getFooAttribute）和 Attribute 类，比 casts 更可控。尤其适合需要条件判断、空值处理或跨字段逻辑的场景。
- 定义
public function isActive(): Attribute，在get闭包里手动处理0/1/'true'/'false'等各种可能输入 - 配合
AsBoolean这类内置 Cast 类（需hyperf/database≥ v3.1），它比原生'boolean'更宽容 - 对 JSON 字段，优先用
'json'cast 而非'array'，避免因 MySQL 返回字符串导致json_decode失败 - 调试时可临时加日志：
var_dump($this->original['is_active'], $this->attributes['is_active']);区分原始值与 cast 后值
复杂业务字段别硬塞进 casts，访问器 + 显式类型检查才是稳定解法。
