Laravel多对多关联异常：belongsToMany查询返回空数组问题

问题背景 #

我有ProductCollection和AttributeValue两个模型，通过中间表product_collection_attributes建立多对多关联，该表的product_collection_id和attribute_value_id既是外键也是联合主键。

模型关联定义如下：

ProductCollection模型 #

public function attributes()
{
  return $this->belongsToMany(AttributeValue::class, 'product_collection_attributes', 'product_collection_id');
}

AttributeValue模型 #

public function product_collections()
{
  return $this->belongsToMany(ProductCollection::class, 'product_collection_attributes', 'attribute_value_id');
}

问题现象 #

• 执行$productCollection->attributes()->get()返回空数组，但直接用DB::table('product_collection_attributes')->where('product_collection_id', $productCollection->id)->get()能查到完整数据
• 该问题仅在更新布尔字段allow_price_change后出现，原代码执行$productCollection->attributes()->delete()再attach时会触发主键重复错误
• 将关联删除替换为DB直接删除中间表数据后，$productCollection->attributes()->get()仍失效，但DB查询正常
• 更新非布尔字段时，关联查询能正常工作
• 需要使用ProductCollection::with(['attributes'])进行关联查询，而非直接操作DB

触发代码 #

$productCollection->update([
 // 其他字段
 'allow_price_change' => 0
]);
$data['attributes'] = [1,2];
$productCollection->attributes()->delete();
if (isset($data['attributes']) && count($data['attributes'])) {
 $data['attributes'] = array_unique($data['attributes']);
 $data['attributes'] = array_values(array_filter($data['attributes']));
 $productCollection->attributes()->attach($data['attributes']);
}

解决方案 #

1. 补全多对多关联的外键参数 #

Laravel的belongsToMany方法需要完整指定当前模型外键和关联模型外键，之前的定义缺失了第四个参数（关联模型的外键），导致关联查询无法正确匹配中间表字段。

修改后的关联定义：

ProductCollection模型

public function attributes()
{
  return $this->belongsToMany(
    AttributeValue::class,
    'product_collection_attributes',
    'product_collection_id', // 当前模型在中间表的外键
    'attribute_value_id'     // 关联模型在中间表的外键
  );
}

AttributeValue模型

public function product_collections()
{
  return $this->belongsToMany(
    ProductCollection::class,
    'product_collection_attributes',
    'attribute_value_id',     // 当前模型在中间表的外键
    'product_collection_id'   // 关联模型在中间表的外键
  );
}

2. 替换关联删除方式：用detach替代delete #

$model->relation()->delete()会尝试删除关联模型的实体记录，而非中间表的关联关系，这会导致错误且不符合需求。正确的多对多关联删除应该用detach：

修改触发代码中的删除逻辑：

// 替换 $productCollection->attributes()->delete();
$productCollection->attributes()->detach();

3. 刷新模型或重新加载关联 #

如果操作后模型仍存在缓存的关联数据，可通过以下方式强制刷新：

• 操作后重新从数据库获取模型：$productCollection = $productCollection->fresh();
• 强制重新加载关联：$productCollection->load('attributes');

4. 确保布尔字段的模型转换（可选） #

如果allow_price_change字段在数据库中是tinyint类型，建议在ProductCollection模型中添加属性转换，避免模型属性状态异常：

protected $casts = [
    'allow_price_change' => 'boolean',
];

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