Laravel Eloquent中whereHas与whereDoesntHave不生效问题排查

问题回顾 #

你想要获取user_id=1的用户两类支付记录：要么未订阅但已完成支付，要么已订阅且订阅未过期，但当前的Eloquent查询却返回了数据库中第一条支付记录（user_id为317），完全不是目标用户的数据。

问题根源 #

这是典型的逻辑运算符优先级导致的Bug！你的原查询中，orWhereDoesntHave直接和前面的whereHas做了OR关联，而后面的where('user_id',1)只作用在orWhereDoesntHave这一个条件上。换句话说，你的查询实际执行的逻辑是：

(存在未过期订阅的支付记录) OR (不存在订阅且user_id=1的支付记录)

这就意味着，只要数据库里有任何一条“存在未过期订阅”的支付记录（不管属于哪个用户），都会被查询出来——这就是为什么你拿到了user_id=317的那条数据。

修复方案 #

你需要把两个OR条件（存在未过期订阅、不存在订阅）包裹在同一个逻辑分组里，同时让user_id=1的条件作用于整个查询。用Laravel的闭包分组就能轻松解决：

Payment::where('user_id', 1)
    ->where(function($query) {
        $query->whereHas('subscription', function($q) {
                $q->where('ends_at', '>', today());
            })
            ->orWhereDoesntHave('subscription');
    })
    ->first();

逻辑解释 #

• 外层的where('user_id',1)确保所有返回的支付记录都属于目标用户；
• 内层闭包把whereHas和orWhereDoesntHave打包成一个逻辑单元，这样两个条件的OR关系就只会在user_id=1的范围内生效。

最终查询的逻辑就变成了：

user_id=1 AND (存在未过期订阅 OR 不存在订阅)

完全匹配你的业务需求啦！

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