ThinkPHP批量添加数据需规避字段错位、内存溢出、自增ID获取失败及MySQL报错等问题：TP3.2的addAll()须ksort统一键序；TP5+的insertAll()不返回全部ID，需配合getLastInsID()推算或事务循环获取；大批量须分片（如每批1000条）；慎用getField()数量参数，其控制元素个数而非记录数。
ThinkPHP 批量添加数据不能只靠 addAll() 或 insertAll() 丢个数组就完事——字段错位、内存溢出、自增 ID 拿不到、MySQL 报 Packet too large，全在你一念之间。
ThinkPHP 3.2 的 addAll() 必须保证数组键名顺序一致
TP3.2 的 addAll() 底层用的是 array_values() + implode() 拼 SQL，一旦二维数组里各条记录的键顺序不统一（比如第一条是 ['name', 'email']，第二条变成 ['email', 'name']），字段和值就会错位，静默写入脏数据。
- 插入前强制对每条记录调用
ksort()，确保键名升序排列 - 别依赖前端传来的
$_POST原始顺序，先array_map('ksort', $dataList) - 如果字段含中文键或动态键（如
"user_{$id}"），addAll()极易崩，换原生 SQL
ThinkPHP 5+ 的 insertAll() 不返回自增 ID 列表
insertAll() 只返回插入行数（int），不是主键数组。想拿到每条记录的 id，不能靠它直接返回，得手动推算或补查。
- 执行
insertAll($data)后，立刻调用Db::getLastInsID()—— 它只返回最后一条的 ID - 若需全部 ID，且 ID 连续无中断，可用
range($lastId - count($data) + 1, $lastId)推算（仅限单线程、无并发插入场景） - 更稳妥的做法：改用事务 + 循环
insert()并收集getLastInsID()，或用ON DUPLICATE KEY UPDATE配合SELECT LAST_INSERT_ID()多语句查询（需 PDO 支持PDO::ATTR_EMULATE_PREPARES = false）
大批量（>1 万条）必须分片，否则内存或 MySQL 直接拒绝
一次性塞 5 万条进 insertAll()，PHP 内存大概率飙到 200MB+，MySQL 也可能因 max_allowed_packet 限制报错 MySQL server has gone away。
立即学习“PHP免费学习笔记（深入）”；
- 按每批 500–2000 条切分，用
array_chunk($data, 1000) - 每批单独调用
insertAll()，避免单次构造超长 SQL - 如果用原生拼接 SQL（如
"INSERT INTO t(a,b) VALUES (1,2),(3,4),..."），注意末尾逗号要去掉，且单条 SQL 长度别超max_allowed_packet（默认 4MB，可查SHOW VARIABLES LIKE 'max_allowed_packet'） - TP5 中不要在循环里反复 new Query 对象，复用同一个
Db::table('xxx')实例
getField() 的数量参数容易误解为“取几条”，实际控制返回结构
getField('id,name', 3) 不是“取前 3 条记录”，而是“最多返回 3 个元素的数组”，具体结构取决于你传的字段数和分隔符。
-
getField('id', 3)→ 返回['1','2','3']（一维字符串数组） -
getField('id,name', 3)→ 返回[1=>'name1', 2=>'name2', 3=>'name3']（关联数组，key=id，value=name） -
getField('id,name,email', ':')→ 返回[1=>'name1:email1', 2=>'name2:email2']（冒号拼接） - 数量设为
true或省略，才真正表示“取全部匹配结果”；设为数字时，哪怕数据库有 100 条匹配，也只返回最多该数量个元素
批量操作最危险的地方不在语法，而在“以为成功了”的错觉——没检查返回值、没验证字段映射、没设超时和重试、没预估分片粒度。上线前拿 10 万条测试数据跑一遍真实流程，比看十篇文档都管用。
