Hyperf中PDO不支持数组直接绑定IN参数，必须用Model::whereIn()自动展开或手动构造等量占位符；空数组返回空集，含null自动过滤，超大数组需分批或改用临时表。
Hyperf 中 MySQL 客户端对 IN 参数的原生限制
Hyperf 默认使用的 mysql 驱动（基于 PDO）不支持直接将数组绑定到 IN 占位符，比如写成 WHERE id IN (?) 并传入 [1,2,3] —— 这会被当做一个整体字符串或 NULL 处理，最终查不到数据或报错 Invalid parameter number。
根本原因是 PDO 的预处理机制只接受标量值（string/int/bool/null），不展开数组。Hyperf 的 Db::select()、QueryBuilder 或 Model::whereIn() 内部虽做了封装，但底层仍受限于 PDO 绑定规则。
- 硬写
WHERE id IN (:ids)+['ids' => [1,2,3]]会失败 - 用字符串拼接
"IN (" . implode(',', $ids) . ")"有 SQL 注入风险，禁止在生产环境使用 -
Model::whereIn('id', $ids)是安全且推荐的入口，它会自动拆解数组、生成对应数量的占位符并绑定
Model::whereIn() 的正确用法与边界条件
这是最稳妥、也最符合 Hyperf 工程规范的写法，内部已处理类型推导、空数组、NULL 值过滤等细节。
示例：
$ids = [101, 205, 318];
User::whereIn('id', $ids)->get(); // ✅ 自动生成 WHERE id IN (?, ?, ?)注意以下实际场景中的行为：
- 空数组
[]：查询直接返回空集合（不会生成WHERE id IN ()报语法错误） - 含
null的数组[1, null, 3]：whereIn会自动过滤掉null，生成IN (1, 3)，避免触发UNKNOWN逻辑 - 超大数组（如 > 5000 个 ID）：MySQL 可能因
max_allowed_packet或解析开销拒绝执行；建议分批查询或改用临时表 + JOIN - 字符串字段需确保编码一致：若
$names = ['张三', '李四']，whereIn('name', $names)会自动加单引号，无需手动转义
原生 QueryBuilder 手动构造 IN 的安全方式
当必须脱离 Model、用 Db::table() 或 Query 构建复杂条件时，不能靠字符串拼接，得靠占位符动态扩展。
正确做法是用 array_fill 生成占位符列表，再用 array_merge 合并参数：
$ids = [1, 5, 8, 12];
$placeholders = str_repeat('?,', count($ids) - 1) . '?';
$result = Db::select("SELECT * FROM users WHERE id IN ($placeholders)", $ids);这个写法的关键点：
- 占位符数量必须与数组长度严格一致，否则 PDO 绑定失败
- 不要用
implode(', ', array_map(fn($i) => '?', $ids))—— 多余空格可能导致某些 MySQL 版本解析异常 - 如果数组来自用户输入，务必先用
is_numeric()或白名单校验类型，防止恶意类型绕过（如传入对象触发 __toString 魔术方法）
NOT IN 场景下必须绕开 NULL 陷阱
Hyperf 的 whereNotIn() 不会自动过滤子查询中的 NULL，这点和 whereIn() 不同。若后端逻辑依赖子查询结果（如 SELECT id FROM blacklist WHERE active = 1），而该表存在可空字段，whereNotIn('id', $subquery) 可能返回空结果。
安全写法只有两种：
- 显式排除 NULL：
->whereNotIn('id', Db::table('blacklist')->where('active', 1)->whereNotNull('id')->pluck('id')) - 改用
whereDoesntHave()或whereNotExists()（需配合闭包和关联模型）
特别提醒：Hyperf 的 QueryBuilder 对 NOT IN 子查询无自动去 NULL 能力，这个坑在线上环境爆发过多次，务必在单元测试中覆盖含 NULL 的子查询 case。
