最稳妥写法是直接用wherenotin(),需预判空数组、统一数据类型、显式处理null、避免大列表性能问题,并优先用wheredoesnthave()处理关联排除。

Where Not In 在 Eloquent 中怎么写才不报错
直接用 whereNotIn() 是最稳妥的方式,别手滑写成 whereNotInArray() 或试图链式调用 ->notIn() —— 这些都不存在,会抛出 BadMethodCallException。
常见错误是把空数组传给 whereNotIn():MySQL 不支持 WHERE id NOT IN (),Laravel 7+ 会自动跳过该条件,但低版本(如 5.8)会直接报 SQL 错误。所以必须提前判断:
- 检查数组是否为空,为空时改用
whereRaw('1=1')或直接跳过该查询分支 - 确保数组元素类型一致(比如全是整型 ID),混入
null或字符串会导致意外结果 - 若来源是用户输入(如 URL 参数),先用
array_filter($ids, 'is_numeric')清洗,避免注入风险
排除关联模型中已存在的记录(反向成员资格)
比如「查所有没被用户收藏的文章」,不能只靠 whereNotIn('id', $collectedIds),因为 $collectedIds 可能为空、可能漏查新增数据。更可靠的是用子查询或关联排除:
- 用
whereDoesntHave()最语义清晰:Article::whereDoesntHave('favorites', function ($q) use ($userId) { $q->where('user_id', $userId); })->get() - 若需高性能且收藏表极大,改用
whereNotIn()配合子查询:whereNotIn('id', Favorite::select('article_id')->where('user_id', $userId))—— 注意这里传的是Builder实例,不是数组 - 避免在大表上用
whereDoesntHave()做多层嵌套,它默认生成NOT EXISTS,索引利用不如LEFT JOIN ... IS NULL
NULL 值会让 whereNotIn 失效,必须单独处理
这是最容易被忽略的坑:如果字段允许为 NULL(比如 category_id),而你要排除的列表里不含 NULL,那么数据库里所有 category_id IS NULL 的记录仍会被查出来 —— 因为 NULL NOT IN (1,2,3) 永远返回 NULL(即 false)。
正确做法是显式排除 NULL:
->whereNotNull('category_id')->whereNotIn('category_id', [1,2,3])- 或者合并条件:
->whereRaw('category_id IS NOT NULL AND category_id NOT IN (?)', [json_encode([1,2,3])])(注意参数绑定方式) - 不要依赖 ORM 自动处理 NULL,Eloquent 不会帮你补
IS NOT NULL
大数据量下 whereNotIn 性能断崖式下降怎么办
当排除列表超过几百项(比如 5000 个 ID),MySQL 会拒绝执行或极慢,因为 IN 列表本质是展开为 OR 条件,优化器放弃索引。
替代方案取决于场景:
- 用临时表 +
LEFT JOIN ... IS NULL:先把要排除的 ID 插入临时表,再 JOIN 查询,适合命令行脚本或队列任务 - 改用范围分批:把大数组切片,循环查,用
union()合并结果(注意内存和连接数) - 业务层缓存「排除集」为 Redis Set,用
SISMEMBER在应用层过滤 —— 适合读多写少、排除集变化不频繁的情况
没有银弹。whereNotIn() 看似简单,但一旦涉及空值、大列表、关联语义或性能临界点,就得跳出语法层面,回到数据结构和查询计划本身去想。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











