Laravel Eloquent关联查询报错：未知列'persons.id'，求正确写法

嘿，我来帮你排查这个问题！首先看你报的错，核心问题出在whereHas闭包里的两个错误操作，还有一些可以优化的地方，我一步步给你拆解：

错误原因分析 #

1. 不该在whereHas子查询中调用->first()
whereHas的作用是过滤主模型（Persons）中存在符合条件关联模型（PhoneNumbers）的记录，Laravel会自动处理主表和关联表的关联逻辑。但你在子查询末尾加了->first()，这会强制子查询直接返回单个PhoneNumbers实例，完全打乱了关联查询的逻辑，导致生成的SQL出现了错误的persons.id引用。

2. 获取请求参数的方式错误
   你在闭包里新建了一个Request实例来获取person_phone，这不仅没必要，还可能导致参数获取失败（新实例不会携带当前请求的表单数据）。正确的做法是通过use关键字把外部的参数变量传入闭包。

3. 冗余的空值查询
   原查询不管参数是否为空都添加了LIKE条件，比如如果用户没填middle_name，会生成LIKE %%的语句，虽然能运行，但不够优雅，也会增加SQL的不必要开销。

修正后的Eloquent查询代码 #

use Illuminate\Database\Eloquent\Builder;

// 先获取请求参数，用input()方法更稳妥
$firstName = $request->input('first_name');
$middleName = $request->input('middle_name');
$lastName = $request->input('last_name');
$personPhone = $request->input('person_phone');

// 初始化查询构建器
$personsQuery = Persons::query();

// 动态添加first_name过滤（仅当参数非空时）
if (!empty($firstName)) {
    $personsQuery->where('first_name', 'LIKE', "%{$firstName}%");
}

// 动态添加middle_name过滤（仅当参数非空时）
if (!empty($middleName)) {
    $personsQuery->where('middle_name', 'LIKE', "%{$middleName}%");
}

// 动态添加last_name过滤（仅当参数非空时）
if (!empty($lastName)) {
    $personsQuery->where('last_name', 'LIKE', "%{$lastName}%");
}

// 仅当person_phone有值时，添加关联表的过滤条件
if (!empty($personPhone)) {
    $personsQuery->whereHas('phoneNumbers', function (Builder $query) use ($personPhone) {
        $query->where('person_phone', 'LIKE', "%{$personPhone}%");
        // 这里绝对不能加->first()！
    });
}

// 执行分页查询
$persons = $personsQuery->latest()->paginate(5);

关键优化点说明 #

• 动态条件构建：通过判断参数是否为空来添加查询条件，避免生成冗余的LIKE %%语句，提升查询效率。
• 正确传递参数：用use ($personPhone)把外部变量传入闭包，确保能正确获取到请求的表单数据。
• 移除错误的->first()：让Laravel自动处理关联查询的逻辑，这样生成的SQL会正确关联persons.id和phone_numbers.persons_id，不会再出现找不到字段的错误。

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