Spring Boot 3更新枚举类型时触发org.hibernate.query.SemanticException

问题根源 #

你的JPQL更新语句里直接用字符串'ENABLED'给枚举类型字段赋值，Hibernate 6.x（Spring Boot 3.0.2默认依赖）会做严格类型校验，字符串类型和MyStatusEnum类型不匹配，所以抛出异常。

两种可行的解决办法 #

方法1：在JPQL中使用枚举的全限定类名

修改仓库方法的查询语句，明确指定枚举的完整路径：

@Transactional
@Modifying
@Query("UPDATE MyEntityClass e SET e.status = com.yourpackage.MyStatusEnum.ENABLED")
int setEnabledStatus();

记得把com.yourpackage替换成你实际项目中MyStatusEnum所在的包路径。

方法2：通过命名参数传入枚举实例

用参数传递枚举值，让JPA自动处理类型转换：

import org.springframework.data.jpa.repository.query.Param;

// ...

@Transactional
@Modifying
@Query("UPDATE MyEntityClass e SET e.status = :status")
int setEnabledStatus(@Param("status") MyStatusEnum status);

调用这个方法时传入MyStatusEnum.ENABLED即可。

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