ThinkPHP6批量插入数据应优先使用insertAll（高效原生插入，不返回ID）或saveAll（走模型层，支持ID返回与校验）；大批量时需分批+事务优化，配合验证、去重、空值处理等防御措施。
ThinkPHP6 中接口实现批量插入数据，核心是用好 insertAll 和 saveAll 两个方法，同时兼顾性能、数据校验与主键返回需求。
直接使用 insertAll 批量写入
适用于简单、结构明确的批量插入场景，不依赖模型，操作数据库原生表。它一次执行一条 INSERT … VALUES (…), (…), (…) 语句，效率高于循环单条插入。
- 传入二维关联数组，每项为一条记录，字段名需与数据表列严格对应
- 返回成功插入的记录数（整型），失败时抛出异常，建议配合 try-catch 处理
- 不自动返回自增 ID，如需获取，应改用
saveAll或手动查 lastInsertId
示例：
```php$data = [
['name' => '张三', 'age' => 25, 'email' => 'z3@example.com'],
['name' => '李四', 'age' => 28, 'email' => 'l4@example.com'],
['name' => '王五', 'age' => 22, 'email' => 'w5@example.com']
];
$count = Db::name('user')->insertAll($data);
```
用 saveAll 获取插入后的自增ID
当需要知道每条记录生成的主键（如用于后续关联操作），必须走模型层的 saveAll。它会逐条调用模型的 save 方法，并在成功后将 ID 注入原数组。
- 必须基于已定义的模型类（如
User），且模型中需声明主键字段（默认id） - 返回布尔值，成功时原数组每项会新增
id键；失败则中断并返回 false - 支持自动过滤非法字段（配合
allowField）、时间戳、自动验证等模型特性
示例：
```php$user = new User();
$list = [
['name' => 'Alice', 'email' => 'a@tp6.com'],
['name' => 'Bob', 'email' => 'b@tp6.com']
];
$result = $user->saveAll($list);
if ($result) {
$ids = array_column($list, 'id'); // 提取所有新生成的 id
}
```
大批量导入时的性能优化建议
单次插入超过 1000 条时，insertAll 效率会明显下降。可结合分批 + 事务提升稳定性与速度。
- 按 500–1000 条/批次拆分数据，避免 SQL 过长或内存溢出
- 外层包裹事务：
Db::transaction()，确保全部成功或全部回滚 - 对 Excel 导入等场景，先用 PhpSpreadsheet 读取并清洗数据，再批量入库，避免边读边插
- 极端大数据量（如 10 万+）可考虑导出 CSV 后用 MySQL 的
LOAD DATA INFILE命令直入，跳过 PHP 层解析
常见问题处理
实际接口中常遇到字段缺失、重复主键、类型错误等问题，需提前防御。
- 字段校验：用
validate验证器统一检查必填项和格式，失败直接返回错误信息 - 去重插入：若存在唯一索引冲突，可用
replace方法替代insertAll（注意它是先删后插） - 忽略非法字段：调用
strict(false)防止因多传字段导致报错，例如Db::name('user')->strict(false)->insertAll($data) - 空值处理：数据库字段设为允许 NULL，或在插入前用
array_filter清洗空字符串/NULL 值
