Laravel 9.x 中批量同步带中间表属性的多对多关系（使用 sync()）

本文详解如何在 laravel 9.x 中通过 `sync()` 方法高效批量创建/更新带自定义字段（如 quantity、unit_id）的多对多中间表记录，避免 N+1 查询，并正确配置模型关系以读取 pivot 数据。

在构建类似「食谱-食材」这类需要精确控制中间关系属性（例如每道菜所需食材的 quantity 和 unit_id）的应用时，直接使用 Eloquent 默认的 attach() 或 sync() 往往无法保存自定义 pivot 字段——除非你显式告知框架哪些字段属于 pivot，并以特定结构传入数据。

✅ 正确做法：使用 sync() + 关联键控数组

Laravel 的 BelongsToMany::sync() 方法支持传入一个 以关联模型主键为键、pivot 属性数组为值 的关联数组。这是批量写入中间表自定义字段的官方推荐方式：

$ingredientsToSync = [     123 => ['quantity' => 2.5, 'unit_id' => 4],   // ingredient_id = 123     456 => ['quantity' => 1,   'unit_id' => 1],   // ingredient_id = 456     789 => ['quantity' => 0.5, 'unit_id' => 5],   // ingredient_id = 789 ];  $recipe->ingredients()->sync($ingredientsToSync);

⚠️ 注意：recipe_id 无需手动指定 —— sync() 会自动根据当前 $recipe 实例填充外键。

? 必须配置：启用 pivot 字段访问

仅传入字段还不够，你还需在 Recipe 模型的关系定义中明确声明哪些字段属于 pivot 表，否则后续读取时无法通过 $ingredient->pivot->quantity 访问：

// Recipe.php public function ingredients(): BelongsToMany {     return $this->belongsToMany(Ingredient::class)         ->using(IngredientRecipe::class)         ->withPivot(['quantity', 'unit_id']); // ✅ 关键！启用字段访问 }

这样，后续即可安全读取：

foreach ($recipe->ingredients as $ingredient) {     echo "{$ingredient->name}: {$ingredient->pivot->quantity} {$ingredient->pivot->unit->name}"; }

? 完整控制器示例（含验证与健壮处理）

// IngredientRecipeController.php public function update(Recipe $recipe, UpdateIngredientRecipe $request): RedirectResponse {     // 验证后获取清洗后的数据     $quantities = $request->validated('quantity');     $units      = $request->validated('unit');      // 构建 sync 所需的键控数组：[ingredient_id => ['quantity' => ..., 'unit_id' => ...]]     $syncData = [];     foreach ($quantities as $ingredientId => $quantity) {         $syncData[(int)$ingredientId] = [             'quantity' => (float)$quantity,             'unit_id'  => (int)($units[$ingredientId] ?? null),         ];     }      // 执行批量同步（自动处理新增、更新、删除）     $recipe->ingredients()->sync($syncData);      return redirect()         ->route('recipe.get', $recipe)         ->with('success', '食材用量已更新'); }

? 补充说明与最佳实践

• sync() 是全量同步：它会删除不在 $syncData 中的现有关联，保留并更新存在的，新增缺失的。若只需追加或更新而不删除，请改用 syncWithoutDetaching()。
• 字段名必须与数据库列名完全一致（如 unit_id，而非 unit），且需在 IngredientRecipe 的 $fillable 中允许（你已正确配置）。
• 若需在同步后立即加载 pivot 数据，使用 fresh() 并确保关系已声明 withPivot()：

  $recipe->fresh('ingredients'); // ingredients 会包含 pivot 属性

• 前端表单建议使用数组命名，例如：

   ...

通过以上配置与调用方式，你就能以单次 sql 查询完成全部中间表记录的创建与更新，兼顾性能、可读性与 Laravel 最佳实践。