ThinkPHP模型获取器不生效的主因是命名错误或使用场景不当：方法名须严格为_status_getStatusAttr（TP5.1）或getStatusAttr（TP6），仅对模型属性访问有效，不作用于getData()、关联模型、Db查询及写入流程。
ThinkPHP 模型获取器 _getAttr 不生效？先确认是否写对了命名规则
获取器方法名必须严格匹配字段名 + _get + 字段首字母大写 + Attr，比如字段叫 status，方法就得是 _getStatusAttr；写成 _getstatusAttr 或 _getStatusattr 都不会触发。TP6 里还支持更简洁的 getStatusAttr（去掉下划线），但老项目若用 TP5.1，必须带开头下划线。
常见错误现象：dump($model->status) 输出原始值，没走格式化；dump($model->toArray()) 里也还是原始值——说明获取器根本没被调用。
- 检查方法是否定义在模型类内部，且为
public（TP5/6 均要求） - 确保字段名和方法中字段部分完全一致（区分大小写，不自动转驼峰）
- TP5.1 中，获取器仅对读取属性有效，
$model->getData('status')不触发；TP6 支持getData()和属性访问双触发
获取器返回值被忽略？注意不要在方法里直接 return $this
很多人习惯链式调用，在获取器里写 return $this 或 return $this->status，结果数据没变。获取器的唯一作用是“转换当前字段的输出值”，它不该改模型状态，也不该返回整个对象。
正确做法是只返回处理后的值。比如把数字状态转中文：
立即学习“PHP免费学习笔记（深入）”；
public function _getStatusAttr($value)
{
$map = [0 => '待审核', 1 => '已通过', 2 => '已拒绝'];
return $map[$value] ?? '未知';
}
- 传入参数
$value是数据库查出的原始值，不是模型实例 - 如果字段可能为
null，记得判空，否则$map[null]会报 notice - 不要在获取器里调用
save()、where()等操作——它只负责读，不负责写或查
关联字段 + 获取器一起用，为什么格式化失效？
比如定义了 user 关联，并希望 user.name 经过获取器处理，但发现 $model->user->name 还是原始值。这是因为获取器只作用于当前模型的字段，不穿透到关联模型。
要让关联数据也格式化，得在关联模型（如 UserModel）里单独定义 _getNameAttr。主模型的获取器管不了别人的数据。
-
$model->toArray()默认只展开一级关联，深层嵌套需手动调用with(['user'])并确保关联模型自己有对应获取器 - TP6 的
hidden/visible属性控制的是字段可见性，不影响获取器执行时机 - 如果用了
append添加动态属性（如full_name），它的获取器命名是getFullNameAttr，和数据库字段无关
TP5.1 升级到 TP6 后获取器行为变化要点
TP6 把获取器逻辑统一进访问器体系，去掉了强制下划线前缀，同时修复了部分场景下 toArray() 不触发的问题。但这也带来兼容风险：老代码里 _getStatusAttr 在 TP6 仍可用，但如果你混用 getStatusAttr 和 _getStatusAttr，后者会被忽略。
- TP6 推荐统一用
getStatusAttr形式，避免下划线冲突 - TP6 中，获取器对
json类型字段默认不自动解析，需手动json_decode，而 TP5.1 有时会隐式处理 - 批量赋值（
data([...])->save()）时，获取器不参与写入流程，只影响读——这点两版一致，但容易误以为能用来预处理入库数据
最常被忽略的一点：获取器只在模型实例被访问时才执行，如果直接从查询构造器拿数组（Db::table()->select()），根本不会经过模型层，自然也没有获取器什么事。
