ThinkPHP数据批量导入教程-ThinkPHP-PHP中文网

db::insertall()大批量插入需分批（200–400条/批）、配独立事务、关闭样式解析、校验mime类型、流式读取excel，避免超时、内存溢出及sql过长报错。

thinkphp数据批量导入教程

直接用 Db::insertAll() 就能跑通，但线上一跑大文件就超时、爆内存、插一半失败——问题不在函数本身，而在没控制读取方式、没切片、没关日志、没处理字段映射。

不是 ThinkPHP 缺类，是它压根不带 Excel 解析能力。必须装 phpoffice/phpspreadsheet，且不能只靠 composer require 就完事：

use PhpOffice\PhpSpreadsheet\IOFactory; 必须写全命名空间，漏掉 PhpOffice\ 前缀必报错
TP6 要求 PHP ≥ 7.2，而 phpspreadsheet 1.20+ 需要 PHP 7.4+，版本不匹配会加载失败
别传 $_FILES['file']['tmp_name'] 直接给 IOFactory::load() —— 它需要真实可读路径，且 PHP 进程得有权限读该临时文件
校验 MIME 类型别信 $_FILES['file']['type']，要用 finfo_file()；只允许 .xlsx 和 .xls，拒绝 .csv（它不是 Excel 格式，phpspreadsheet 会解析失败）

别用 $worksheet->toArray()，万行 Excel 会吃光 512MB 内存。必须流式分块读：

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

用 IOFactory::createReader('Xlsx') 显式指定格式，比 load() 更快、更可控
调用 $reader->setReadDataOnly(true) 关闭样式解析，省内存又提速
用 $worksheet->getRowIterator($startRow, $chunkSize) 控制每次只读 500 行，读完立刻 unset() 行对象
遍历单元格时加 $cellIterator->setIterateOnlyExistingCells(false)，否则空列会被跳过，导致列错位
空行判断用 array_filter($rowData)，别只看第一列是否为空

纯数据搬运、字段已对齐、不走验证和事件，就用 Db::name('table')->insertAll($data)；需要自动时间戳、验证器或 before_write 钩子，才用 saveAll()：

别信“越多越好”。MySQL 默认 max_allowed_packet=4M，按每行平均 200 字节算，500 条就逼近极限。实测稳妥区间是 200–400 条/批：

用 array_chunk($data, 400) 主动切片，别指望框架自动分批
Web 请求严禁一次性处理 >1 万条——Nginx 默认超时 30 秒，应改用队列（如 think-worker）
CLI 脚本记得加 set_time_limit(0) 和 gc_collect_cycles()，尤其循环处理多批次时
事务包裹不是可选项，是必填项：Db::transaction(function () use ($chunks) { foreach ($chunks as $chunk) { Db::name('user')->insertAll($chunk); } });

最容易被忽略的是：字段映射没做清洗（Excel 表头含换行、空格、科学计数法）、错误日志没带行号、事务里混了发邮件或调 API——这些不会立刻报错，但会在高并发或大数据量时突然崩掉。