在 Hibernate 6（Spring Boot 3）中，将 CustomStatus 类型字段映射为数据库字符串后，直接在 JPQL 中用字符串字面量（如 'ARCHIVED'）比较会失败；需改用类型安全参数或调整映射策略。
在 hibernate 6（spring boot 3）中，将 `customstatus` 类型字段映射为数据库字符串后，直接在 jpql 中用字符串字面量（如 `'archived'`）比较会失败；需改用类型安全参数或调整映射策略。
Hibernate 6 对 JPQL 类型推导更加严格：当实体字段声明为 CustomStatus 类型并使用 @JavaType 或 @Convert 映射到 VARCHAR 时，JPQL 中的 status = 'ARCHIVED' 会被解析为 CustomStatus 实例与 String 字面量的跨类型比较，这违反了 Hibernate 的语义校验规则，从而抛出 Can't compare test expression of type [...] with element of type [basicType@4(java.lang.String,12)] 错误。
✅ 正确方案：使用类型化参数（推荐）
最简洁、类型安全且兼容 Hibernate 6 的方式是：在 JPQL 中始终传入 CustomStatus 实例作为参数，而非字符串字面量。例如：
@Repository
public interface BaseEntityRepository extends JpaRepository<BaseEntity, Integer> {
@Query("SELECT b FROM BaseEntity b WHERE b.status = :status")
List<BaseEntity> findByStatus(@Param("status") CustomStatus status);
@Query("SELECT b FROM BaseEntity b WHERE b.status NOT IN :statuses")
List<BaseEntity> findByStatusNotIn(@Param("statuses") List<CustomStatus> statuses);
// 封装常用查询（避免重复构造对象）
default List<BaseEntity> findArchived() {
return findByStatus(new CustomStatus("ARCHIVED"));
}
default List<BaseEntity> findActive() {
return findByStatusNotIn(List.of(
new CustomStatus("ARCHIVED"),
new CustomStatus("CANCELLED")
));
}
}⚠️ 注意：
@Query必须使用 JPQL（非原生 SQL），即SELECT b FROM BaseEntity b ...，而非SELECT * FROM base_entity ...—— 后者属于原生查询，无法利用 Hibernate 的类型转换机制。
? 替代方案：改用 @Embeddable + 属性路径访问
若希望保留字符串字面量语法（如 status.name = 'ARCHIVED'），可将 CustomStatus 改为嵌入式类：
@Embeddable
public class CustomStatus implements Serializable {
private String name; // 必须非 final，且提供无参构造器和 getter/setter
public CustomStatus() {}
public CustomStatus(String name) {
this.name = name;
}
public String getName() { return name; }
public void setName(String name) { this.name = name; }
}实体类中使用 @Embedded：
@Entity
@Table(name = "base_entity")
public class BaseEntity {
@Id
private Integer id;
@Embedded
private CustomStatus status;
// ...
}此时 JPQL 可直接按属性路径查询：
@Query("SELECT b FROM BaseEntity b WHERE b.status.name = 'ARCHIVED'")
List<BaseEntity> findArchivedByEmbeddedName();✅ 优势：语法直观，支持字符串字面量；
❌ 缺点：失去 CustomStatus 的封装语义（如行为方法、不可变性），且需暴露 name 的 setter。
❌ 不推荐：继续使用 @AttributeConverter + 字符串字面量
尽管 @Convert 在 Hibernate 6 中仍有效（用于读写转换），但它不改变 JPQL 中字段的逻辑类型——status 在 JPQL 中仍是 CustomStatus 类型，因此 status = 'ARCHIVED' 依然非法。试图绕过类型检查（如强制 cast）会导致编译失败或运行时异常。
✅ 最佳实践总结
| 场景 | 推荐做法 |
|---|---|
| ✅ 追求类型安全 & 可维护性 | 使用 @JavaType + 参数化 JPQL（如 :status） |
| ✅ 需要简单字符串匹配且接受结构妥协 | 使用 @Embeddable + b.status.name = 'XXX'
|
| ❌ 禁止操作 | 在 JPQL 中对自定义对象字段使用字符串字面量（如 status = 'ARCHIVED'） |
最后提醒：无论采用哪种方案，请确保 CustomStatus 正确实现 equals()/hashCode()（基于 name），以保障集合操作与二级缓存一致性。
