访问器仅在读取属性、toArray()、toJson()时生效，不参与查询；需正确配置$dates或$casts确保Carbon实例，$appends声明虚拟字段，用getRawOriginal()获取原始值，返回类型须统一。
访问器不是万能的格式化开关，它只在你“读取属性”时生效，且不能替代数据库层或序列化配置的职责。 直接在模型里写 getCreatedAtAttribute 看似简单，但若没处理好 Carbon 实例、时区、原始值获取等细节，反而会让日期显示错乱、API 返回不一致、导出数据失真。
访问器触发时机与常见误用场景
访问器只在以下情况自动调用：$user->created_at、$user->toArray()、$user->toJson()。但它不会在 where 查询、orderBy、pluck 或 select('created_at') 中触发——这些操作走的是原始 SQL 字段，访问器完全不参与。
常见误用包括：
- 在访问器里做数据库查询（如
User::where(...)->first()），引发 N+1 问题 - 把
getFullNameAttribute当作计算字段用于orderBy('full_name')，结果报错或排序失效 - 在 Blade 模板中反复写
$user->getCreatedAtAttribute($user->created_at)，手动调用破坏了访问器设计本意
日期字段必须先确认是否已被 Carbon 包装
Laravel 默认将 created_at、updated_at 和 $dates 数组中声明的字段转为 Carbon 实例。但如果你自定义了日期字段（比如 published_at），又没加进 $dates，那传给 getPublishedAtAttribute 的就是一个字符串，不是 Carbon 对象——直接调用 format() 会报错。
正确做法是：
- 先在模型中声明：
protected $dates = ['published_at']; - 或改用
$casts（Laravel 7+ 推荐）：protected $casts = ['published_at' => 'datetime']; - 再写访问器：
public function getPublishedAtAttribute($value) { return $value ? $value->format('Y-m-d H:i') : null; }
需要输出但不在数据库中的字段，必须加到 $appends
比如你想提供一个 is_active_text 属性，返回 “启用” 或 “停用”，这个字段不存在于数据库，仅靠 getIsActiveTextAttribute 方法还不够。
否则：$user->is_active_text 能取到值，但 $user->toArray() 或 JSON 响应里不会包含它。
对设计或页面进行 WCAG 2.1 AA 无障碍审计。触发关键词：“audit accessibility”、 “check a11y”、 “is this accessible?” 或在审查设计时使用。
必须显式声明：protected $appends = ['is_active_text'];
同时注意：$appends 中的字段名要和访问器方法名前缀一致（去掉 get 和 Attribute），即 getIsActiveTextAttribute → is_active_text。
绕过访问器读原始值：用 getRawOriginal()
当你要比对修改前后值、记录审计日志、导出原始时间戳，就不能依赖 $user->created_at——它已经被访问器格式化过了。
此时必须用：$user->getRawOriginal('created_at')，它返回数据库存储的原始值（如 "2025-03-12 14:22:08" 或 1710253328，取决于字段类型）。
注意：getOriginal() 不可靠，它返回的是“上次同步后的值”，可能已被修改器或其它逻辑污染；getRawOriginal() 才是真正从数据库捞出来的那一行原始数据。
最常被忽略的一点：访问器返回值类型必须稳定。比如 getAvatarUrlAttribute 在用户没上传头像时返回空字符串，有头像时返回 URL，前端就容易因类型不一致出 bug。建议统一返回 null 或带默认占位符的字符串，并在文档/注释里明确契约。
