关联数据存在性判断必须用whereHas()和whereDoesntHave()，不可用whereNotNull()或!= null比较；leftJoin后非空判断需用whereNotNull()或whereRaw()；所有关联字段WHERE条件须建索引。
关联查询的「非空」判断，不能靠 whereNotNull() 直接查关联字段——它只对主表字段有效，对关联表字段无效。 真正要查「关联数据存在」，必须用 whereHas()；要查「关联数据不存在」，得用 whereDoesntHave()。误写成 where('relation.column', '!=', null) 会生成错误 SQL，结果不可信。
whereHas() 是查「有关联数据」的唯一可靠方式
它生成的是 EXISTS 子查询（或优化后的 JOIN），语义准确、能走索引、兼容所有主流数据库。
- 错误写法：
where('posts.user_id', '!=', null)——NULL不支持!=比较，MySQL 里这条件恒为UNKNOWN，实际被忽略 - 正确写法：
whereHas('user')，表示「该 post 关联的 user 记录在 users 表中真实存在」 - 带条件写法：
whereHas('user', fn($q) => $q->where('status', 'active'))，但注意：复杂条件可能让EXISTS失去索引优势，优先拆解或改用withWhereHas()（Laravel 10.42+） - 外键为空（如
user_id = NULL）时，whereHas()自动跳过，无需额外whereNotNull('user_id')
leftJoin + whereNotNull() 适合「关联字段本身非空」场景
当你真正想查的是「left join 后某关联字段值不为 NULL」，比如 tf.is_payed IS NOT NULL，就得在 leftJoin() 的 on() 或后续 where() 中明确写。
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- 错误写法：
on('tf.is_payed', '!=', null)—— 查询构建器不认识这种写法，报Unknown column - 正确写法：
on('tf.tf_kode', '=', 'x.tf_kode')->whereNotNull('tf.is_payed')，把非空判断放在where链上 - 或更安全的写法：
on('tf.tf_kode', '=', 'x.tf_kode')->whereRaw('tf.is_payed IS NOT NULL')，避免构建器对NULL的隐式转换歧义 - 注意：这种写法会让
LEFT JOIN实际变成INNER JOIN效果，因为加了对右表字段的非空限制
whereDoesntHave() 和 whereNull() 完全不是一回事
whereNull('user_id') 只检查主表外键字段是否为 NULL；whereDoesntHave('user') 是查「外键虽有值，但对应 user 记录已被删或不满足条件」。
- 举例：post 表
user_id = 123，但 users 表里已无 id=123 的记录 →whereDoesntHave('user')能捕获，whereNull('user_id')捕获不到 - 常见误用：
whereNull('user.name')—— 这语法非法，Eloquent 不允许在whereNull()里写点号路径，只能用于主表字段 - 如果真要结合空值和关联逻辑，优先用
whereDoesntHave()+ 关联模型里的约束（如迁移中加外键ON DELETE CASCADE）
最易被忽略的一点：无论用 whereHas() 还是 leftJoin，只要关联字段参与 WHERE 条件，就一定要确认该字段在数据库里建了索引——否则几万行数据一查就卡住，而且问题往往在压测时才暴露。
