保存含UUID字段的实体时PostgreSQL出现类型不匹配错误

问题现象 #

保存带有UUID字段的实体时，调用setMyGuid(UUID.fromString(guid))后执行CrudRepository.save()，生成的SQL中my_guid列值为'<byte[]>'，绑定参数为[BINARY]类型，触发PostgreSQL错误：

Caused by: org.postgresql.util.PSQLException: ERROR: column "my_guid" is of type uuid but expression is of type bytea
  You will need to rewrite or cast the expression.

实体字段定义：

@Column(name = "my_guid", nullable = false, unique = true, columnDefinition = "uuid")
private UUID myGuid;

已配置hibernate.dialect或spring.jpa.database-platform为org.hibernate.dialect.PostgreSQLDialect，但无效果。

解决方案 #

1. 显式指定Hibernate UUID类型映射 #

在实体字段上添加@Type注解，强制使用PostgreSQL专属的UUID类型处理：

@Column(name = "my_guid", nullable = false, unique = true, columnDefinition = "uuid")
@Type(type = "org.hibernate.type.PostgresUUIDType")
private UUID myGuid;

该类型会直接将Java UUID映射为PostgreSQL的uuid类型，避免自动转成bytea。

2. 确认JPA方言配置完全生效 #

确保配置文件中同时指定JPA和Hibernate的方言属性，防止配置被覆盖：

• application.properties：

spring.jpa.database-platform=org.hibernate.dialect.PostgreSQLDialect
spring.jpa.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

• application.yml：

spring:
  jpa:
    database-platform: org.hibernate.dialect.PostgreSQLDialect
    hibernate:
      dialect: org.hibernate.dialect.PostgreSQLDialect

3. 验证驱动与Hibernate版本兼容性 #

当前使用postgresql-42.5.1和hibernate-core-6.1.6.Final，版本不匹配可能导致类型映射异常。建议升级PostgreSQL驱动到适配Hibernate 6.x的稳定版本（如42.7.x系列），或确认驱动版本与Hibernate版本的兼容性。

4. 检查UUID字符串格式合法性 #

确保传入的guid是标准UUID格式（如550e8400-e29b-41d4-a716-446655440000），UUID.fromString(guid)未抛出IllegalArgumentException。非法格式的UUID可能导致Hibernate错误处理类型。

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