MyBatis-Plus 中使用 SQLite 自增主键的注意事项

背景介绍

MyBatis-Plus 作为 MyBatis 的增强工具，在简化数据库操作方面提供了诸多便利功能。在实际开发中，SQLite 数据库因其轻量级特性常被用于嵌入式系统或小型应用中。本文将重点讨论 MyBatis-Plus 与 SQLite 结合使用时，关于自增主键(ID)获取的一个典型问题。

问题现象

在使用 MyBatis-Plus 保存数据到 SQLite 数据库时，开发者可能会遇到无法获取自增主键的问题。这个问题通常表现为：

1. 数据能够成功插入数据库
2. 但无法通过常规方法获取数据库自动生成的主键值
3. 报错信息通常与 getGeneratedKeys 方法相关

问题根源

经过分析，这个问题主要与 SQLite JDBC 驱动版本有关：

1. 在 SQLite-JDBC 3.42.0.1 版本中，获取自增主键功能工作正常
2. 从 3.43.0.0 版本开始，驱动移除了对 Statement#getGeneratedKeys 的支持
3. 这直接影响了 MyBatis-Plus 获取自增主键的能力

解决方案

针对这个问题，开发者可以采取以下解决方案：

1. 使用兼容版本：继续使用 3.42.0.1 版本的 SQLite-JDBC 驱动
2. 升级到修复版本：SQLite-JDBC 在 3.45.0.0 版本中恢复了对此功能的支持

最佳实践建议

1. 版本控制：在项目中使用固定版本的 SQLite-JDBC 驱动，避免自动升级带来的兼容性问题
2. 测试验证：升级驱动版本后，务必测试自增主键获取功能是否正常
3. 替代方案：考虑使用 last_insert_rowid() 函数作为获取最后插入ID的备选方案
4. 监控变更：关注 SQLite-JDBC 项目的更新日志，特别是涉及核心功能的变更

技术原理

SQLite 的自增主键机制与其他数据库有所不同：

1. SQLite 使用特殊的 INTEGER PRIMARY KEY 列作为自增主键
2. 当插入新记录时，如果该列值为NULL，SQLite会自动分配一个比当前最大值大1的值
3. JDBC 驱动需要通过特定方法将这个自动生成的值返回给应用程序

总结

MyBatis-Plus 与 SQLite 的结合使用在大多数情况下都能良好工作，但在特定驱动版本下可能会出现自增主键获取异常。开发者应当：

1. 了解所使用的驱动版本特性
2. 建立完善的版本管理策略
3. 对关键功能进行充分测试
4. 保持对相关开源项目的关注

通过以上措施，可以确保 MyBatis-Plus 与 SQLite 的稳定配合，充分发挥两者的优势。