Laravel批量插入优化技巧

在Laravel中高效处理大批量数据插入是提升应用性能的关键环节，本文系统梳理了五种实战级方案：从轻量灵活的DB::table()->insert()和兼顾可读性的Eloquent::insert()，到支持幂等操作的upsert()，再到专为百万级数据设计的Artisan命令行流式分块处理，最后深入原生SQL拼接以榨取极致性能；无论你正面临逐条save()导致的内存溢出、响应超时，还是需要应对高并发去重写入，这些经过生产验证的策略都能帮你精准匹配数据规模与业务场景，显著缩短导入耗时、降低数据库压力——是每个Laravel开发者都该掌握的性能优化必修课。

如果您需要将大量数据写入数据库，但发现逐条 save() 耗时过长或内存溢出，则可能是由于未采用适合规模的批量插入策略。以下是处理 Laravel 批量数据插入的多种方法：

一、使用 DB::table()->insert() 直接批量写入

该方法绕过 Eloquent 模型生命周期，直接构造单条 INSERT 语句并绑定多行值，避免 N+1 查询与模型实例化开销，适用于结构固定、无需事件触发与自动填充的场景。

1、准备二维关联数组，每个子数组键名须严格对应表字段名。

2、调用 DB::table('users')->insert($data) 执行插入，其中 $data 是包含数百至数千行数据的数组。

3、若数据量超过 2000 行，需手动分块（如每 500 行为一批）以防止 SQL 包过大或事务锁表时间过长。

二、使用 Eloquent 模型的 insert() 方法

该方式仍使用模型类静态调用，但不实例化对象、不触发 creating/saving 等事件，也不执行 $casts 或访问器逻辑，仅做纯数据写入，兼顾一定可读性与性能。

1、确保模型中已定义 $fillable 属性，允许 mass assignment。

2、构建含完整字段（含 created_at 和 updated_at）的二维数组，时间戳需手动设置。

3、调用 User::insert($data) 完成写入；单次建议不超过 1000 行，超量时配合 collect($data)->chunk(500) 分批处理。

三、使用 upsert() 实现存在则更新、不存在则插入

当业务要求幂等性（如按手机号、SKU 等业务主键去重），且数据库支持 ON DUPLICATE KEY UPDATE（MySQL 8.0.19+）或 ON CONFLICT（PostgreSQL），必须先在对应字段建立唯一索引，再使用 upsert() 避免并发脏数据。

1、在目标字段（如 email 或 sku）上添加唯一索引：php artisan migrate:make add_unique_index_to_users_email 并在 up() 中执行 Schema::table(...)->unique('email')。

2、准备待插入数据数组，确保每行包含唯一键字段与需更新字段。

3、调用 DB::table('users')->upsert($data, ['email'], ['name', 'updated_at'])，其中第二个参数为唯一匹配列，第三个参数为冲突时需更新的字段列表。

四、流式分块 + 命令行处理超大规模数据

当数据量达数十万至百万级（如导入手机号列表），Web 请求易因 memory_limit 或 max_execution_time 触发 500 错误，此时应剥离 HTTP 上下文，改用 Artisan 命令行驱动，边解析、边过滤、边插入，严格控制单批次内存占用。

1、创建命令：php artisan make:command ImportPhoneNumbers。

2、在 handle() 中使用 fopen() 逐行读取文件或 stdin 输入，每读取 1000 行即调用一次 DB::table()->insert()。

3、插入前对每行执行 trim() 与正则校验，过滤空值与非法格式，避免无效数据累积至内存。

五、原生 SQL 拼接 + 参数绑定实现极限性能

在对性能极度敏感且数据源完全可信的离线场景中，可跳过 Query Builder 抽象层，手写 INSERT INTO ... VALUES (...), (...) 格式 SQL，通过 DB::insert() 绑定参数，获得最小执行开销。

1、使用 str_repeat() 与 implode() 动态生成占位符字符串，如 (?, ?, ?) × N。

2、将所有字段值扁平化为一维数值数组，确保顺序与占位符严格对应。

3、调用 DB::insert("INSERT INTO logs (ip, url, created_at) VALUES $placeholders", $values) 执行预编译语句。

今天关于《Laravel批量插入优化技巧》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！