Laravel关联User、User_meta与Districts表报错及实现咨询

问题背景 #

我拥有user表及对应的users_meta表，希望通过users_meta的key和value字段关联查询第三方districts表的数据，但代码执行后出现报错。

原代码实现 #

if ($request->ajax()) {
    $users = User::select('users.*')->with(['user_data'])->groupBy('users.id');
    $users = $users
        ->leftJoin('users_meta', 'users.id', '=', 'users_meta.users_id')
        ->leftJoin('districts', 'users_meta.users_id', '=', 'districts.user_id' and 'users_meta.key', '=', 'district_id' and 'users_meta.value', '=', 'districts.id')
        ->groupBy('users.id');
    $users->with(['districts', 'users_meta']);
}

报错信息（已翻译） #

DataTables警告：表格id=ajax_data_table - 异常信息：
SQLSTATE[42S22]: 找不到列：1054 on子句中存在未知列'users_meta.users_id' (SQL: select count() as aggregate from (select users. from users left join users_meta on users.id = users_meta.users_id left join districts on users_meta.users_id = 1 where users.deleted_at is null group by users.id, users.id) count_row_table)

错误分析 #

• Join语法错误：Laravel Query Builder中多条件join不能直接用and拼接，这种写法会被解析为无效SQL，导致出现users_meta.users_id = 1这类无意义条件。
• 字段名不匹配：报错提示找不到users_meta.users_id列，大概率是users_meta表中关联users表的外键字段实际是user_id（单数形式）而非users_id，需核对数据库表结构确认。
• 预加载未生效：最后一行$users->with(...)未重新赋值给变量，导致关联预加载逻辑未生效。
• 冗余代码：重复调用groupBy('users.id')属于多余操作。

修正后的代码 #

if ($request->ajax()) {
    // 请根据实际数据库字段调整外键名，此处假设users_meta的外键为user_id
    $users = User::select('users.*')
        ->with(['user_data', 'districts', 'users_meta'])
        ->leftJoin('users_meta', 'users.id', '=', 'users_meta.user_id')
        ->leftJoin('districts', function ($join) {
            $join->on('users_meta.user_id', '=', 'districts.user_id')
                 ->where('users_meta.key', '=', 'district_id')
                 ->where('users_meta.value', '=', 'districts.id');
        })
        ->groupBy('users.id');
}

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