模型查询作用域失效的常见原因及解决：①本地作用域须以scope开头并接收$query参数；②调用时省略scope前缀且通过模型类调用；③避免后续where覆盖作用域条件，可用when或增强判断；④全局作用域需在boot中注册并实现scope接口。
模型查询作用域（Query Scope）失效，通常是因为调用方式不正确、作用域未被注册、或在链式调用中被后续方法覆盖。下面列出常见原因及对应解决代码。
确认作用域已正确定义并启用
Laravel 中的本地作用域必须以 scope 开头，且接收 $query 作为第一个参数：
// ✅ 正确写法（User.php 模型中）
public function scopeActive($query)
{
return $query->where('status', 'active');
}
// ❌ 错误写法（缺少 $query 参数或命名不规范）
public function active() { ... }
public function scopeActive() { ... } // 缺少 $query
调用时不要加 scope 前缀，且需在模型上调用
使用时直接写作用域名（不带 scope），且必须通过模型类或查询构造器调用：
-
✅ 正确：
User::active()->get()、User::query()->active()->get() -
❌ 错误：
User::scopeActive()->get()、(new User)->active()（实例调用无效）
避免 where() 等方法覆盖作用域条件
如果作用域里设置了 where('status', 'active')，但后续又调用 where('status', 'inactive')，后者会覆盖前者。可改用 when() 或检查是否已存在条件：
// 更健壮的作用域写法（防止被意外覆盖）
public function scopeActive($query)
{
return $query->whereNotNull('status')->where('status', 'active');
}
// 或配合 when 实现条件性追加
User::when($request->has('only_active'), function ($q) {
return $q->active();
})->get();
全局作用域未注册或未生效
若使用全局作用域（Global Scope），需确保已在 boot() 方法中正确附加：
protected static function boot()
{
parent::boot();
static::addGlobalScope(new ActiveScope); // ✅ 正确注册
// static::addGlobalScope('active', new ActiveScope); // 也可带名称
}
同时确认全局作用域类实现了 Illuminate\Database\Eloquent\Scope 接口，并在 apply() 方法中修改查询：
class ActiveScope implements Scope
{
public function apply(Builder $builder, Model $model)
{
$builder->where('status', 'active');
}
}
