ThinkPHP批量添加数据代码怎么写-ThinkPHP-PHP中文网

db::insertall()是thinkphp6最直接高效的批量插入方式，底层执行单条insert into values(),(),()语句，需确保数据结构一致、避免主键冲突、分批（500–1000条）并事务包裹。

thinkphp批量添加数据代码怎么写

ThinkPHP 6 的 `Db::insertAll()` 是最直接的方式

批量插入数据，优先用 Db::insertAll()，它底层走的是原生 INSERT INTO ... VALUES (),(),() 语句，效率高、事务安全、自动转义防注入。别自己拼 SQL 字符串，也别在循环里反复调用 Db::insert()——那会触发 N 次查询，性能断崖式下跌。

使用前提：所有数据结构必须一致（字段名、数量、类型），且不能含主键自增字段（除非显式指定）。

示例：

$data = [
    ['name' => '张三', 'age' => 25, 'status' => 1],
    ['name' => '李四', 'age' => 30, 'status' => 1],
    ['name' => '王五', 'age' => 28, 'status' => 0]
];
$result = Db::name('user')->insertAll($data);
// $result 返回影响的行数（int），失败返回 false

如果表有自增主键 id，数组中不要带 id 键；要强制指定就加进去，但得确保不冲突
insertAll() 默认不返回插入后的 ID 列表；如需获取，得改用 Db::query() 手写 INSERT ... RETURNING id（仅 PostgreSQL 支持）
单次插入不宜超过 1000 条，否则可能触发 MySQL 的 max_allowed_packet 限制

用模型批量保存时注意 `saveAll()` 的行为差异

模型类的 saveAll() 看似更“面向对象”，但它默认逐条调用 save()，本质是 N 次单条插入（或更新），不是真正的批量 SQL。只有传入 ['batch' => true] 参数，才会退化为 Db::insertAll() 底层执行。

错误写法（低效）：

btpanel phpsite 宝塔面板PHP网站

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

下载

UserModel::saveAll($data); // 默认 batch=false，慎用！

正确写法（等价于 Db::insertAll）：

UserModel::saveAll($data, ['batch' => true]);

即使开了 batch => true，模型的自动时间戳、自动写入等钩子仍会生效，但只运行一次（非每条数据都触发）
如果数据中混杂了已存在主键的记录，saveAll(..., ['batch'=>true]) 会报错；此时应改用 replace 或先查后判
验证规则对批量数据仍有效，但失败时整个批次回滚，不会部分插入

遇到 “Column count doesn’t match value count” 错误怎么办

这是 insertAll() 最常见的报错，根本原因是某条数据的键（字段名）与其他条不一致，比如：

$data = [
    ['name' => 'A', 'age' => 20],
    ['name' => 'B', 'age' => 25, 'email' => 'b@test.com'], // 多了一个 email
];

ThinkPHP 会取第一条数据的 key 作为字段列表，后续条目若字段数不匹配，就炸。

解决办法：统一用 array_map() 补全缺失字段，例如 array_fill_keys(['name','age','email'], null)
开发期可用 array_column($data, null, 'name') 快速检查是否重复键名（避免覆盖）
别依赖前端传来的动态字段做批量插入，字段必须白名单校验并标准化

大数据量导入建议分批 + 关闭日志 + 手动事务

一次性插 10 万条？别硬扛。即使用了 insertAll()，也要拆成 500～1000 条/批，并关闭查询日志和开启事务包裹，否则内存爆、日志写满、锁表太久。

实操建议：

Db::startTrans();
try {
    foreach (array_chunk($allData, 500) as $chunk) {
        Db::name('log')->insertAll($chunk);
    }
    Db::commit();
} catch (\Exception $e) {
    Db::rollback();
    throw $e;
}
// 插入前可临时关闭日志：Db::setLogLevel(0)