Laravel中能否在HasMany关联上调用upsert()批量增改？

DevOps 小满

2026-9-1

问题背景

目标是通过Eloquent的HasMany关联实现关联模型的批量创建/更新，现有代码如下：
App/Models/Relation 模型关联定义：

public function data() : \Illuminate\Database\Eloquent\Relations\HasMany
{
    return $this->hasMany(Data::class);
}

控制器中调用代码：

$relation->data()->upsert($data,'id',['data']);

执行时报错提示未定义relation_id字段。预期行为是通过关联对象调用upsert()时自动填充外键relation_id，因createOrUpdate仅支持单条数据处理，无法满足批量操作需求，需要明确错误原因和正确实现方式。

错误原因

upsert()是查询构建器层提供的批量操作方法，不会自动注入关联外键值。
create()、save()等关联操作方法走Eloquent模型实例生命周期，会自动读取关联配置的外键、父模型主键值，给待写入的模型实例补全对应属性；但upsert()是直接生成批量SQL执行，不会遍历待写入数据集补全关联字段，传入的$data中缺失relation_id时就会触发字段未定义错误。

实现方案

先为所有待批量处理的数据补全外键字段
遍历待写入的数据集，给每条数据加上关联外键值：

// 外键字段以你实际关联配置的为准，此处对应报错提示的relation_id
$fillData = collect($data)->map(function ($row) use ($relation) {
    $row['relation_id'] = $relation->getKey();
    return $row;
})->toArray();

执行批量upsert操作
补全字段后调用upsert即可正常执行：

$relation->data()->upsert($fillData, 'id', ['data']);

注意事项

若使用复合唯一键作为更新判断依据，upsert第二个参数需要传入数组格式，建议将外键也加入唯一键判断，避免不同父模型下关联数据主键冲突导致误更新：
```
$relation->data()->upsert($fillData, ['id', 'relation_id'], ['data']);
```
批量upsert属于直接SQL操作，不会触发模型的creating、saving、created、saved等模型事件，有事件依赖的场景需要额外手动处理逻辑
Laravel 8及以上版本才内置支持upsert方法，低版本需要先升级框架或引入第三方扩展包实现批量upsert能力