Laravel Eloquent关联查询问题：预加载with获取关联数据为空的排查求助

我帮你梳理下问题所在，主要有两个核心点导致预加载的posts数组为空：

1. Post模型的关联方法存在两处错误 #

你的Post模型里的关联写法不符合Laravel的关联规范：

// 错误写法
public function users() { 
    return $this->belongsTo(Users::class); 
}

• 关联方法名应为单数：因为一篇Post只属于一个User，belongsTo关联对应的方法名要和模型名保持单数一致，应该改成user()；
• 模型引用错误：Laravel的模型类名默认是单数（比如User而非Users），所以应该引用User::class而不是Users::class。

修正后的Post模型关联代码：

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

（如果你的模型确实命名为Users，这条可以忽略，但Laravel规范里模型都是单数命名）

2. 预加载时未选择关联必需的主键 #

你查询用户时只选择了name和title字段：

$listUser = Users::with('posts') 
    ->select('name', 'title') 
    ->where('type', 1) 
    ->get();

Laravel预加载关联的逻辑是：先查询出目标用户，再用用户的主键（默认是id）去Post表匹配user_id外键。但你没有把用户的id字段包含在select里，导致预加载时无法建立关联关系，最终返回空的posts数组。

修正后的查询代码需要加上id字段：

$listUser = Users::with('posts') 
    ->select('id', 'name', 'title') // 必须包含主键id
    ->where('type', 1) 
    ->get();

额外排查建议 #

如果修改后还是有问题，可以按以下步骤排查：

• 检查Post表的外键字段：确认posts表中存在user_id字段，且字段类型与users表的id字段一致；
• 检查自定义关联键：如果你的User表主键不是id，或者Post表外键不是user_id，需要在关联方法里明确指定，比如：

  // User模型
  public function posts() {
      return $this->hasMany(Post::class, '自定义外键名', '自定义主键名');
  }
  // Post模型
  public function user() {
      return $this->belongsTo(User::class, '自定义外键名', '自定义主键名');
  }
  

• 查看SQL日志：开启Laravel查询日志，直观查看预加载执行的SQL语句，排查数据匹配问题。临时添加代码：

  DB::enableQueryLog();
  $listUser = Users::with('posts')->select('id', 'name', 'title')->where('type', 1)->get();
  dd(DB::getQueryLog());
  

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