Laravel 10扩展模型全局作用域失效问题排查

你遇到的问题是FieldPage模型的全局作用域未生效，导致调用FieldPage::all()时没有过滤type为'field'的数据。以下是排查和解决步骤：

1. 先确认全局作用域是否被正确应用 #

首先输出查询生成的SQL语句，检查WHERE条件是否存在：

// 在代码中执行此语句，查看输出的SQL
dd(FieldPage::query()->toSql());

如果SQL中没有WHERE type = 'field' #

• 检查Laravel版本适配：
  Laravel 8及以上版本使用booted()方法，而8以下版本需要使用boot()方法并调用父类的boot()：

  // Laravel 7及以下版本的正确写法
  protected static function boot()
  {
      parent::boot();
      static::addGlobalScope('field_pages', function (Builder $builder) {
          $builder->where('type', '=', 'field');
      });
  }
  

  如果你用的是Laravel 8+，确认booted()方法没有被其他逻辑覆盖，或者尝试手动调用parent::booted()：

  protected static function booted(): void
  {
      parent::booted();
      static::addGlobalScope('field_pages', function (Builder $builder) {
          $builder->where('type', '=', 'field');
      });
  }
  

• 检查是否被移除全局作用域：
  确认代码中没有在查询前调用withoutGlobalScope('field_pages')或withoutGlobalScopes()，这些方法会移除全局作用域。

如果SQL中包含WHERE条件，但仍返回所有类型 #

• 检查数据库数据匹配度：
  确认数据库中type字段的值是精确的'field'（注意大小写、空格等，比如'Field'或' field'都不会匹配）。
• 确认字段类型：
  确保type字段是字符串类型（如VARCHAR），如果是枚举类型，确认枚举值中包含'field'。

额外优化建议 #

如果是单表继承场景，也可以在FieldPage模型中直接定义$attributes属性，默认设置type值，避免创建时出错：

class FieldPage extends Page {
    protected $attributes = [
        'type' => 'field',
    ];

    protected static function booted(): void
    {
        static::addGlobalScope('field_pages', function (Builder $builder) {
            $builder->where('type', '=', 'field');
        });
    }
}

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