JPA保存PostgreSQL UUID外键主表时出现unrecognized id type错误

• 报错核心原因是AdvantureInfo主表实体的主键生成策略配置错误：GenerationType.IDENTITY仅适用于数据库自增整型主键（如PostgreSQL的serial、MySQL的auto_increment），完全不支持UUID类型的主键，Hibernate在生成主键时无法完成类型转换，因此抛出类型不匹配错误。
• 次要优化点：当前保存逻辑中直接new Advanture对象设置ID的写法属于游离态对象关联，虽然Hibernate会自动发起查询校验关联对象是否存在，但存在不必要的性能开销。

1. 修正主键生成策略 #

根据你的业务需求选择以下任意一种方案即可：

方案A：使用Hibernate自动生成UUID #

修改AdvantureInfo的主键配置，指定UUID生成器，同时添加PostgreSQL UUID类型映射：

@Id
@Column(name = "adventurer_info_id", unique = true, nullable = false)
@GeneratedValue(generator = "uuid2")
@GenericGenerator(name = "uuid2", strategy = "org.hibernate.id.UUIDGenerator")
@Type(type = "pg-uuid")
private UUID id;

方案B：数据库层面自动生成UUID #

首先确保PostgreSQL已经安装uuid-ossp扩展，建表时给主键字段设置默认值uuid_generate_v4()，然后修改主键注解：

@Id
@Column(name = "adventurer_info_id", unique = true, nullable = false)
@GeneratedValue(strategy = GenerationType.AUTO)
@Type(type = "pg-uuid")
private UUID id;

方案C：手动赋值主键 #

如果业务逻辑中需要自己控制主键生成，直接移除@GeneratedValue注解即可，保存数据前手动调用setId()方法给主键赋值：

@Id
@Column(name = "adventurer_info_id", unique = true, nullable = false)
@Type(type = "pg-uuid")
private UUID id;

2. 优化关联对象查询逻辑 #

将直接new关联对象的写法改为调用JpaRepository的getReferenceById方法获取代理对象，减少不必要的查询开销：

AdvantureInfo advantureInfo = new AdvantureInfo();
// 直接获取关联对象代理，不需要实际查询数据库
Advanture advanture = advantureRepository.getReferenceById(UUID.fromString(registration.getAdvId()));
advantureInfo.setAdvanture(advanture);
advanInfoRepository.save(advantureInfo);

3. 可选校验配置 #

确认项目配置文件中已经配置了正确的PostgreSQL方言：

spring.jpa.properties.hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect

内容的提问来源于stack exchange，提问作者user16711881