如何在Laravel Eloquent中正确使用BelongsToMany关联（非主键场景）

首先明确：你的业务是一个产品对应多张图片，一张图片仅对应一个产品，属于一对多关系，而非多对多，因此不适合用belongsToMany（该方法用于多对多关联），更合适的是使用hasManyThrough和hasOneThrough来实现跨中间表的一对多关联。

步骤1：创建中间表模型 #

先为product_images中间表创建对应的模型ProductImage（如果尚未创建）：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class ProductImage extends Model
{
    protected $table = 'product_images';
    public $timestamps = false; // 若表未包含created_at/updated_at字段，需添加此行
}

步骤2：定义Product到AppImage的关联 #

在Product模型中添加关联方法，实现“一个产品对应多张图片”：

public function appImages()
{
    return $this->hasManyThrough(
        \App\Models\AppImage::class,
        \App\Models\ProductImage::class,
        'product_unique_identifier', // 中间表关联Product的字段
        'id', // AppImage表的主键（被中间表关联的字段）
        'product_unique_identifier', // Product表用于关联的非主键字段
        'app_image_id' // 中间表关联AppImage的字段
    );
}

步骤3：定义AppImage到Product的关联 #

在AppImage模型中添加关联方法，实现“一张图片对应一个产品”：

public function product()
{
    return $this->hasOneThrough(
        \App\Models\Product\Product::class,
        \App\Models\ProductImage::class,
        'app_image_id', // 中间表关联AppImage的字段
        'product_unique_identifier', // Product表用于关联的非主键字段
        'id', // AppImage表的主键
        'product_unique_identifier' // 中间表关联Product的字段
    );
}

若坚持使用belongsToMany（不推荐，不符合业务逻辑） #

如果一定要用belongsToMany（该方法会返回产品集合，需额外取第一个元素），需修正参数顺序：

public function product()
{
    return $this->belongsToMany(
        \App\Models\Product\Product::class,
        'product_images', // 中间表名称
        'app_image_id', // 当前模型（AppImage）在中间表的外键
        'product_unique_identifier', // 关联模型（Product）在中间表的外键
        'id', // 当前模型（AppImage）的关联字段（主键）
        'product_unique_identifier' // 关联模型（Product）的关联字段（非主键）
    );
}
// 使用时需取第一个元素：$appImage->product->first();

补充：belongsToMany参数含义澄清 #

belongsToMany的参数顺序对应关系：

1. 关联模型的完整类名
2. 中间表的名称
3. 当前模型在中间表中的外键字段名
4. 关联模型在中间表中的外键字段名
5. 当前模型用于关联的字段（默认是主键id，可指定自定义字段）
6. 关联模型用于关联的字段（默认是主键id，可指定自定义字段）

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