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字符串
}
总结
以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。
相关文章
这篇文章主要给大家介绍了关于SpringBoot时区问题解决以及彻底解决时差问题的相关资料,spring boot作为微服务简易架构,拥有其自身的特点,快速搭建架构,简单快捷,需要的朋友可以参考下2023-08-08
本文主要介绍了Javers 比较两个类的差异，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2022-02-02
今天项目要求Nginx+jar包运行多个项目,在此记录一下部署的过程,其中借鉴了好多网上前辈的经验,感谢各位的无私分享2024-07-07
这篇文章主要介绍了关于JWT之token令牌认证登录,使用JWT能够保证Token的安全性，且能够进行Token时效性的检验，使用JWT时，登录成功后将用户信息生成一串令牌字符串,需要的朋友可以参考下2023-05-05
Arthas是一款由阿里巴巴开源的Java应用诊断利器，它可以帮助开发人员在运行时对Java应用进行调试和诊断，解决线上问题，本文将简单的描述一下该工具的用法和常用命令，以勾起大家对此工具应用的兴趣2023-06-06
解决MyEclipse中的Building workspace问题的三个方法
这篇文章主要介绍了解决MyEclipse中的Building workspace问题的三个方法，需要的朋友可以参考下2015-11-11
Failed to execute goal org...的解决办法
这篇文章主要介绍了Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.1的解决办法的相关资料,需要的朋友可以参考下2017-06-06
读万卷书不如行万里路，只学书上的理论是远远不够的，只有在实战中才能获得能力的提升，本篇文章手把手带你用java+SSM+jsp+mysql+maven实现前台阅读后台管理的小说在线阅读系统,大家可以在过程中查缺补漏，提升水平2021-11-11
这篇文章主要为大家介绍了Nacos配置中心集群原理及源码分析，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步早日升职加薪2022-03-03
这篇文章主要介绍了idea切换分支的时候,忽略一些无用的修改操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2021-02-02
最新评论