insertgetid仅支持单条插入，传入二维数组会报错或返回0；批量插入需用insertall+getlastinsid推算id，或分批单条插入+insertgetid确保精确映射。
ThinkPHP 6 的 insertGetId 不支持批量插入
直接说结论：insertGetId 只能处理单条记录，传入二维数组会报错或静默失败（比如返回 0 或 false）。这是最常踩的坑——误以为它像 Laravel 的 insertGetId 那样支持批量。
原因在于底层调用的是 PDO 的 lastInsertId()，而该方法只对最后一次 INSERT 有效；批量插入是一条 SQL 执行多行，数据库只生成一个起始 ID，无法映射回每条记录。
- 传入
[['name'=>'a'],['name'=>'b']]→ 报错Array to string conversion或返回0 - 即使不报错，返回值也仅是第一条记录插入后的 ID，不是 ID 数组
- TP5 和 TP6 行为一致，不存在版本差异“修复”
批量插入后想拿到所有自增 ID，只能用 insertAll + getLastInsID 组合
insertAll 能正确执行批量插入，但默认不返回 ID；配合 getLastInsID 可获取本次插入产生的第一个 ID，再结合插入条数推算出完整 ID 列表——前提是数据库引擎支持且未被其他并发写入干扰。
-
getLastInsID返回的是本次连接中最后一次 INSERT 的首个自增 ID（MySQL 中由SELECT LAST_INSERT_ID()获取） - 适用于连续、无间隙的自增主键（如
INT UNSIGNED AUTO_INCREMENT），且中间没被其他INSERT打断 - 示例：
$data = [['name' => 'a'], ['name' => 'b'], ['name' => 'c']]; $result = $model->insertAll($data); $firstId = $model->getLastInsID(); $idList = range($firstId, $firstId + count($data) - 1); // [101, 102, 103]
⚠️ 注意：如果表有触发器、或使用了 REPLACE INTO / INSERT ... ON DUPLICATE KEY UPDATE，LAST_INSERT_ID() 行为可能异常，此时不能依赖此法。
真正安全可靠的方案：分批单条插入 + insertGetId
当业务要求「必须精确对应每条数据和其 ID」，比如要立刻用新 ID 关联子表、发消息、写日志，就只能放弃批量性能，改用循环 + insertGetId。虽然慢，但语义清晰、100% 可靠。
- 开启事务包裹整个批次，避免部分成功部分失败导致数据不一致
- 注意 MySQL 的
max_allowed_packet和 PHP 的超时限制，单次不宜超过 100 条 - 示例：
$ids = [];
Db::startTrans();
try {
foreach ($data as $item) {
$id = $model->insertGetId($item);
$ids[] = $id;
}
Db::commit();
} catch (\Exception $e) {
Db::rollback();
throw $e;
}
别试图用 insertAll 后查 MAX(id) 反推——并发场景下结果不可信。
TP6.3+ 可用 withLock + 子查询规避竞争，但代价高
如果非得在批量插入后精准取 ID，又不能接受分条，唯一可行路径是：先锁表/锁段，再插入，再查刚插进去的记录。TP6.3 支持 withLock，可配合时间戳或临时标记字段实现。
- 给表加一个
batch_token字段（VARCHAR(32)），插入时统一设为随机 token - 用
withLock(true)查询刚插入的这批记录的 ID - 示例：
$token = uniqid('batch_');
$data = array_map(fn($x) => array_merge($x, ['batch_token' => $token]), $data);
$model->insertAll($data);
$ids = $model->where('batch_token', $token)->withLock(true)->column('id');
这方法绕开了 LAST_INSERT_ID 的局限，但多一次查询、加锁影响并发，且需额外字段。只有在 ID 映射绝对不可错的场景才值得上。
真正难的从来不是怎么写，而是判断哪条路能承担业务失败的后果——ID 错位在订单、资金类系统里，往往比慢一点更致命。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
