SpringBoot 3.0升级后JPA自定义修改枚举字段查询报错

SpringBoot 3.0基于Hibernate 6.x，对JPQL的类型校验做了更严格的限制，导致2.6.x版本中隐式处理枚举字符串的逻辑不再生效，进而出现类型不匹配错误。以下是几种可行的解决方法：

1. 调整JPQL查询，显式处理枚举类型 #

方式A：直接传入枚举参数（推荐） #

修改Repository方法的参数类型为枚举本身，从根源避免字符串到枚举的转换问题：

@Modifying
@Query("UPDATE User u SET u.role = :role WHERE u.id = :id")
void updateUserRole(@Param("id") Long id, @Param("role") UserRole role);

调用时直接传递UserRole.ADMIN这类枚举实例即可。

方式B：在JPQL中使用CAST转换字符串 #

如果必须传入字符串参数，可在查询语句里通过CAST将字符串转为对应的枚举类型：

@Modifying
@Query("UPDATE User u SET u.role = CAST(:role AS com.yourproject.model.UserRole) WHERE u.id = :id")
void updateUserRole(@Param("id") Long id, @Param("role") String role);

注意替换com.yourproject.model.UserRole为你项目中枚举的实际全限定类名。

2. 临时启用Hibernate兼容模式（过渡方案） #

如果需要快速兼容旧代码，可在配置文件中添加Hibernate的兼容参数，恢复旧版本的类型处理逻辑：

# application.properties
spring.jpa.properties.hibernate.type.preferred_enum_type=string
spring.jpa.properties.hibernate.query.legacy_sql_behavior=true

⚠️ 注意：这只是临时过渡方案，Hibernate后续版本可能会移除这些兼容配置，建议尽快迁移到标准写法。

3. 确认枚举与实体字段的配置正确性 #

确保你的枚举类和实体字段配置没有问题：

• 枚举类为标准字符串映射（无需额外注解，默认枚举名称对应数据库字符串）：

public enum UserRole {
    ADMIN, USER, GUEST
}

• 实体字段的枚举注解正确：

@Enumerated(EnumType.STRING)
private UserRole role;

如果枚举使用了自定义字符串映射（比如@EnumValue），需确认该注解在SpringBoot 3.0环境下的兼容性，必要时调整转换逻辑。

内容的提问来源于stack exchange，提问作者T. Razvan