MyBatis-Plus主键生成策略
MyBatis-Plus 主键生成策略中,最常用的是IdType.AUTO,表示主键的生成是由 数据库的自增功能 控制的,前提:数据库的主键列必须设置为 AUTO_INCREMENT。
MyBatis-Plus 提供了内置的主键生成策略,可以在不改动业务代码的前提下自动生成主键值,而无需依赖数据库的自增主键。以下是解决方法和配置方式:
(1) IdType.ASSIGN_ID
(默认雪花算法)
使用 MyBatis-Plus 提供的雪花算法生成全局唯一主键。此策略适用于 Long
或 String
类型的主键。
@TableId(value = "pay_id", type = IdType.ASSIGN_ID)
private Long payId;
- 特点:生成的 ID 是分布式唯一的,性能高,适合大规模并发场景。无需表设置主键自增。
(2) IdType.ASSIGN_UUID
使用 UUID 作为主键,适用于 String
类型的主键。
@TableId(value = "pay_id", type = IdType.ASSIGN_UUID)
private String payId;
- 特点:生成 32 位 UUID 字符串,适合跨系统场景,但主键长度较长,性能略低于雪花算法。
(3) IdType.INPUT
手动输入主键值,由开发者提供。
@TableId(value = "pay_id", type = IdType.INPUT)
private Integer payId;
- 特点:开发者需要在插入数据前手动设置主键值。MyBatis-Plus 不会自动生成,未设置主键id是null,会插入失败。
(4) IdType.NONE
不使用 MyBatis-Plus 的主键生成策略,完全交给数据库处理(如果数据库的主键设置为自增,则行为类似于 IdType.AUTO)。
3. 示例代码
假设你的表 pay_order
没有设置自增主键,现在想使用 MyBatis-Plus 内置雪花算法自动生成主键。
实体类定义
@TableName("pay_order")
public class PayOrderPO {
@TableId(value = "pay_id", type = IdType.ASSIGN_ID) // 使用雪花算法
private Long payId;
private String orderNo;
// 省略其他字段
}
插入操作
PayOrderPO payOrderPO = new PayOrderPO();
payOrderPO.setOrderNo("ORDER123456");
payOrderMapper.insert(payOrderPO);
System.out.println(payOrderPO.getPayId());
在插入时,MyBatis-Plus 会自动生成 pay_id
值。
注意点:主键id必须是Long类型(对应数据库bigint)如果Id 的类型定义为 Integer,这可能导致雪花算法生成的 long 值被截断为 Integer 类型,从而出现负数。
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 分享一个免费、快速、无限量使用的满血 DeepSeek R1 模型,支持深度思考和联网搜索!
· 基于 Docker 搭建 FRP 内网穿透开源项目(很简单哒)
· ollama系列01:轻松3步本地部署deepseek,普通电脑可用
· 按钮权限的设计及实现
· 25岁的心里话