在 laravel 中使用原生 sql 的命名占位符（如 `:id`）无法直接绑定数组值，必须改用查询构建器的 `wherein()` 方法或动态生成占位符，否则会导致查询结果异常。
在 Laravel 开发中，当需要根据多个 ID 执行 IN 条件查询时，一个常见误区是试图将数组通过 implode() 转为逗号分隔字符串，并直接绑定到命名占位符（如 :id）中，例如：
$id = [6, 7, 8, 9];
$params = [
'connection' => 'redis',
'id' => implode(',', $id) // ❌ 错误：SQL 将解析为 WHERE id IN ('6,7,8,9') —— 单个字符串，非四个数值
];
$result = DB::select(DB::raw("SELECT * FROM failed_jobs WHERE id IN (:id) AND connection = :connection"), $params);该写法实际生成的 SQL 等效于 WHERE id IN ('6,7,8,9')，数据库会将 '6,7,8,9' 视为单个字符串字面量，而非四个独立整数，因此仅可能匹配 id = 6789（若存在）或完全无匹配，导致结果数量远少于预期。
✅ 推荐方案：优先使用 Query Builder 的 whereIn()
Laravel 查询构建器原生支持数组绑定，语义清晰、安全高效，且自动处理类型转换与 SQL 注入防护：
$id = [6, 7, 8, 9];
$result = DB::table('failed_jobs')
->where('connection', 'redis')
->whereIn('id', $id) // ✅ 正确：自动生成 ? 占位符并绑定每个元素
->get();该方式底层生成形如 WHERE connection = ? AND id IN (?, ?, ?, ?) 的预处理语句，并逐个绑定参数，完全规避字符串拼接风险。
⚠️ 若必须使用原生 SQL（如复杂子查询、窗口函数等），可手动构造动态占位符：
$id = [6, 7, 8, 9];
$placeholders = str_repeat('?,', count($id) - 1) . '?';
$params = array_merge(['redis'], $id); // connection 在前，id 值在后
$result = DB::select(
"SELECT * FROM failed_jobs WHERE connection = ? AND id IN ($placeholders)",
$params
);注意事项：永远避免对用户输入执行 implode() + 字符串拼接注入 SQL；whereIn() 自动过滤空数组（返回空集合），但需确保 $id 为非空数组以避免全表扫描；对于超大数组（如 > 1000 项），注意数据库 max_allowed_packet 及性能，可考虑分批查询。
总结：Laravel 的 whereIn() 不仅语法简洁、安全性高，还兼容所有数据库驱动，是处理 IN 数组条件的首选方案；原生 SQL 绑定数组需手动管理占位符，仅在必要时采用。
