ThinkPHP 6.0 中闭包是构建混合逻辑查询的唯一可靠方式；每个逻辑组须用闭包包裹，组间用 whereOr 或外层 where 连接，需注意表别名、空值过滤及 LIKE 转义。
ThinkPHP 6.0 中，闭包是构建混合逻辑（AND + OR）查询的唯一可靠方式。直接链式调用 where 和 whereOr 容易因运算符优先级导致括号缺失，结果不符合预期。核心原则是：**每个独立逻辑组必须用一个闭包包裹，组间连接靠 whereOr 或外层 where 控制**。
单层闭包处理 “(A AND B) OR C”
当需要先满足一组 AND 条件，再与另一个条件做 OR 连接时，把 AND 组放进闭包，再用 whereOr 接后续条件：
-
->where(function ($q) { $q->where('status', 1)->where('score', '>=', 80); })→ 生成(status = 1 AND score >= 80) -
->whereOr('type', 'vip')→ 外层追加OR type = 'vip' - 最终 SQL 是：
WHERE (status = 1 AND score >= 80) OR type = 'vip'
多组 AND 并列用 whereOr + 闭包
要表达 “(A AND B) OR (C AND D)” 这类结构，必须为每组 AND 单独写闭包，并用 whereOr 连接它们：
- 第一组：
->where(function ($q) { $q->where('status', 1)->where('level', 'gold'); }) - 第二组：
->whereOr(function ($q) { $q->where('score', '>', 95)->where('verified', 1); }) - 不能写成
->whereOr(['status' => 1, 'level' => 'gold'])，那样会变成字段级 OR，不是逻辑组 OR
嵌套 OR 与字段别名避坑
连表查询中，闭包内字段若不带表别名，极易歧义或报错：
立即学习“PHP免费学习笔记（深入）”；
- 正确写法：
$query->where('o.status', 'paid')->where('u.is_deleted', 0) - 错误写法：
$query->where('status', 'paid')（数据库无法判断是哪张表的 status） - 即使单表也建议统一加别名（如
user u），后续扩展更安全
空值过滤与动态条件组装
来自表单的搜索参数常含空字符串、null 或 0，这些值若不清理，会进入 SQL 导致误查：
- 手动过滤：
if (!empty($data['title'])) $query->where('title', 'like', "%{$data['title']}%"); - 数组方式只适合固定字段；动态字段或复杂逻辑必须用闭包
- LIKE 搜索记得转义通配符，且确保数据库字符集为 utf8mb4
