本文详解如何在 Laravel 中精准构建包含 whereNotIn、!= 和空值兼容的复合查询，解决因 whereNotIn 无法处理 NULL 值导致的漏查问题，并提供可复用的健壮查询模式。
本文详解如何在 laravel 中精准构建包含 `wherenotin`、`!=` 和空值兼容的复合查询，解决因 `wherenotin` 无法处理 `null` 值导致的漏查问题，并提供可复用的健壮查询模式。
在 Laravel 中执行类似「获取所有 type = 'white' 且不属于当前合作方（partner_id ≠ $partner_id）及当前雇员列表（employer_id NOT IN $employers）」的数据时，一个常见却容易被忽视的问题是：数据库中 employer_id 字段可能存在 NULL 值。而 whereNotIn('employer_id', $employers) 在底层生成 SQL 时，会将 NULL 视为未知（UNKNOWN），导致 NULL 行永远不匹配 NOT IN 条件——即这些行会被意外排除，造成结果遗漏。
你原写的查询：
ProductListing::whereNotIn('employer_id', $employers)
->where('type', 'white')
->where('partner_id', '!=', $partner_id)
->pluck('product_id')
->toArray();看似合理，但一旦 $employers 非空且表中存在 employer_id IS NULL 的记录，这些 NULL 行将不会被包含在结果中——而这往往与业务预期相悖（例如：未指定雇主的白名单产品理应被允许展示）。
✅ 正确做法是显式处理 NULL：将 employer_id 为 NULL 的记录视作“不隶属于任何指定雇主”，因此应保留。这需改用 orWhereNull() 配合逻辑分组，而非依赖 whereNotIn 单一条件。
推荐写法（使用闭包分组确保逻辑优先级）：
ProductListing::where('type', 'white')
->where('partner_id', '!=', $partner_id)
->where(function ($query) use ($employers) {
$query->whereNotIn('employer_id', $employers)
->orWhereNull('employer_id');
})
->pluck('product_id')
->toArray();⚠️ 关键说明：
- where(...)->where(...)->where(function) 确保三个顶层条件是 AND 关系；
- 闭包内 whereNotIn(...) OR orWhereNull(...) 构成一个原子化子条件，语义为：“雇员 ID 不在指定列表中 或 该字段为空”；
- 这样既覆盖了有效 employer_id 的排除逻辑，又安全接纳了 NULL 场景，符合“非当前雇员即视为符合条件”的业务本质。
? 补充建议：
- 若 $employers 可能为空数组，请提前校验，避免 whereNotIn('col', []) 报错（Laravel 9+ 已兼容，但低版本需 if (!empty($employers)) { ... }）；
- 对于高频查询，建议在 (type, partner_id, employer_id) 上建立联合索引以提升性能；
- 如需进一步排除 employer_id = 0 或其他伪空值，可在闭包中追加 orWhere('employer_id', 0) 并统一归类处理。
此模式适用于所有需兼顾 NOT IN 与 NULL 容忍性的场景，是 Laravel 数据访问层中保障数据完整性的重要实践。
