insertGetId() 返回0的根源是TP未识别自增主键：需确认数据库字段确为auto_increment（MySQL）或SERIAL（PostgreSQL），模型中正确设置$pk和$auto，避免直接使用Db类绕过模型，排除分表、事务干扰。
如果 insertGetId() 返回 0，不是数据库没插成功，而是 TP 没“认出”哪个字段才是真正的自增主键。核心问题在于：TP 默认只认 id 字段为自增主键，且依赖数据库原生的自增机制返回 ID —— 如果你改了字段名、用了非标准配置，或没在模型里明确声明，它就会失效。
确认数据库表的自增字段是否真实生效
这是最基础也最容易被跳过的一步。TP 不校验，只信任你写的配置，但前提是数据库本身得支持。
- 用 MySQL 客户端执行：
SHOW COLUMNS FROM `your_table`;，检查目标字段（比如log_id）的Extra列是否为auto_increment - 如果不是，需执行修改语句（注意备份）：
ALTER TABLE `your_table` MODIFY `log_id` INT UNSIGNED AUTO_INCREMENT PRIMARY KEY FIRST; - PostgreSQL 用户请确认该字段是
SERIAL或带GENERATED ALWAYS AS IDENTITY的定义
检查模型类中是否正确定义了 $pk 和 $auto
仅改数据库不够，模型必须同步告诉 TP：“这个字段才是主键，而且它是自增的”。缺一不可。
- 在对应模型类中添加：
protected $pk = 'log_id'; - 同时必须加上：
protected $auto = true;（很多教程漏掉这行，导致 insertGetId() 仍返回 0） - 确保没有在模型中误设
protected $sequence（仅 Oracle/PostgreSQL 需要，MySQL 不用） - 如果表无主键或主键非自增，
insertGetId()必然返回 0，此时应改用insert()+ 手动处理
验证 Db 查询方式是否绕过了模型逻辑
如果你没用模型，而是直接走 Db::name('table')->insertGetId($data)，那它完全不读模型的 $pk 和 $auto，而是硬编码找 id 字段。
立即学习“PHP免费学习笔记（深入）”；
- 这种写法下，即使数据库字段叫
log_id，TP 也会去查id—— 而该字段可能不存在或不是自增，结果就是 0 - 解决方法有两个：
① 改用模型调用：(new YourModel())->insertGetId($data)
② 或改用insert($data, true)（第二个参数为true表示强制返回自增 ID，底层会尝试适配当前表结构）
排除中间层干扰（分表、事务、中间件）
某些扩展或自定义逻辑会重写插入行为，使 insertGetId() 失效。
- 检查是否启用了分表组件（如 think-swoole 分表中间件），它可能把 insert 拆成多条语句或代理执行，导致 PDO 的
lastInsertId()无法准确获取 - 确认插入不在手动开启的事务之外调用 ——
lastInsertId()必须在同一次连接、同一事务内紧接 insert 后调用才有效 - 临时禁用所有数据库中间件，用最简代码测试：
Db::name('test')->insertGetId(['name' => 'a'])，看是否仍返回 0
