Laravel批量插入数据应根据规模与需求选择合适方法:一、DB::table()->insert()适合结构固定的大批量写入;二、Eloquent::insert()兼顾可读性与性能;三、upsert()实现幂等插入;四、Artisan命令流式处理超大规模数据;五、原生SQL拼接追求极限性能。

如果您需要将大量数据写入数据库,但发现逐条 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) 执行预编译语句。



















