讲师中心 微信公众号
AI工具推荐 视频效率加速

Laravel循环写入数据库的批量优化

夜芳姑娘_6663

夜芳姑娘_6663

发布时间:2026-06-18 18:46:03

|

887人浏览过

|

来源于php中文网

原创

DB::table()->insert() 比循环 create() 快,因后者每次实例化模型并触发事件、转换、时间戳等开销,前者直接执行单条多值 INSERT;需注意字段名严格匹配、值提前格式化、分块事务控制及 upsert() 主键不可更新等细节。

laravel循环写入数据库的批量优化

DB::table()->insert() 为什么比循环 create() 快得多

因为 create() 每次都实例化一个 Eloquent 模型,触发 creating、created 事件,执行属性转换($casts)、时间戳自动填充、验证逻辑(哪怕没开验证),100 条就是 100 次对象创建 + 100 次 SQL 解析。而 DB::table('users')->insert($data) 直接拼一条多值 INSERT 语句发给数据库,无模型开销。

常见错误现象:SQLSTATE[HY000]: General error: 1366 Incorrect integer value —— 某个字段传了 null 或字符串,但数据库要求非空整数;或时间字段传了 Carbon 实例没转成字符串。

  • 数据必须是二维关联数组,键名严格等于数据库字段名(created_at 不能写成 created_at_time)
  • 所有值需提前格式化:now()->toDateTimeString()、json_encode($arr)、布尔转 0/1
  • 不能漏掉 NOT NULL 字段,除非数据库允许默认值
  • 单次传入行数建议 ≤ 1000,否则可能触发 Packets larger than max_allowed_packet are not allowed

分块插入时 DB::transaction() 该包在哪一层

包在每个 chunk 内部,而不是整个数据集外层。包太宽会锁表太久、InnoDB redo log 写满、其他请求排队卡死,尤其 upsert() 还会加间隙锁(gap lock)。

使用场景:纯单表插入(如日志流水)通常不需要外层事务,Laravel 默认 auto-commit 更稳;只有 A 表插入 + B 表插入必须同时成功时,才需要事务保障原子性。

Laravel Creem Agent
Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品,执行心跳检查,管理本地 Laravel支付商店。

下载
  • 用 collect($data)->chunk(500) 切分,再对每个 $chunk 单独调用 DB::transaction(fn() => DB::table(...)->insert($chunk))
  • 事务闭包内禁止调用任何 Eloquent 模型方法(如 User::find())、不触发事件、不加载关系
  • 别在同一个事务里混用 insert() 和 update(),锁类型不同,死锁风险陡增
  • 如果某批失败,只回滚当前 chunk,不影响后续批次

upsert() 报错 Column 'id' cannot be null 怎么修

这是 Laravel upsert() 的典型陷阱:第三个参数(更新字段列表)里误写了主键 id。MySQL 原生语法不允许在 ON DUPLICATE KEY UPDATE 中更新主键,会直接报错。

正确做法是把主键从更新字段中剔除,只留业务字段。且必须确认数据库表已在第二个参数指定的字段(如 email)上建了唯一索引,否则行为未定义——不是报错,而是退化为普通 INSERT,重复数据直接冲突失败。

  • 检查 upsert() 第二个参数:['email'] 对应的字段是否已建 UNIQUE 或 PRIMARY KEY
  • 第三个参数只能是可更新字段,如 ['name', 'updated_at'],绝对不要包含 'id'
  • Laravel 8 及以下没有 upsert(),调用会抛 BadMethodCallException,需升级或改用原生语句
  • SQLite 不支持 upsert(),本地开发测试时容易忽略这点

时间戳和模型事件怎么手动补

DB::table()->insert() 不走模型,所以 created_at/updated_at 不会自动填,模型事件也不会触发。如果你依赖这些逻辑(比如缓存失效、日志记录),就得自己补,但要注意别引入额外性能损耗。

性能影响明显:在每行数组里手动加 'created_at' => now()->toDateTimeString() 几乎无开销;但若循环里调 Cache::forget() 或发 HTTP 请求,就又回到“伪批量”状态。

  • 时间戳字段必须手动赋值,推荐统一用 now()->toDateTimeString(),避免时区不一致
  • 如需触发日志或缓存更新,优先批量处理(如插入完再 Cache::tags(['user'])->flush()),而非逐行调用
  • 临时禁用模型事件用 User::unsetEventDispatcher(),但仅适用于后续完全不依赖事件的场景;并发请求下不能复用同一模型类的事件调度器
  • 别在插入前用 DB::statement('SET FOREIGN_KEY_CHECKS = 0'),除非你确定没外键依赖且处于维护窗口期
实际跑起来才发现,最常被忽略的是字段名大小写和 JSON 字段的预编码——数据库字段叫 meta_info,代码里写成 metaInfo 就静默失败;json_encode() 没加 JSON_UNESCAPED_UNICODE,中文变 \uXXXX,查起来全是乱码。

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

837

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

815

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2468

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3761

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

5310

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

3556

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

6709

2025.08.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

1396

2026.03.04

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

100

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 201人学习

Composer手册
Composer手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn