Hibernate 6（Spring Boot 3迁移）自定义类型JPA查询报错求助

问题原因 #

Hibernate 6对类型检查的严格性比Hibernate 5更高，当你在JPA查询中直接用字符串（如'ARCHIVED'）和自定义类型CustomStatus的属性对比时，会因类型不匹配抛出错误——Hibernate期望的是CustomStatus类型实例，而非String。

解决方法 #

方法一：使用自定义类型实例作为查询参数 #

直接在Repository方法中使用CustomStatus类型的参数，而非字符串，让Hibernate自动处理类型匹配：

// Repository接口
public interface BaseEntityRepository extends JpaRepository<BaseEntity, Long> {
    List<BaseEntity> findByStatus(CustomStatus status);
    List<BaseEntity> findByStatusNotIn(Collection<CustomStatus> statuses);
}

调用时传入枚举实例即可：

// 示例调用
List<BaseEntity> archivedEntities = baseEntityRepository.findByStatus(CustomStatus.ARCHIVED);
List<BaseEntity> activeEntities = baseEntityRepository.findByStatusNotIn(
    Arrays.asList(CustomStatus.ARCHIVED, CustomStatus.CANCELLED)
);

这是最符合JPA规范的方案，避免类型转换问题。

方法二：在HQL查询中显式转换类型 #

如果必须使用字符串参数，可通过HQL的cast函数统一两边的类型：

public interface BaseEntityRepository extends JpaRepository<BaseEntity, Long> {
    @Query("select e from BaseEntity e where e.status = cast(:status as com.yourpackage.CustomStatus)")
    List<BaseEntity> findByStatusString(@Param("status") String status);

    @Query("select e from BaseEntity e where cast(e.status as string) not in :statuses")
    List<BaseEntity> findByStatusNotInStrings(@Param("statuses") Collection<String> statuses);
}

注意替换com.yourpackage.CustomStatus为你实际的自定义类型全限定名。

方法三：修复AttributeConverter配置 #

如果之前的AttributeConverter未生效，检查以下几点：

1. 确保Converter正确实现AttributeConverter<CustomStatus, String>，并配置转换逻辑：

@Converter(autoApply = true) // autoApply=true会自动应用到所有CustomStatus类型的属性
public class CustomStatusConverter implements AttributeConverter<CustomStatus, String> {
    @Override
    public String convertToDatabaseColumn(CustomStatus status) {
        return status != null ? status.name() : null;
    }

    @Override
    public CustomStatus convertToEntityAttribute(String dbValue) {
        return dbValue != null ? CustomStatus.valueOf(dbValue) : null;
    }
}

2. 实体类中不要同时混用@Type和@Convert注解，Hibernate 6中两者可能冲突，移除旧的@Type注解：

@Entity
public class BaseEntity {
    // 若未设置autoApply=true，需单独标注@Convert
    @Convert(converter = CustomStatusConverter.class)
    private CustomStatus status;
    // 其他属性
}

方法四：注册Hibernate 6自定义类型（替代旧@Type） #

如果你之前使用自定义UserType，需适配Hibernate 6的新接口：

1. 实现Hibernate 6的org.hibernate.usertype.UserType接口，确保类型转换逻辑正确；
2. 通过@TypeDef注册自定义类型：

@TypeDef(name = "customStatus", typeClass = CustomStatusUserType.class)
@Entity
public class BaseEntity {
    @Type(type = "customStatus")
    private CustomStatus status;
}

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