
本文详解 Laravel 中如何正确实现多行数据批量插入,解决因模型实例复用导致仅插入单行的问题,并提供性能更优的 insert() 批量写入方案及关键注意事项。
本文详解 laravel 中如何正确实现多行数据批量插入,解决因模型实例复用导致仅插入单行的问题,并提供性能更优的 `insert()` 批量写入方案及关键注意事项。
在 Laravel 开发中,常见需求是通过单次表单提交向多个关联表(如主表 biniyojan 与子表 biniyojan_details)批量写入数据。但如示例代码所示,若在循环中重复使用同一个 Eloquent 模型实例(如 $biniyojan_details = new BiniyojanDetails() 仅声明一次),会导致后续 save() 始终更新同一记录,最终仅存最后一行数据——这是初学者高频踩坑点。
✅ 根本原因:模型实例被复用
原代码中:
$biniyojan_details = new BiniyojanDetails(); // ❌ 仅初始化一次
for ($i = 0; $i < count($request->school); $i++) {
$biniyojan_details['school'] = $request->school[$i]; // 覆盖属性
$biniyojan_details->save(); // 每次 save() 都操作同一对象(可能触发 UPDATE)
}Eloquent 模型在首次 save() 后会标记为“已存在”,后续调用默认执行 UPDATE;即使未设主键,也会因内部状态混乱导致数据丢失。
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。
✅ 正确解法一:循环内新建模型实例
确保每次迭代都创建独立模型:
if (!empty($request->school)) {
foreach (array_values($request->school) as $index => $schoolName) {
$detail = new BiniyojanDetails();
$detail->biniyojan_id = $biniyojan->id;
$detail->school = $schoolName;
$detail->source = $request->source[$index] ?? null;
$detail->kriyakalap = $request->kriyakalap[$index] ?? null;
$detail->cash = $request->cash[$index] ?? 0;
$detail->save(); // ✅ 每次都是全新实例
}
}✅ 推荐解法二:使用 insert() 批量写入(高性能)
对大量数据,逐条 save() 会产生 N+1 查询。改用原生批量插入,效率提升显著:
$biniyojanDetailsToBeInserted = [];
if (!empty($request->school)) {
foreach (array_values($request->school) as $index => $schoolName) {
$biniyojanDetailsToBeInserted[] = [
'biniyojan_id' => $biniyojan->id,
'school' => $schoolName,
'source' => $request->source[$index] ?? null,
'kriyakalap' => $request->kriyakalap[$index] ?? null,
'cash' => $request->cash[$index] ?? 0,
'created_at' => now(),
'updated_at' => now(),
];
}
}
// 一行完成全部插入(无模型事件、无类型转换)
if (!empty($biniyojanDetailsToBeInserted)) {
BiniyojanDetails::insert($biniyojanDetailsToBeInserted);
}⚠️ 关键注意事项
-
字段完整性:
insert()不触发 Eloquent 的creating/created事件,也不自动填充created_at/updated_at,需手动添加时间戳。 -
数据验证:批量插入前务必校验数组长度一致性(如
count($request->source) === count($request->cash)),避免索引错位。 -
前端配合:确保 Blade 表单中所有
name属性带[](如name="source[]"),且动态添加的字段严格保持数组结构。 -
事务安全:涉及多表写入时,建议包裹
DB::transaction()确保原子性:DB::transaction(function () use ($biniyojan, $biniyojanDetailsToBeInserted) { $biniyojan->save(); if (!empty($biniyojanDetailsToBeInserted)) { BiniyojanDetails::insert($biniyojanDetailsToBeInserted); } });
通过以上优化,即可稳定、高效地实现 Laravel 多行数据批量入库,兼顾代码可读性与系统性能。

















