Laravel 8模型配置$appends追加虚拟属性后报字段不存在SQL错误如何解决

这个问题出现的核心原因是虚拟属性hello被写入了模型的$attributes属性数组，Laravel在执行保存操作时会把$attributes里的所有键都当成数据库字段拼接进SQL，就触发了字段不存在的错误，你可以通过以下几种方式解决：

• 方法1：为虚拟属性定义对应访问器
  你只在$appends里声明了要追加hello属性，但没有定义访问器，Laravel不会把它识别为虚拟属性。根据你使用的Laravel版本选择对应写法：

  • Laravel 9及以上版本：

  use Illuminate\Database\Eloquent\Casts\Attribute;
  
  class Users extends Model  {
      protected $appends = ['hello'];
  
      protected function hello(): Attribute
      {
          return Attribute::make(
              get: function ($value, $attributes) {
                  // 自定义返回你需要的属性值即可
                  return '你要返回的任意数据';
              }
          );
      }
  }
  

  • Laravel 8及更早版本：

  class Users extends Model  {
      protected $appends = ['hello'];
  
      public function getHelloAttribute()
      {
          // 自定义返回你需要的属性值即可
          return '你要返回的任意数据';
      }
  }
  

• 方法2：单独存储虚拟属性的自定义值
  如果你需要主动给hello赋值存储自定义内容，不要直接写$model->hello = xxx，这会直接把hello写入$attributes。可以在模型里单独声明一个非Eloquent属性存值：

use Illuminate\Database\Eloquent\Casts\Attribute;

class Users extends Model  {
    protected $appends = ['hello'];
    // 单独声明公共属性存储hello的值，不会和数据库字段混淆
    public $custom_hello_value;

    protected function hello(): Attribute
    {
        return Attribute::make(
            get: fn () => $this->custom_hello_value
        );
    }
}

后续赋值时用$model->custom_hello_value = '任意要存储的数据'，读取时仍可正常通过$model->hello获取值。

• 方法3：临时移除属性或指定更新字段
  如果你不想修改模型定义，可以在保存操作前手动移除$attributes里的hello，或者更新时指定仅更新目标字段：

// 方式1：更新时指定仅操作目标字段
$Model->only(['username'])->update(['username' => 'some username']);

// 方式2：保存前手动移除虚拟属性
$Model->offsetUnset('hello');
$Model->save();

• 方法4：调整批量赋值配置
  如果你的模型用了$fillable批量赋值白名单，确保hello没有加入白名单，避免批量赋值时被误写入$attributes。如果用的是$guarded黑名单，可以把hello加入$guarded数组：

protected $guarded = ['hello'];

内容的提问来源于stack exchange，提问作者user8555937