ThinkPHP原生where不跳过空值，因null、''、[]均被直接生成SQL；手动过滤易误删0/'0'/false等合法值，应仅剔除null、空白字符串、空数组。
ThinkPHP 的 where 自动跳过空值为什么不行
因为 ThinkPHP 原生 where 不做空值判断——传 null、''、[] 进去，它照单全收，生成的 SQL 里就是 WHERE field = '' 或 WHERE field IS NULL，不是你想要的“忽略该条件”。这在搜索表单里特别坑：用户没填某字段，你本意是不加这个筛选，结果查出来一堆空匹配。
手动过滤空参数的三种常见写法及问题
很多人用 array_filter()，但默认行为会把 0、false、'0' 也干掉，导致数字 ID 为 0 或字符串 '0' 的合法数据被误剔除。
-
array_filter($params)—— 错，会删0和false -
array_filter($params, 'strlen')—— 错，0转字符串是'0'，长度为 1，能过；但null和[]过不去，且对对象/资源无效 -
array_filter($params, function($v) { return $v !== null && $v !== '' && $v !== [] && $v !== false; })—— 过于粗糙，false是合法布尔值，不该一刀切
真正要筛的，是「无意义的空」：空字符串、null、空数组、空白字符串（含空格）。而 0、false、'0'、0.0 都应保留。
推荐封装：用 filterEmptyWhere() 安全构建查询条件
写一个工具函数，只剔除明确无业务含义的空值，不碰数值和布尔上下文。关键点是区分「空」和「零值」：
立即学习“PHP免费学习笔记（深入）”；
function filterEmptyWhere(array $params): array
{
return array_filter($params, function($v) {
if ($v === null) return false;
if (is_string($v) && trim($v) === '') return false;
if (is_array($v) && empty($v)) return false;
return true;
});
}
用法示例：
$where = filterEmptyWhere([
'name' => $request->param('name', ''),
'status' => $request->param('status', 0), // 0 是有效状态码，保留
'category_id' => $request->param('category_id', null),
'tags' => $request->param('tags', []),
]);
Db::name('article')->where($where)->select();
注意：where() 接收关联数组时，内部是严格按键值对拼条件，不会帮你递归展开嵌套数组。所以这个函数只处理一级键值，别传多维结构进来。
复杂场景：带运算符的条件（如 ['name', 'like', '%abc%']）怎么过滤
这种三元组格式不能直接扔进 filterEmptyWhere()，得先解构再判断。通用做法是预处理成标准键值对，或单独写分支逻辑：
- 如果第三个元素（值）是空字符串/
null/空数组，整条条件跳过 - 像
['id', 'in', []]这种，in空数组会导致 SQL 报错，必须拦截 - 建议统一转成闭包式
where，更可控：->where(function ($query) use ($params) { if (!empty($params['name'])) { $query->where('name', 'like', '%' . $params['name'] . '%'); } if (isset($params['status']) && $params['status'] !== '') { $query->where('status', $params['status']); } })
闭包方式略啰嗦，但胜在语义清晰、边界明确，尤其适合混合运算符和空值校验的搜索页。
最易被忽略的是：前端传来的 '0' 字符串，在 PHP 弱类型下容易被当成 false 或 0 处理。务必在过滤前确认数据类型，必要时用 is_numeric() + !is_string() 组合判断是否真为数字零值，而不是字符串零。
