ThinkPHP5.1.41批量添加数据必须用Db::insertAll()或模型saveAll()，禁用循环+save()；前者最稳、一次SQL、无验证开销，后者支持事件与验证但性能略低；超500条须分片（如array_chunk($data, 500)）、关闭调试、预处理脏数据。
直接说结论：ThinkPHP5.1.41批量添加数据，别用循环+save()，必须用Db::insertAll()或模型的saveAll()，否则单条插入在500条数据时可能超时、锁表、触发MySQL max_allowed_packet、甚至被WAF拦截。核心是「一次拼SQL」而非「N次请求数据库」。
Db::insertAll() 是最稳的批量写入方式
这是TP5.1原生查询类提供的专用方法，底层调用INSERT INTO ... VALUES (),(),() 语法，只发一次SQL请求。
常见错误现象：用foreach遍历数组，每轮调用Db::table()->insert($item)，100条数据就发100次SQL——线上环境基本会卡死或报MySQL server has gone away。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确保数据是二维关联数组，键名必须与数据库字段完全一致（大小写敏感）
- 单次插入不宜超过1000条，否则可能触发
max_allowed_packet（默认4M，1000条含中文的记录约2–3MB） - 插入前建议用
array_map('htmlspecialchars_decode', $data)预处理，防富文本中HTML实体干扰 - 返回值是影响行数（int），不是布尔值；失败时抛出
think\db\exception\DataNotFoundException异常
示例：
$data = [
['name' => '张三', 'email' => 'z3@example.com', 'create_time' => time()],
['name' => '李四', 'email' => 'l4@example.com', 'create_time' => time()],
];
$result = Db::name('user')->insertAll($data);
if (false === $result) {
// 插入失败，检查 $result->getError()
}模型saveAll()适合带事件/验证的场景
当你需要触发模型的before_insert、自动完成、验证规则（如require、email格式）、或者软删除字段自动填充时，用模型层更安全。
但注意：它内部仍是调用insertAll()，只是多了一层处理。性能略低，但业务逻辑完整性高。
容易踩的坑：
- 必须用
new User()实例化模型，不能用User::create()——后者只支持单条 - 数据里不能含主键（如id），否则TP会当作更新操作， silently 跳过
- 验证失败时，
saveAll()返回false，但不会告诉你哪一行错；需配合User::getError()看最后一条的错误信息 - 不支持事务自动包裹，如需回滚，得手动
Db::startTrans()+try/catch
示例：
$user = new User();
$data = [['name'=>'王五','email'=>'w5@example.com'], ['name'=>'赵六','email'=>'z6@example.com']];
$result = $user->saveAll($data);
if (false === $result) {
echo $user->getError(); // 只显示最后一条的验证错误
}大数量导入必须分片 + 关闭调试 + 预处理
超过2000条数据时，即使insertAll()也容易因PHP内存限制（memory_limit）或MySQL超时（wait_timeout）中断。
正确做法是切片 + 环境调优：
- 用
array_chunk($data, 500)分批，每批单独insertAll() - 导入前临时关闭调试：
Config::set('app_debug', false)，避免日志写入拖慢速度 - 禁用SQL日志记录：
Db::listen(function(){})清空监听器，或配置'sql_explain' => false - 确认MySQL的
innodb_buffer_pool_size足够（建议≥1G），否则大批量插入会频繁刷盘
特别注意：不要在事务里包所有分片——锁表时间太长；应在每个分片内独立事务，或干脆不用事务（依赖业务容错）。
Excel导入后批量写入的典型链路
你从PHPExcel读出$excel_array后，不能直接扔给insertAll()——它通常含表头、空行、类型错乱（日期变数字、数字变科学计数）。
关键处理点：
- 用
unset($excel_array[0])删首行（表头），再用array_values()重排键 - Excel日期列（如
$value[2]）要转为时间戳：($value[2] - 25569) * 86400，再date('Y-m-d H:i:s', $ts) - 空字符串
''要转为null（尤其对应数据库允许NULL的字段），否则MySQL报Data truncated for column - 字段映射必须显式做，别依赖顺序——
['username'=>$v[0], 'email'=>$v[1]]比[$v[0],$v[1]]可靠得多
这一步出错，insertAll()会直接报错退出，且错误提示极不友好（只说SQL语法错）。务必在入库前dump($data)确认结构。
真正难的不是“怎么写”，而是“怎么让5000条数据在3秒内稳稳落库还不崩”。大部分线上事故，都发生在没做分片、没关调试、没处理Excel脏数据这三步上。
