如何在 Laravel 中高效查询数据库中排除指定数组值的记录

本文介绍在 Laravel 中使用 Eloquent 或 Query Builder 快速筛选出 room_number 不在给定数组中的房间记录，替代低效的循环查询，显著提升性能与代码可读性。

本文介绍在 laravel 中使用 eloquent 或 query builder 快速筛选出 `room_number` 不在给定数组中的房间记录，替代低效的循环查询，显著提升性能与代码可读性。

在开发中，常需从数据库中获取“不在某组值中”的记录，例如：已预订的房间号存于数组 $c，需查询所有未被预订的空闲房间。原始代码通过 foreach 循环对每个房间号执行单独查询，不仅效率极低（N+1 查询问题），还可能因重复覆盖或空结果导致数据错误：

$available = array();
foreach ($c as $value) {
    $arooms = DB::table('tbl_rooms')->where('room_number', '<>', $value)->first();
    array_push($available, $arooms);
}
return response()->json(['data' => $available]);

✅ 正确且高效的做法是使用 Laravel 提供的 whereNotIn() 方法——它将条件一次性编译为 SQL 的 NOT IN 子句，仅发起一次数据库查询，语义清晰、性能优异：

$c = ['101', '102', '205']; // 示例：已被占用的房间号数组

$availableRooms = DB::table('tbl_rooms')
    ->whereNotIn('room_number', $c)
    ->get();

return response()->json(['data' => $availableRooms]);

? 注意事项：

• $c 必须为非空数组；若可能为空，请先校验：if (empty($c)) { … }，否则 whereNotIn 会生成无效 SQL（如 WHERE room_number NOT IN ()），多数数据库会报错；
• 若 $c 包含 null 值，whereNotIn 将忽略 NULL（SQL 中 NOT IN 遇 NULL 恒为 false），建议提前过滤：$c = array_filter($c, fn($v) => $v !== null && $v !== ”);；
• 对于大数据量表，确保 room_number 字段已建立索引，以加速 NOT IN 查询；
• 如需关联模型或复杂逻辑，可改用 Eloquent 模型调用：Room::whereNotIn(‘room_number’, $c)->get()（假设存在 Room 模型）。

? 总结：避免在循环内执行数据库查询，优先使用 whereNotIn()、whereIn() 等批量条件方法——这是 Laravel 开发中提升性能与代码健壮性的基本实践。