ThinkPHP6.1全局查询范围失效主因是配置、定义或调用错位：需确保作用域为public static方法且无scope前缀，模型不设$globalScope属性，避免withoutGlobalScope()或Db::name()绕过模型，并解决多模型同名作用域导致的字段歧义。
ThinkPHP6.1中全局查询范围（global scope）失效，不是“没写”，而是配置、定义或调用环节出现错位。重点排查三处：模型是否真正启用、方法签名是否合规、多模型关联时是否引发字段歧义。
检查全局作用域定义是否正确
TP6.1要求全局作用域必须是 public static 方法，且方法名不能带 scope 前缀，签名必须接收 $query 参数并操作它：
- ✅ 正确写法：public static function base($query) { $query->where('status', 1); }
- ❌ 错误写法：protected function base($query)（权限不对）、public function base()（缺 $query 参数）、public static function scopeBase($query)（名字带 scope，框架不识别）
- 模型类中无需声明
$globalScope属性 —— TP6.1 已废弃该写法，只认符合规范的静态方法名（如 base、common 等）
确认模型是否自动加载了全局作用域
全局作用域默认生效，但以下情况会跳过：
- 调用了
withoutGlobalScope()或useGlobalScope(false)，检查链式调用中是否误加 - 使用
Db::name('user')直连数据库，绕过了模型层 → 全局作用域完全不触发 - 模型继承自其他基类，而基类里覆盖了
base()却未调用parent::base($query)，导致子类作用域被覆盖
排查多模型关联引发的 SQL 字段冲突
当 User 和 Post 模型都定义了同名全局作用域（如都写 base($query) { $query->where('status', 1); }），再执行关联查询（如 User::with('posts')->select()），SQL 中会出现两个 status 条件，报错 Column 'status' in where clause is ambiguous —— 这会导致整个查询中断，看似“全局作用域失效”，实则是 SQL 解析失败。
立即学习“PHP免费学习笔记（深入）”；
- 解决方案：给字段加表别名，例如
$query->where('user.status', 1)和$query->where('post.status', 1) - 或改用闭包方式在关联定义中显式控制：
return $this->hasMany(Post::class)->when(!app()->isConsole(), function ($q) { $q->where('status', 1); });
验证是否生效的快捷方式
不要只看结果数据，直接观察生成的 SQL：
- 执行
User::buildSql()，查看输出 SQL 是否包含全局条件（如WHERE `status` = 1） - 若无，说明作用域未加载；若有但报错，则聚焦字段歧义或类型冲突
- 开启调试模式后，在日志中搜索
think\db\Connection相关记录，确认实际执行语句
