Laravel关联表搜索获取分类名称时出现列未找到错误的问题

问题场景 #

现有users和categories两张数据表，users通过外键关联categories，categories表包含id与name字段。需求为传入search_item参数时，按关键词匹配用户信息或分类名称查询角色为Artisan的用户，但执行现有代码时出现以下错误：

SQLSTATE[42S22]: Column not found: 1054 Unknown column 'fashion' in 'where clause' (SQL: select count(*) as aggregate from users inner join categories on users.business_category = categories.id where fashion = (select * where users.full_name like %fashion% or users.email like %fashion% or users.phone like %fashion%) and `` = (select * where Role = Artisan))

错误原因分析 #

从生成的SQL语句能直接定位问题：

1. where方法用法错误：代码中where($request->get("search_item"), function ($q) {...})把search_item的参数值（比如"fashion"）当成了数据库列名传入，导致SQL尝试查找名为"fashion"的列，自然报错。
2. 关联表字段名错误：原代码中写的categories.business_category不存在，categories表只有id和name字段，不符合需求。
3. 角色筛选逻辑冗余且错误：where($request->status, function ($q) {...})完全是无效写法，$request->status为空时会生成`` = (select...)`的非法条件。

修正后的代码 #

if(!empty($request->get("search_item"))) {
    $searchItem = $request->get("search_item");
    $users = User::join("categories", "users.business_category", "=", "categories.id")
        ->where(function ($q) use ($searchItem) {
            $q->where('users.full_name', 'like', "%{$searchItem}%")
              ->orWhere('categories.name', 'like', "%{$searchItem}%")
              ->orWhere('users.email', 'like', "%{$searchItem}%")
              ->orWhere('users.phone', 'like', "%{$searchItem}%");
        })
        ->where('Role', "Artisan")
        ->paginate(20);
} else {
    $users = User::where('Role', "Artisan")
        ->orderBy('id','DESC')
        ->paginate(20);
}
return $users;

关键修正点 #

• 调整多条件查询结构：用where(function ($q) {...})包裹所有模糊匹配条件，生成正确的WHERE (条件1 OR 条件2...)SQL结构，避免把搜索值当成列名。
• 修正关联表字段：将categories.business_category改为categories.name，匹配categories表的实际字段和需求。
• 简化角色筛选：直接用where('Role', "Artisan")替代冗余且错误的闭包写法，逻辑清晰且高效。
• 优化变量调用：提前把search_item赋值给变量，减少重复的$request调用，代码更简洁。

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