ThinkPHP 6.1.5 接口开发中数据库事务保障多步写操作一致性，需InnoDB引擎支持；推荐模型方式开启事务，跨库需各连接独立管理；接口中应控制事务粒度、避免外部调用、完善日志与返回规范。
ThinkPHP 6.1.5 中接口开发使用数据库事务，核心在于保障多步写操作的数据一致性——比如创建订单同时扣库存、新增用户并初始化其配置表、跨库写入关键业务数据等。只要其中任意一步失败，全部回滚，避免脏数据残留。
事务前提：确保数据库引擎支持
MySQL 必须使用 InnoDB 引擎，MyISAM 不支持事务。可在 Navicat 或 phpMyAdmin 中打开每张表的“设计表” → “选项” → 将“存储引擎”改为 InnoDB。注意：不是改一次就全局生效，每张表都要单独确认。建表 SQL 中也建议显式声明：
ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;单库事务：模型方式最常用
推荐用模型（Model）而非 Db 类直接操作，语义清晰、自动处理时间戳和类型转换。事务需在模型方法外开启，不能在模型内部 startTrans()：
- 在控制器中调用
User::transaction()包裹业务逻辑 - 或手动用
Db::startTrans()+try/catch控制提交与回滚 - 模型内所有 save()、create()、delete() 等写操作，只要在事务块内，都会被统一管理
示例（用户注册+默认地址插入）：
立即学习“PHP免费学习笔记（深入）”；
$user = User::create(['username' => 'jack', 'password' => '123']);
Address::create(['user_id' => $user->id, 'city' => 'Shanghai']);
});
跨库事务：连接实例需独立管理
TP6 不支持跨库自动事务，必须对每个数据库连接分别调用 startTrans()、commit() 和 rollback()。关键点：
- 使用
Db::connect('mysql://...')获取指定库连接实例 - 每个连接都需独立开启事务，且 commit/rollback 调用必须一一对应
- 异常时，所有已开启事务的连接都必须回滚，缺一不可
常见错误是只 rollback 主库，忽略从库连接，导致数据不一致。
API 接口中的事务实践要点
接口场景下事务要兼顾稳定性与可观测性：
- 事务块尽量短，避免长时间锁表；高并发下单接口建议加行锁或乐观锁
- 不要在事务中调用外部 HTTP 请求或耗时任务，否则可能超时或阻塞
- 日志记录建议放在 try 外部或 catch 中，确保失败时也能留下完整上下文
- 返回结构统一，成功返回 200 + data，失败返回 400/500 + error_code 和 msg
事务不是万能锁，而是数据安全的底线。用对了，接口才真正“靠得住”。
