Laravel一对多关联查询：获取商品列表及单张对应图片

嘿，我来帮你搞定这个问题！你遇到的是一对多关联场景里，需要为每个主表条目只取一条关联表数据的经典需求——之前用join加groupBy的思路之所以踩坑，是因为MySQL严格模式下这种写法会报错（select里的字段要么在groupBy中，要么是聚合函数），就算绕过严格模式，也会随机返回一张图片，没法保证是你预期的那一张；而distinct是对整行结果去重，也解决不了按商品分组取单图的问题。

下面给你几个靠谱且符合Laravel最佳实践的解决方案：

方案一：利用关联模型加载单张图片（最推荐） #

首先确保你的Product模型已经定义了和ProductPicture的一对多关联：

// app/Models/Product.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Product extends Model
{
    public function pictures()
    {
        return $this->hasMany(ProductPicture::class, 'product_id');
    }
}

然后查询时，通过with方法的闭包限制每个商品只加载一张图片（可以指定排序规则，比如取最新创建的）：

$products = Product::with(['pictures' => function ($query) {
    // 只选择需要的图片字段，提升性能
    $query->select('product_id', 'product_picture_id')
          ->latest('created_at') // 按创建时间取最新的图片，也可以用oldest()取最早的
          ->take(1);
}])
// 选择商品需要展示的字段
->select('product_id', 'product_name', 'quantity')
->get();

这样返回的每个Product实例里，pictures属性就只会包含一张图片，代码清晰且符合Eloquent的设计思路。

方案二：子查询关联（适合需要将图片字段直接查进主结果的场景） #

如果需要把图片字段和商品字段放在同一级结果里，可以用子查询先拿到每个商品对应的目标图片ID，再关联回图片表：

use Illuminate\Support\Facades\DB;
use App\Models\Product;
use App\Models\ProductPicture;

$products = Product::select(
    'products.product_id',
    'products.product_name',
    'products.quantity',
    'product_pictures.product_picture_id'
)
// 子查询：按商品分组，取每个商品的最新图片ID（这里用MAX也可以，或者按创建时间排序）
->leftJoinSub(
    ProductPicture::select('product_id', DB::raw('MAX(product_picture_id) as picture_id'))
        ->groupBy('product_id'),
    'first_pictures',
    fn($join) => $join->on('products.product_id', '=', 'first_pictures.product_id')
)
// 关联回图片表拿到完整图片数据
->leftJoin('product_pictures', 'first_pictures.picture_id', '=', 'product_pictures.product_picture_id')
->get();

方案三：用withAggregate快速获取图片字段（Laravel 8.37+） #

如果只需要图片的单个字段（比如图片ID、存储路径），Laravel的withAggregate方法会非常简洁：

// 取每个商品的第一张图片ID（默认按主键排序）
$products = Product::withAggregate('pictures', 'product_picture_id')
    ->select('product_id', 'product_name', 'quantity')
    ->get();

// 如果要取最新创建的图片ID，可以自定义查询
$products = Product::withAggregate(['pictures' => function ($query) {
    $query->latest('created_at');
}], 'product_picture_id')
->select('product_id', 'product_name', 'quantity')
->get();

查询结果里会新增一个pictures_product_picture_id字段，就是对应商品的目标图片ID。

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