Laravel报错：Call to undefined method Illuminate\Database\Query\Builder 关联查询问题

我来帮你排查这个问题，你遇到的错误主要是几个细节没处理对，咱们一步步来修复：

1. 关联方法名匹配错误 #

你在whereHas里用了user_details，但你的User模型里定义的关联方法是**userDetails（驼峰命名）**。Laravel调用关联关系时，必须使用模型中定义的方法名，而不是数据库表名或者下划线形式的名称，这是导致"未定义方法"错误的核心原因。

2. 闭包变量作用域问题 #

你的闭包函数里引用了外部的$id变量，但没有通过use($id)将其传入闭包，这会导致闭包无法访问这个变量，进而出现逻辑错误。

3. 未预加载关联数据（可选但重要） #

如果你希望同时获取User和对应的UserDetails数据，仅用whereHas是不够的——whereHas只是用来筛选出拥有符合条件关联记录的User模型，并不会自动加载关联的UserDetails数据，需要搭配with()来预加载关联。

修复后的代码方案 #

方案一：修正whereHas的写法（适合需要筛选关联记录的场景）

public static function userDetail($id){
    $result = User::whereHas('userDetails', function ($query) use ($id) {
        // 因为已经在关联的闭包里，直接用user_id即可，不需要加表名前缀
        $query->where('user_id', $id);
    })
    ->with('userDetails') // 预加载关联的UserDetails数据
    ->first();
    
    return $result;
}

方案二：更简洁的写法（适合直接通过用户ID获取详情的场景）

其实因为你的关联是hasOne，直接通过用户ID查找并预加载关联数据即可，不需要whereHas：

public static function userDetail($id){
    // 直接找到ID为$id的用户，并预加载对应的userDetails
    $result = User::with('userDetails')->find($id);
    
    return $result;
}

额外检查：UserDetails模型的关联 #

确认你的UserDetails模型里的belongsTo关联是否正确（如果外键是默认的user_id，可以省略第二个参数）：

public function user() {
    return $this->belongsTo(User::class, 'user_id');
}

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