Laravel 9 引入的 Attribute 类型 mutator 并非用于直接操作数据库，而是用于转换模型属性值；若需在设置时写入外部数据（如 key-value 设置表），必须让 setter 返回空数组 []，否则 Laravel 会尝试将该属性写入不存在的数据库列，导致 SQL 错误。
laravel 9 引入的 `attribute` 类型 mutator 并非用于直接操作数据库，而是用于转换模型属性值；若需在设置时写入外部数据（如 key-value 设置表），必须让 setter 返回空数组 `[]`，否则 laravel 会尝试将该属性写入不存在的数据库列，导致 sql 错误。
在 Laravel 9 及更高版本中，Attribute 类型的 mutator 设计理念发生了重要转变：它不再承担持久化职责，而仅负责对传入值进行转换，并将结果存入模型的 $attributes 数组——随后 Eloquent 会尝试将该数组中的键作为数据库字段执行 INSERT/UPDATE。因此，当你定义一个名为 someSetting() 的 mutator，但模型对应的数据库表中并不存在 some_setting 字段时，若 setter 函数未显式返回空数组，Laravel 默认会将 'some_setting' => null 写入 $attributes，最终触发 SQLSTATE[42S22]: Column not found 错误。
✅ 正确做法是：在 mutator 的 set 回调中执行自定义逻辑（如更新关联的 Setting 记录），并明确返回空数组 []。这会告知 Laravel：“此属性不映射任何数据库列，无需写入 $attributes”，从而避免字段冲突：
use Illuminate\Database\Eloquent\Casts\Attribute;
class Item extends Model
{
public function someSetting(): Attribute
{
$key = 'some_setting';
return Attribute::make(
set: function ($value) use ($key): array {
Setting::updateOrCreate(
[
'settable_id' => $this->id,
'settable_type' => self::class,
'key' => $key,
],
['value' => $value]
);
return []; // ✅ 关键：返回空数组，阻止写入 $attributes
}
);
}
}
这样，以下代码即可无缝继续使用（无需修改控制器）：
$item = Item::find(1); $item->update(['some_setting' => 'new_value']); // 成功更新 Setting 表，不报错
⚠️ 注意事项：
- 旧式 mutator（setXxxAttribute）并未被废弃：Laravel 11 文档仍明确支持，且行为稳定，可继续使用；Attribute 是新增推荐方式，非强制替换。
- 不要在 setter 中返回非数组值：返回 null、void 或任意非数组类型，Laravel 会将其作为属性值写入 $attributes，引发相同错误。
- 批量更新安全：update($data) 会逐个调用对应 mutator，因此 ['some_setting' => ...] 仍能正确触发逻辑。
-
进阶建议：对于高频使用的设置操作，可进一步封装为模型方法，提升可读性与复用性：
public function updateSetting(string $key, $value): void { $this->settings()->updateOrCreate(['key' => $key], ['value' => $value]); }
总结：Attribute mutator 的核心是“属性转换”，而非“数据持久化”。当需要副作用（如写入关联表）且无对应字段时，始终让 set 回调返回 [] —— 这是兼容新语法、零侵入迁移旧逻辑的关键实践。
