whereNotNull() 是 Laravel Eloquent 中专用于字段不为 NULL 的查询方法，生成 SQL 的 IS NOT NULL 条件，语义清晰、兼容多数据库且支持索引；误用 != NULL 等写法会导致逻辑错误，需区分 NULL 与空字符串，联合索引下可能无法命中索引。
whereNotNull() 是最直接的非空查询方法
在 Laravel 的 Eloquent 中，whereNotNull() 就是专为「字段不为 NULL」设计的查询方法，它生成 SQL 的 IS NOT NULL 条件，语义清晰、无歧义，且能被数据库索引有效利用。
常见误用是写成 where('column', '!=', null) 或 where('column', '', null) —— 这两种写法在 SQL 中实际会被忽略（因为 NULL 不能用等值比较），最终查出全部数据或空结果，非常隐蔽。
正确用法示例：
$users = User::whereNotNull('email')->get();
// 生成 SQL：WHERE `email` IS NOT NULL- 只接受一个字段名字符串，不支持数组批量调用
- 对 MySQL/PostgreSQL/SQLite 均兼容，底层由 Query Builder 统一处理
- 如果字段类型是 JSON（如 MySQL 的 JSON 列），
whereNotNull()判断的是整个字段是否为 NULL，不是判断 JSON 内部某个键是否存在
whereColumn() 配合 IS NOT NULL 不适用
有人看到 whereColumn() 能做字段间比较，就尝试 whereColumn('email', '!=', DB::raw('NULL'))，这会报错或生成非法 SQL。SQL 标准规定 NULL 必须用 IS NULL / IS NOT NULL 判断，不能参与常规比较运算符。
立即学习“PHP免费学习笔记（深入）”；
即使强行绕过（比如用 DB::raw('email IS NOT NULL')），也失去 Eloquent 的链式可读性和类型安全，还可能被后续的 orWhere() 破坏逻辑分组。
- 不要用
!= NULL、<> NULL、NOT (email = NULL)这类写法 -
whereRaw('email IS NOT NULL')虽然可行，但属于退化用法，仅在动态拼接复杂条件时酌情考虑 - 若需同时排除 NULL 和空字符串，得额外叠加
where('email', '!=', '')，注意两者逻辑是 AND 关系
空字符串 '' 和 NULL 要分开处理
PHP 层面常把 '' 和 null 混为“空”，但在数据库里它们是完全不同的值：NULL 表示缺失/未知，'' 是明确的空字符串。Eloquent 的 whereNotNull() 对空字符串完全无感。
典型场景：用户注册时邮箱字段允许为空（存 NULL），但一旦填了就必须是有效格式；或者导出数据时发现大量 '' 值混在 NULL 里，导致业务逻辑出错。
- 要同时过滤 NULL 和空字符串：
whereNotNull('email')->where('email', '!=', '') - MySQL 中还可合并写成
whereRaw("email IS NOT NULL AND email != ''")，减少查询条件数 - PostgreSQL 注意：空字符串和 NULL 默认不等价，但某些 ORM 配置可能开启
empty_string_is_null，需确认 driver 配置
联合索引下 whereNotNull() 可能无法走索引
单独对某字段建索引时，whereNotNull('status') 通常能命中索引；但如果该字段是联合索引的非首列（比如索引是 (user_id, status)），那么 whereNotNull('status') 很可能触发全表扫描 —— 因为 B-Tree 索引无法跳过前导列直接定位后缀列的非空值。
这不是 Eloquent 的问题，而是数据库索引原理决定的。执行 EXPLAIN 可验证：
EXPLAIN SELECT * FROM users WHERE status IS NOT NULL;
- 若
key字段为NULL，说明没走索引 - 优化方向：确保被查字段是联合索引的最左前缀，或为高频非空查询字段单独建索引
- 对大数据量表，
whereNotNull()+limit仍可能慢，因数据库需扫描直到凑够 limit 行数才停
真正要注意的是 NULL 和空字符串的语义边界——数据库不会自动帮你统一，Eloquent 也不会替你做隐式转换。查之前想清楚：你要排除的是“未填写”，还是“填了但填了个空”？这两个问题的答案，决定了要不要加第二层 where 条件。
