获取器不生效主因是框架字段映射规则跳过：检查$hidden排除、命名是否严格驼峰（如create_time→getCreateTimeAttr）、$type声明与获取器冲突、NULL值未判空及必须return明确值。
获取器不生效，通常不是代码没写，而是被框架的字段映射规则“悄悄跳过”了。核心问题集中在字段可见性、命名规范、类型声明和空值处理这四点上。
检查字段是否被 $hidden 排除
TP6 默认只对未被 $hidden 排除、或显式列在 $visible 中的字段执行获取器。如果数据库字段是 nickname，但模型里写了：
-
protected $hidden = ['nickname'];→ 获取器getNicknameAttr完全不会调用 - 删掉这行，或改用
protected $visible = ['id', 'nickname', 'email'];显式声明
确认方法命名严格匹配驼峰规则
数据库字段名决定方法名，不能靠感觉写：
- 字段是
create_time→ 方法必须是getCreateTimeAttr - 写成
getCreate_timeAttr、getCreatetimeAttr或getcreate_timeAttr都静默失效 - 字段含数字或下划线（如
api_v2_token）→ 对应方法是getApiV2TokenAttr，下划线后字母必须大写
留意 $type 声明与获取器的冲突
如果字段已声明类型转换，获取器收到的可能不是原始值：
立即学习“PHP免费学习笔记（深入）”；
-
protected $type = ['create_time' => 'datetime'];会让$value进来就是 Carbon 实例，不是时间戳 - 此时再用
date('Y-m-d', $value)会出错或返回空 - 正确做法：判空后直接格式化 Carbon 实例，例如
$value?->format('Y-m-d') - 数据库该字段为 NULL 时，
$value是null，不判空直接操作会触发 warning
确保获取器有明确返回值
获取器函数必须 return，否则 PHP 默认返回 null，TP 序列化时可能跳过该字段：
- 即使只是占位，也要写
return '';或return $value; - 避免在获取器里访问未预加载的关联，比如
$this->user->name却没调with('user')，结果$this->user是 null，整个获取器返回 null - 安全写法是用
$this->getData('user')，它返回空对象/数组而非报错
