Laravel使用with与whereHas过滤二级hasOne关联查询异常问题

你当前写法的bug本质是：hasOne关联里链式调用的latest()仅做排序调整，不会作为关联匹配的硬约束生效。
具体来说：

• 当你用with('latestStatus')预加载关联数据时，latest()的排序会生效，能正确拿到每个工单最新的状态历史
• 但当你用whereHas('latestStatus.statusName')做存在性过滤时，Laravel生成的查询逻辑是“存在任意一条属于该工单的status_history记录，关联的status_name值为new”，完全不会应用“只匹配最新的那一条status_history”的规则
  这就导致只要工单历史上出现过new状态，哪怕后续已经改成paused、close等其他状态，查询依然会把这个工单匹配出来，和你遇到的bug完全一致。

完全不需要强制手写Join，只要给关联加上“仅匹配工单下最新一条状态历史”的硬约束，纯Eloquent的关联方法就能实现正确筛选，还能保持模型逻辑的统一性，更好维护。

步骤1：修正latestStatus关联的定义 #

把原来仅靠排序取最新记录的写法，改成给关联本身绑定“只匹配最新记录”的匹配规则：

class Ticket extends Model
{
    public function latestStatus()
    {
        return $this->hasOne(StatusHistory::class, 'ticket_id', 'id')
            ->where('id', function($subQuery) {
                // 子查询绑定规则：只取对应当前工单的最大id（即最新生成的状态历史）
                $subQuery->select('id')
                    ->from('status_history')
                    ->whereColumn('status_history.ticket_id', 'ticket.id')
                    ->orderByDesc('id')
                    ->limit(1);
            });
    }
}

如果你的Laravel版本是8.0及以上，可以用框架内置的ofMany方法简化这段逻辑，不需要手写子查询：

// Laravel 8+ 简化版关联定义
public function latestStatus()
{
    return $this->hasOne(StatusHistory::class, 'ticket_id', 'id')
        ->ofMany('id', 'max');
}

这里的ofMany方法本质就是框架自动帮你生成“匹配同外键下指定字段最大值的记录”的子查询约束，和手写子查询的效果完全一致。

步骤2：调整查询逻辑 #

你原来写的with和whereHas链式调用不需要大幅修改，因为硬约束已经绑定在关联定义本身了，不管是预加载数据还是做存在性过滤，规则都会自动生效：

Ticket::with('latestStatus.statusName')
    ->whereHas('latestStatus.statusName', function($query) {
        $query->where('name', 'new');
    })
    ->get();

这段代码最终的筛选逻辑会严格匹配：工单对应的最新一条状态历史，关联的状态名称为new，不会再出现历史状态误匹配的问题。

• 不要把orderBy/latest作为关联“取最新记录”的唯一逻辑：排序只会调整返回结果的顺序，不会缩小关联匹配的范围，在whereHas做存在性判断时，排序逻辑不会被应用到匹配条件里，这是Laravel关联使用最常见的误区。
• 如果你需要同时加载状态名称的关联，记得在with的参数里把latestStatus.statusName带上，避免额外产生N+1查询问题。

内容的提问来源于stack exchange，提问作者victorelec14