Laravel关联模型使用Where子句的问题排查与修复

需求：筛选Post表中status为1，且关联的User的name等于$request->name的记录。

方法1的问题与修复 #

你写的方法1存在两个核心问题：

1. with()的闭包是用来筛选当前Post关联的User数据，而非过滤Post本身。也就是说，只要Post的status=1，不管对应的User name是否匹配，这条Post都会被返回，只是不匹配的Post的user关联会是null。
2. 关联查询的select里没包含User的主键id，而Laravel的belongsTo关联需要用User的id和Post的user_id做匹配，缺少id的话，即使User name符合条件，Eloquent也无法建立关联，最终user还是会返回null。

修复后的代码：

$posts = Post::where('status', 1)
    // 用whereHas过滤掉关联User name不匹配的Post
    ->whereHas('user', function ($query) use ($request) {
        $query->where('name', $request->name);
    })
    // 用with控制关联User返回的字段，必须包含id
    ->with(['user' => function ($query) {
        $query->select('id', 'name', 'age');
    }])
    ->latest()
    ->get();

方法2的问题与修复 #

方法2的错误点更明显：

1. get()执行后，$p是Collection集合对象，不是单个Post模型，集合没有user属性，所以会抛出Property [user] does not exist的异常。
2. whereHas()里的select完全多余，whereHas仅用于判断关联是否满足条件，不需要指定返回字段。
3. 对$request->name的判断放在了get()之后，此时查询已经执行完毕，无法再过滤数据。

修复后的代码（支持动态条件）：

// 先初始化查询构造器
$query = Post::where('status', 1)
    ->with(['user' => function ($query) {
        $query->select('id', 'name', 'age'); // 可选：控制关联字段
    }]);

// 如果有name参数，添加关联过滤条件
if ($request->name) {
    $query->whereHas('user', function ($query) use ($request) {
        $query->where('name', $request->name);
    });
}

// 执行查询
$posts = $query->get();

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