Laravel 9中如何同时预加载单表的两个关联关系？

问题描述 #

在Laravel 9中尝试对photos表同时预加载关联的users和photo_categories数据时遇到问题，已定义模型关联但预加载未按预期生效。

原尝试代码 #

Show方法：

$photos = Photo::with('user','photoCategory')->where('id',$request->id)->first();

Index方法：

$photos = new PhotoCollection(Photo::with('user','photoCategories')->OrderByDesc('id')->paginate(10));

原模型关联定义 #

Photo模型：

public function user(){
 return $this->BelongsTo(User::class);
}
public function photoCategory(){
 return $this->HasMany(FotoCategory::class);
}

User模型：

public function photo(){
 return $this->HasMany(PhotoCategory::class);
}

PhotoCategory模型：

public function photo(){
 return $this->BelongsTo(Photo::class);
}

问题点排查 #

1. 关联命名与预加载名称不匹配
   Photo模型定义的关联方法是photoCategory（单数），但Index方法预加载时用了photoCategories（复数），名称不一致导致预加载失败。Laravel中HasMany关联建议用复数命名，保持统一。

2. 模型类名拼写错误
   Photo模型的photoCategory关联中，引用的是FotoCategory::class，但实际模型类名是PhotoCategory，拼写错误导致关联无法正确建立。

3. User模型关联指向错误
   User模型的photo关联应该关联Photo模型，而非PhotoCategory模型——用户与照片是一对多关系，用户拥有多张照片，而非照片分类。

4. Eloquent方法名大小写错误
   Index方法中的OrderByDesc应为orderByDesc，Laravel Eloquent方法采用小驼峰命名，首字母大写会导致方法调用失败。

5. 关联方法名大小写不规范
   Laravel Eloquent关联方法（belongsTo/hasMany）应为小写开头，原代码中BelongsTo/HasMany的大写开头写法不符合框架规范。

修正后的代码 #

修正后的Photo模型 #

public function user(){
 return $this->belongsTo(User::class);
}
// 改为复数命名，符合HasMany关联的命名习惯
public function photoCategories(){
 return $this->hasMany(PhotoCategory::class);
}

修正后的User模型 #

// 改为复数命名，符合一对多关系的命名规范
public function photos(){
 return $this->hasMany(Photo::class);
}

修正后的控制器代码 #

Show方法：

$photo = Photo::with('user','photoCategories')->where('id',$request->id)->first();

Index方法：

$photos = new PhotoCollection(Photo::with('user','photoCategories')->orderByDesc('id')->paginate(10));

额外注意：外键字段规范 #

确保数据库表的外键符合Laravel默认约定：

• photos表需有user_id字段，关联users表的id
• photo_categories表需有photo_id字段，关联photos表的id
  如果外键字段名不符合默认约定，需要在关联方法中指定外键参数，例如：

// Photo模型的photoCategories关联，若外键为自定义字段
public function photoCategories(){
 return $this->hasMany(PhotoCategory::class, 'custom_photo_id');
}

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