本文介绍在 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 子句，仅发起一次数据库查询，语义清晰、性能优异：
Laravel 13.2.0
下载
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
$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 开发中提升性能与代码健壮性的基本实践。
