使用JPA原生查询更新PostgreSQL UUID字段为Null时出错求助

问题说明 #

使用JPA原生查询更新PostgreSQL数据库中UUID类型的teacher_id字段为Null时，触发以下类型不匹配错误：

o.h.engine.jdbc.spi.SqlExceptionHelper : SQL Error: 0, SQLState: 42804
o.h.engine.jdbc.spi.SqlExceptionHelper : ERROR: column "teacher_id" is of type uuid but expression is of type bytea
Hint: You will need to rewrite or cast the expression.

相关代码如下：

@Transactional
@Modifying
@Query(value = "update student set teacher_id=:teacherId where studentId=:studentId", nativeQuery = true)
void updateTeacherUUID(@Param("teacherId") UUID teacherId, @Param("studentId") UUID studentId);

@Data
@Entity
@NoArgsConstructor
@AllArgsConstructor
@Table(name = "student")
public class Student {

   @Id
   UUID studentId;
   
   @Type(type = "org.hibernate.type.PostgresUUIDType")
   @Column(name = "teacher_id", columnDefinition = "uuid")
   UUID teacherId;
}

注：使用repository.update或HQL更新时无此问题，仅原生查询触发该错误。

解决方案 #

方案1：在原生SQL中显式转换参数类型 #

修改原生查询语句，强制将参数转换为uuid类型，确保参数类型与数据库字段匹配：

@Transactional
@Modifying
@Query(value = "update student set teacher_id=cast(:teacherId as uuid) where studentId=:studentId", nativeQuery = true)
void updateTeacherUUID(@Param("teacherId") UUID teacherId, @Param("studentId") UUID studentId);

方案2：改用HQL查询（推荐） #

HQL会通过Hibernate的ORM类型映射自动处理UUID与数据库类型的适配，直接替换为HQL即可避免类型问题：

@Transactional
@Modifying
@Query("update Student s set s.teacherId = :teacherId where s.studentId = :studentId")
void updateTeacherUUID(@Param("teacherId") UUID teacherId, @Param("studentId") UUID studentId);

问题原因 #

原生查询绕过了Hibernate的ORM类型转换逻辑，直接将UUID对象按默认JDBC类型传递给PostgreSQL驱动。当参数为Null时，驱动无法正确推断目标字段类型，错误地将参数序列化为bytea类型，与数据库中uuid类型字段不匹配，从而触发错误。而HQL或save/update方法会借助Hibernate的类型转换器完成适配，因此不会出现该问题。

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