ThinkPHP多表批量添加必须用Db::transaction()闭包包裹所有操作，异常自动回滚、成功自动提交；禁止混用saveAll()/insertAll()或跨模型调用，须确保单连接、InnoDB引擎及异常穿透。
ThinkPHP 多表批量添加时使用事务，核心是用 Db::transaction() 包裹所有写入操作，确保全部成功才提交，任一失败则自动回滚。
用 Db::transaction() 包裹多表插入
这是最常用、最推荐的方式。把多个 insert() 或 saveAll() 操作放在闭包里，框架会自动开启、提交或回滚事务：
- 如果所有插入都成功，事务自动提交
- 如果中间抛出异常（包括手动 throw 或数据库错误），事务自动回滚
- 无需手动调用
startTrans()、commit()、rollback()
示例：
use think\facade\Db;
$result = Db::transaction(function () {
// 表1：用户信息
$userId = Db::name('user')->insertGetId([
'name' => '张三',
'email' => 'zhangsan@example.com'
]);
// 表2：用户扩展资料（依赖 user_id）
Db::name('profile')->insert([
'user_id' => $userId,
'age' => 28,
'city' => '北京'
]);
// 表3：用户订单（也可批量插入多条）
Db::name('order')->insertAll([
['user_id' => $userId, 'amount' => 99.9, 'status' => 1],
['user_id' => $userId, 'amount' => 158.5, 'status' => 1]
]);
// 全部执行完，无异常 → 自动提交
return true;
});
if ($result === false) {
// 事务已回滚，可记录日志或提示用户
echo '操作失败，已回滚';
}
手动控制事务（需自行处理异常）
适合需要精细控制流程、或在事务中做非数据库操作的场景。注意必须显式捕获异常并调用 rollback()：
立即学习“PHP免费学习笔记（深入）”；
- 调用
Db::startTrans()开启事务 - 每个插入后检查返回值（如
insertGetId()返回 0 表示失败） - 发生错误时立即
Db::rollback()，然后 return 或 throw - 全部成功后调用
Db::commit()
示例关键片段：
Db::startTrans();
try {
$uid = Db::name('user')->insertGetId([...]);
if (!$uid) throw new \Exception('用户插入失败');
$pid = Db::name('profile')->insert(['user_id'=>$uid, ...]);
if (!$pid) throw new \Exception('资料插入失败');
Db::commit();
} catch (\Exception $e) {
Db::rollback();
echo $e->getMessage();
}
模型层用 transaction()（推荐配合模型使用）
若使用模型（如 UserModel、OrderModel），可在模型方法中封装事务逻辑，保持业务清晰：
- 在模型里定义一个方法，比如
createUserWithOrders() - 该方法内部调用
Db::transaction()，组织多表写入 - 控制器中直接调用，避免事务逻辑散落在各处
例如 UserModel 中：
public function createUserWithOrders($userData, $ordersData)
{
return Db::transaction(function () use ($userData, $ordersData) {
$user = $this->create($userData);
ProfileModel::create([
'user_id' => $user->id,
'age' => $userData['age'] ?? 0
]);
OrderModel::insertAll($ordersData);
return $user;
});
}
注意事项和常见坑
- 事务只对支持事务的数据库引擎生效（如 MySQL 的 InnoDB，MyISAM 不支持）
- 跨库操作无法用单个事务保证一致性（ThinkPHP 默认不支持分布式事务）
- 事务中不要混用原生 SQL 和 Query 对象，容易因连接复用导致行为异常
- 批量插入大量数据时，建议分批（如每 500 条一次 insertAll），避免事务过长锁表
- 调试时可在事务闭包内加
dump()或日志，但避免exit/die，否则可能跳过自动回滚
