Laravel使用select()查询时accessors访问器不生效如何解决

根因说明 #

• 访问器内部逻辑依赖了select()语句未查询的字段：当你执行Doctor::select('name')->first()时，返回的模型实例仅加载了name字段，若你的getDoctorNameAttribute()方法中用到了id、职称等其他未被查询的字段，访问器无法获取对应值就会出现异常或返回空结果。
• $appends属性仅控制访问器结果是否随模型序列化输出，不会自动补充访问器依赖的缺失字段，因此仅配置$appends无法解决该问题。

可用解决方案 #

• 方案1：补充访问器依赖的所有字段到select查询列表
  确认你的访问器逻辑中用到的所有数据库字段，全部加入select的参数中，例如访问器需要用到id和name两个字段，修改查询语句为：

  App\Models\Doctor::select('id', 'name')->first()->doctor_name;
  

  访问器依赖的字段全部加载后即可正常运行。
• 方案2：移除select查询语句
  若业务场景不需要限定返回字段，直接删除select语句做全量查询即可，模型会加载所有表字段，访问器依赖的字段不会缺失。
• 方案3：检查访问器定义逻辑
  确认访问器逻辑中没有引用不存在的字段，若使用Laravel 9+的新版访问器语法，确认声明符合规范：
  旧版访问器示例：

  public function getDoctorNameAttribute()
  {
      // 确保用到的属性都已经被select查询加载
      return $this->name . '（' . $this->id . '）';
  }
  

  新版访问器示例：

  use Illuminate\Database\Eloquent\Casts\Attribute;
  
  protected function doctorName(): Attribute
  {
      return Attribute::make(
          get: fn () => $this->name . '（' . $this->id . '）',
      );
  }
  

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