Laravel 查询构造器没有 whereNotMatch 方法，它既不是 Eloquent 也不是 Query Builder 的原生方法；实际应使用 whereNot()、whereNotIn()、whereNotLike()（9.2+）、whereDoesntContain() 或 whereDoesntHave() 等语义明确的替代方案。
whereNotMatch 不存在，别被名字带偏
Laravel 查询构造器没有 whereNotMatch 这个方法，它既不是 Eloquent 的内置方法，也不在 Query Builder 的官方 API 中。如果你在文档、报错信息或某段代码里看到这个写法，基本可以判定是拼写错误、自定义扩展、或混淆了其他框架（比如 ThinkPHP 的 whereNotLike）的命名习惯。
想实现“不匹配”逻辑，实际可用的替代方案
所谓“不匹配”，常见场景其实是“字段值不等于某个值”“不包含某字符串”“不属于某组 ID”——对应到 Laravel，应选用语义明确、原生支持的方法：
-
whereNot()：适用于简单否定，如$query->whereNot('status', 'draft') -
whereNotIn()：排除多个值，如$query->whereNotIn('user_id', [1, 5, 8]) -
whereNotLike()：Laravel 9.2+ 原生支持，安全且无需whereRaw，如$query->whereNotLike('name', "%{$keyword}%") -
whereDoesntContain()：仅适用于 JSON 字段（MySQL 5.7+/PostgreSQL），如$query->whereDoesntContain('meta', 'tags')
注意：whereNotLike 在低版本 Laravel（BadMethodCallException；若需兼容旧版，只能退回到 whereRaw + 手动转义，但风险陡增。
自己加 whereNotMatch？小心破坏链式调用
有人尝试在模型或查询构建器上通过 macro 注册 whereNotMatch，例如：
Builder::macro('whereNotMatch', function ($column, $value) {
return $this->where($column, '!=', $value);
});
这看似可行，但存在明显隐患：
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- 语义模糊：“NotMatch”容易让人联想到正则或全文匹配，而实际只是
!=，误导后续维护者 - 不处理 NULL：数据库中
column != 'val'对 NULL 行永远返回 false，需额外补orWhereNull($column) - JSON 或数组字段不适用：直接用
!=无法正确判断 JSON 是否不包含某键值对 - macro 不参与 IDE 自动补全，也绕过了 Laravel 的参数绑定校验逻辑
模糊“不匹配”的真实需求，往往该用 whereDoesntHave
很多开发者说“要 not match”，其实真正想要的是“关联记录不存在”，比如“查所有没发过订单的用户”。这时不该在主表字段上硬写否定条件，而该用关系级否定：
$users = User::whereDoesntHave('orders', function ($q) { $q->where('status', 'paid'); })->get();
这种写法生成的是 NOT EXISTS 子查询，语义清晰、性能可控、且天然规避字段 NULL 判断陷阱。比在 users 表里写一堆 whereNot() 更接近业务本意。
真正难处理的，是混合了 NULL 安全性、JSON 结构判断、以及多字段联合否定的场景——这些没法靠一个“伪方法”掩盖，得拆开分析条件，逐层用原生支持的构造器组合出来。
