when方法不触发是因为闭包未显式return查询对象，导致链式调用中断；且when首个参数为松散判真，需用is_numeric、!is_null等明确判断避免误判。
when 方法不触发？闭包里没写 return
闭包函数在 when 中必须显式 return 查询对象，否则链式调用中断，条件直接被丢弃。常见现象是：参数传进来了，但 SQL 里完全没体现这个条件。
-
when的第二个参数是闭包，它接收当前查询实例（$query），你要在这个闭包里调用where、whereIn等方法，并且 必须返回 $query - 漏掉
return $query是高频错误，尤其从 Laravel 迁移过来的人容易默认它自动返回 - ThinkPHP 6.0+ 的
when不支持布尔值短路跳过闭包执行——只要第一个参数为 true，闭包就一定会执行，不管里面有没有逻辑
// ❌ 错误：没有 return，条件不会生效
->when($status, function ($query) use ($status) {
$query->where('status', $status);
})
// ✅ 正确：显式返回查询对象
->when($status, function ($query) use ($status) {
return $query->where('status', $status);
})
多个 when 条件嵌套时，where 顺序影响最终 SQL
ThinkPHP 的查询构建器是“累积式”拼接，when 的执行顺序决定 WHERE 子句中条件的先后位置，这在涉及 AND/OR 混合或括号分组时会暴露问题。
- 每个
when块内只能操作当前$query实例，无法回退或重排已添加的条件 - 如果需要把某条件强制放在最外层括号里（比如和前面所有条件做 OR），不能靠调整
when顺序实现，得改用where+ 闭包分组 - 复杂组合建议拆成独立变量，先构造好子查询再合并，避免嵌套过深导致可读性崩坏
// 例如：想实现 (a = 1 AND b = 2) OR (c = 3)
// 不能只靠 when 堆叠，得这样：
->where(function ($query) use ($a, $b, $c) {
$query->where('a', $a)->where('b', $b);
})->whereOr(function ($query) use ($c) {
$query->where('c', $c);
})
闭包里用 use 传参，注意变量作用域和类型变化
闭包通过 use 引入外部变量，但 PHP 对引用和值传递的处理很严格，特别是当参数可能为 null、空数组或字符串 "0" 时，when 的判断逻辑容易出偏差。
-
when第一个参数是“判真值”，PHP 的松散比较会让0、""、null、[]全部视为 false，有时不符合业务预期 - 如果要区分
null和0，别直接传变量，改用回调函数：->when(!is_null($uid), function(...) {...}) - 数组类参数（如
$ids）建议加!empty($ids)判断，避免whereIn接收空数组导致 SQL 报错或全表扫描
// ❌ 可能误判：$page = 0 时整个分页逻辑被跳过
->when($page, function ($query) use ($page, $size) {
return $query->page($page, $size);
})
// ✅ 明确意图：只要 $page 是数字就参与分页
->when(is_numeric($page), function ($query) use ($page, $size) {
return $query->page($page, $size);
})
when 和 with 配合做关联动态加载，别在闭包里调 with
when 闭包里调用 with 不会报错，但实际无效——因为 with 必须在最终执行前（即 select() 或 find() 前）绑定到主查询上，而 when 闭包执行时机太晚，关联预载已被忽略。
立即学习“PHP免费学习笔记（深入）”；
- 动态关联加载必须把
with放在when外层，或者统一用with的条件版本（如with(['user' => function ($q) { ... }])） - 如果关联条件也需动态，优先在
with的闭包里做where，而不是试图用when控制是否加载 - 注意
with的键名大小写和模型定义一致，ThinkPHP 默认驼峰转下划线，但关联方法名写错会导致静默失败
// ❌ 无效：闭包里的 with 不起作用
->when($needUser, function ($query) {
return $query->with('user'); // 这行被忽略
})
// ✅ 正确：with 提前声明，内部闭包控制关联条件
->with(['user' => function ($q) use ($onlyActive) {
if ($onlyActive) {
$q->where('status', 1);
}
}])
实际写的时候最容易卡在闭包不 return 和 when 判真逻辑这两处，尤其是参数来自 HTTP 请求时，字符串 "0" 和整型 0 的差异会悄悄绕过条件。 
