TP6.0模型修改器不执行？检查字段类型并调用save方法

TP6.0 模型修改器不执行的问题，很多开发者都曾遇到过。常见原因可归纳为几类：字段名与方法名不匹配、赋值后忘记调用 save()，或者使用了 data() 这类绕过模型逻辑的“暴力”方式。下面逐一拆解关键点。

确认字段命名与修改器方法名严格一致

字段采用下划线命名（例如 user_name），对应的修改器方法名必须为驼峰式且首字母大写——setUserNameAttr，不能写成 setusernameattr 或 set_user_name_attr。TP6 不会自动转换，大小写与驼峰规则必须手动对齐，否则框架会直接静默跳过，且不给出任何报错。

因此，打开模型类，检查方法名是否严格按照 set + 字段名驼峰 + Attr 的格式。例如：字段 password → setPasswordAttr，字段 last_login_time → setLastLoginTimeAttr。如果方法名写成全小写（如 setpasswordattr），框架无法识别，也不会报错，修改器相当于无效。

确保修改器仅在 save / create / update 时触发

这一点容易误解：修改器并非“赋值即生效”，而是只在模型执行写入操作时才会执行。以下列举几种情况：

触发修改器：

• $user = new User(); $user->password = '123'; $user->save();
• User::create(['password' => '123']);
• $user = User::find(1); $user->password = 'new'; $user->save();

不触发修改器：

• $user->password = '123'; // 仅赋值，缺少 save()
• $user->data(['password' => '123'])->save(); // data() 方法会绕过所有修改器逻辑

【data() 是高危操作，它会直接填充原始数据数组，跳过验证、修改器、自动时间戳等全部模型层逻辑】 因此，如果使用了 data()，即使后续调用了 save()，修改器也不会执行。

检查字段是否被排除在写入范围之外

若以上步骤均正确，但修改器仍不执行，则需排查字段是否被“屏蔽”。分三步检查：

第一步：确认该字段未被 protected $readonly 或 protected $disuse 包含，这两个属性会直接导致字段在写入时被忽略。

第二步：检查 save() 调用时是否传入了 allowField 参数，例如 $user->allowField(['id', 'name'])->save() —— 如果 password 不在这个白名单中，它会被彻底忽略，修改器自然不执行。

第三步：查看数据库表结构，确认字段确实存在且类型可写。例如字段设置为 GENERATED ALWAYS AS（生成列）时，TP6 无法写入，save() 会静默跳过该字段，修改器也随之失效。