MyBatis-Plus @TableId注解之主键配置与常见问题分析
更新时间：2026年03月13日 11:13:11 作者：bug攻城狮
MyBatis-Plus的@TableId注解用于标识实体类的主键字段,可配置主键列名、生成策略、是否保持全局格式等属性
在MyBatis-Plus中，@TableId注解用于标识实体类的主键字段，并可以配置多种属性。以下是@TableId可选的属性及其说明：
1.value
作用：指定数据库表中的主键列名（如果字段名与列名不一致时使用）。
示例：
@TableId(value = "user_id") private Long id;
- 表示实体类的
id字段对应数据库表的user_id列。
2.type
作用：指定主键生成策略（IdType枚举类型）。
可选值：
| 值 | 说明 |
|---|---|
| IdType.AUTO | 数据库自增（MySQL的AUTO_INCREMENT） |
| IdType.NONE | 无策略，需手动设置主键值 |
| IdType.INPUT | 用户手动输入主键值 |
| IdType.ASSIGN_ID | 默认策略，使用雪花算法生成Long类型ID |
| IdType.ASSIGN_UUID | 生成UUID字符串类型ID |
| IdType.ID_WORKER | 已废弃，改用ASSIGN_ID |
| IdType.UUID | 已废弃，改用ASSIGN_UUID |
示例：
@TableId(type = IdType.AUTO) private Long id; // 依赖数据库自增
3.keepGlobalFormat（3.5.0+）
作用：是否保持全局主键格式（如全局配置了前缀/后缀，是否应用到当前字段）。
默认值：false
示例：
@TableId(keepGlobalFormat = true) private String customId;
全局配置（替代@TableId）
如果不想在每个实体类上写@TableId，可以在application.yml中配置全局策略：
mybatis-plus: global-config: db-config: id-type: assign_id # 全局主键策略（默认为ASSIGN_ID） table-prefix: t_ # 表前缀（可选）
常见问题
数据库自增但未生效：
- 确保数据库表的主键列设置了
AUTO_INCREMENT。 - 确保
@TableId(type = IdType.AUTO)。
雪花算法ID冲突：
ASSIGN_ID生成的ID可能因系统时间回拨导致重复，需配置workerId和datacenterId。
UUID主键：
- 使用
@TableId(type = IdType.ASSIGN_UUID)时，字段类型应为String。
完整示例
@Data
@TableName("sys_user")
public class User {
@TableId(value = "user_id", type = IdType.ASSIGN_ID)
private Long id;// 雪花算法ID
@TableId(value = "uuid", type = IdType.ASSIGN_UUID)
private String uuid;// UUID字符串
}
总结
以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。
相关文章
这篇文章主要介绍了Apache CXF如何把wsdl生成java代码,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2020-04-04
SpringCloud Gateway使用redis实现动态路由的方法
这篇文章主要介绍了SpringCloud Gateway使用redis实现动态路由的方法，本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2021-01-01
这篇文章主要介绍了基于spring@aspect注解的aop实现过程代码实例,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2020-03-03
本文给大家分享了2个java封装好的mail包发送电子邮件的类，并附上使用方法，小伙伴们可以根据自己的需求自由选择。2016-01-01
这篇文章主要介绍了SpringBoot使用jsr303校验的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-10-10
Spring中的DeferredImportSelector实现详解
这篇文章主要介绍了Spring中的DeferredImportSelector实现详解,两个官方的实现类AutoConfigurationImportSelector和ImportAutoConfigurationImportSelector都是Spring Boot后新增的实现,需要的朋友可以参考下2024-01-01
这篇文章主要介绍了深入理解Java之HashMap源码剖析，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2017-02-02
这篇文章主要为大家介绍了Java的继承与多态，具有一定的参考价值，感兴趣的小伙伴们可以参考一下，希望能够给你带来帮助2022-01-01
这篇文章主要为大家详细介绍了Java如何调用opencv实现图片矫正功能,文中的示例代码简洁易懂,感兴趣的小伙伴可以跟随小编一起学习一下2023-09-09
这篇文章主要给大家介绍了关于Java正则表达式如何匹配特定html标签内的内容的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-09-09
最新评论