hyperf 3.0中eloquent模型accessor/mutator不生效的主因是命名不匹配、trait未显式注册、协程序列化绕过逻辑或auto_cast干扰；需严格遵循蛇形转驼峰规则、在模型中声明$appends/$casts，并避免trait中使用__get/__set。
模型修改器（accessor/mutator）不生效的典型现象
在Hyperf 3.0中给Eloquent模型定义getXXXAttribute或setXXXAttribute方法后，调用$model->xxx仍返回原始字段值，或$model->xxx = $val未触发写入逻辑。常见于字段名含下划线（如user_name）、使用as别名查询、或JSON字段解析场景。
命名必须严格匹配PSR-4 + 字段蛇形转驼峰规则
Hyperf 3.0沿用Laravel风格的自动推导，但依赖精确的命名映射。例如数据库字段last_login_at，对应accessor必须是getLastLoginAtAttribute，而不是GetLastLoginAtAttribute（首字母小写）或lastLoginAt（没加Attribute后缀）。
- 控制器中
dd($model->last_login_at)不会触发accessor；必须用$model->lastLoginAt（驼峰）才能命中 - 若字段名本身是驼峰（如
createdAt），则accessor应为getCreatedAtAttribute，而非getCreated_AtAttribute - 模型类名与文件名必须完全一致：类
UserProfile必须存于app/Model/UserProfile.php，否则Hyperf的DI容器无法正确反射
Trait中定义的修改器需手动注册到$casts或$appends
把accessor抽到Trait里很常见，但Hyperf 3.0不会自动扫描Trait中的方法。即使use FormatDateTrait，getCreatedAtAttribute也不会被识别。
- 必须在模型中显式声明：
protected $appends = ['createdAt']（对accessor）或protected $casts = ['data' => 'array']（对cast） - 若Trait中用了
__get或__set魔术方法，会直接绕过Eloquent的attribute机制，导致toArray()、jsonSerialize()失效 - 推荐改用
getAttribute重写：在模型中覆写该方法，内部调用Trait逻辑，确保所有序列化路径都走通
协程环境下toArray()可能跳过修改器
Hyperf 3.0默认启用Swoole JSON扩展加速序列化，但toArray()内部若提前调用getAttribute()而未触发accessor，就会漏掉转换逻辑。
- 不要依赖
return $model自动转JSON——它会跳过部分accessor；改用return $this->response->json($model->toArray()) - 对需要深度处理的字段（如把时间戳转ISO8601字符串），在accessor里加
if (! $this->getAttribute('created_at')) return null;防空指针 - 检查
config/autoload/db.php中'eloquent' => ['auto_casts' => true]是否开启，关闭它可避免隐式cast干扰自定义逻辑
dd(get_class_methods($model))确认方法是否存在，再看$model->getAttributes()和$model->getOriginal()的差异，比盲目加日志更快定位。
