TP8的whereIn传空数组会生成WHERE field IN ()导致MySQL语法错误，必须业务层显式判空：if (!empty($ids)) { $query->whereIn('id', $ids); }，禁用框架兜底或try-catch掩盖问题。
ThinkPHP 8 的 whereIN（注意是 whereIn，不是 whereln）方法在传入空数组时会直接生成语法错误的 SQL，比如 WHERE id IN ()，MySQL 拒绝执行并抛出异常 —— 这不是 ThinkPHP 的 bug，而是设计使然：它不主动拦截空数组，把校验责任交还给业务层。
whereIn 传空数组为什么会报错
TP8 的 whereIn 底层拼接的是原生 IN 子句，不做空数组兜底。一旦你传了 []，生成的 SQL 就是 WHERE field IN ()，MySQL 5.7+ 会直接报错 SQLSTATE[42000]: Syntax error or access violation: 1064 You have an error in your SQL syntax...。
- 空数组不会被自动跳过，也不会转成
WHERE 1=0或其他安全 fallback - 该行为与
whereNotIn一致，二者都依赖参数非空 - 日志里看到的往往是 PDO 抛出的
PDOException，而不是 ThinkPHP 自己的异常
怎么安全地用 whereIn 避免空数组崩溃
核心原则：**调用前必须判空**。不能依赖框架兜底，也不能靠 try-catch 吞掉这个本可预防的错误。
- 显式判断：
if (!empty($ids)) { $query->whereIn('id', $ids); } - 用三元构造完整查询链：
$query = Db::name('user'); $query = !empty($ids) ? $query->whereIn('id', $ids) : $query->where('id', 0);（后者用假条件保证语法合法） - 封装工具函数：
function safeWhereIn($query, $field, $values) { return empty($values) ? $query->where($field, 0) : $query->whereIn($field, $values); } - 特别注意：从请求参数、缓存或关联查询中取出来的数组，可能本身就是
null或字符串，要先is_array($values) && !empty($values)双重判断
为什么用 whereRaw('id IN (?)') 也不行
有人想绕过 whereIn 改用 whereRaw，但这条路更危险：
立即学习“PHP免费学习笔记（深入）”；
-
whereRaw('id IN (?)', [[]])会把空数组当单个参数绑定，最终还是变成IN (Array)，PDO 转义后仍是语法错误 -
whereRaw('id IN (' . implode(',', $ids) . ')')是 SQL 注入高危写法，$ids若含用户输入且未过滤，直接沦陷 - 动态拼接字段名或表名同理，必须走白名单校验，不能靠绑定参数解决
线上已炸怎么办：快速定位和临时修复
如果空数组导致接口大面积 500，优先做两件事：
- 查日志关键词：
IN ()、Syntax error、PDOException，快速定位出问题的控制器方法和参数来源（比如前端传了空的ids[]=） - 临时加 guard：在出问题的查询前插入
if (empty($ids)) { return []; }或返回空数据结构，避免 SQL 执行 - 别用
try/catch PDOException兜底——这掩盖了根本问题，且无法区分是空数组还是真数据库故障
空数组不是边缘 case，而是高频发生点：分页查无结果、前端多选未勾选、缓存穿透后 fallback 返回空列表……这些场景下，whereIn 的防御性检查必须写死在调用现场，不能指望“下次注意”。
