详解mybatis plus插入操作在不返回主键情况下的处理方法

简介：
本项目基于Spring Boot框架进行开发。早期阶段采用的是MyBatis，随后进行了升级至MyBatis Plus版本。按照MyBatis Plus官方文档所述，在使用‘insert’方法时，针对自增数据库表的情况，该框架会将主键信息传递给实例的相应属性。然而，在实际操作过程中并未实现这一功能。 以下是实体类的具体配置示例： $className = MyEntity; // 实体类名称 $basePath = /path/to/your/database; // 数据库路径 [DATABASES] $dbName = %s; driver = hibernate:////%s:MSSQLServer; charset=utf8mb4 % $basePath; [ELEMENTS] entity = [ $className, columns = [ id => [DNUMBER, primary_key], // 添加其他字段配置 ], ]; 注：以上配置示例为简化版本，实际项目中可能需要根据具体需求进行调整。在使用MyBatis Plus (MP) 进行数据操作时，在实际应用中，用户可能遇到在插入新记录后无法及时获得自增主键的问题。本文将深入分析这种现象的原因，并提供有效的解决方案。作为 MyBatis 的一个功能增强版本，MyBatis Plus提供了诸多辅助的数据操作接口。其中包含了一系列便于进行增删改查等基本操作的接口。当向数据库中插入新记录时，针对那些配置了自增主键字段的情况，MyBatis Plus会自动完成主键的自动生成与返回操作。例如，在处理 UserInfo 这一实体类时，@TableId注解被用于指定主键字段 userId 的属性，并将其数据类型配置为自增标识（即 IdType.AUTO）。```java @TableId(value = user_id, type = IdType.AUTO) private Long userId; ```在 Dao 处 tier 的实现中，我们基于该接口实现了 `BaseMapper$`。从而允许通过 MP 的标准 CRUD 操作机制，其中插入操作（insert）作为示例。```java @Repository @Mapper public interface UserInfoDao extends BaseMapper { } ```然而，在执行`insert`方法插入数据之后，却发现主键`userId`未能被自动赋值。这可能源于冲突的SQL指令，这些指令在数据库操作中用于防止数据不一致或重复。在特定情况下，可能会由于历史遗留问题或者第三方工具（如MyBatis Generator）的影响，在对应的MapperXML文件中仍保留了传统的`insert`方法，其标识名称与通用的MP方法相同：```xml ```当这种情况出现时，在XML文件中定义的特定的`insert`方法可能会取代MP所支持的通用方法，从而使MP自动处理主键返回的功能无法正常执行。为了避免这一问题，请确保在相关配置中避免使用该特定的方法，并检查并删除任何不再需要的自定义语句。```xml ```删除之后，再次使用 MP 的 insert 方法时，应当能够将自增主键值正确地回填到实体类的相应属性中。其原因在于 MP 的通用方法能够准确地执行并将其新生成的主键值正确地填充至实体类的对应属性。具体说明如下：当在MySQL中使用MyBatis Plus进行数据插入操作时，若遇到主键字段未返回的问题，请从以下几点进行排查：1. 确认实体类中的主键字段是否被正确设置为自增类型。2. 应确保Dao接口仅调用MP提供的标准方法，并避免自定义实现与MP冲突。3. 建议检查MapperXML文件中的自定义SQL指令，删除那些与MP通用方法ID一致的代码块。通过以上步骤，一般都能解决MyBatis Plus插入数据后无法获取自增主键的问题。若问题依旧存在，则可能还需进一步排查数据库配置、事务管理或者其他潜在的代码问题。