在 jpa 继承映射（joined 策略）中，jpql 无法直接调用抽象父类的抽象方法（如 `getvalue()`）来跨子表检索具体字段值；必须显式针对各子实体编写独立查询，或改用类型安全的 criteria api + union 模拟。
当使用 @Inheritance(strategy = InheritanceType.JOINED) 映射多态实体时（如 Master 抽象基类及其子类 StringFieldValue、BooleanFieldValue），数据库物理上分散为多个表（如 FIELDS_MASTER、FIELDS_STRING、FIELDS_BOOLEAN），而 JPQL 是面向实体对象模型而非底层表结构的语言。这意味着：
- ✅ JPQL 支持按父类类型查询（如 SELECT m FROM Master m WHERE m.document = :doc），此时 Hibernate 自动执行 JOIN 并根据 DTYPE 或主键关联推断具体子类型；
- ❌ 但 JPQL 不支持在 WHERE 子句中调用抽象方法（如 m.getValue()），因为该方法无对应 SQL 列，且各子类 value 字段实际存储在不同表、不同列名（如 FIELDS_STRING.value vs FIELDS_BOOLEAN.value），JPA 无法生成合法的跨表统一谓词。
因此，以下写法非法且会编译/运行失败：
// 错误示例：getValue() 是 Java 方法，非 JPQL 可识别属性
@Query("SELECT m FROM Master m WHERE m.getValue() = :searchTerm")
List<Master> findByValue(@Param("searchTerm") String searchTerm);✅ 正确实践方案
方案一：按子实体分别查询（推荐用于明确类型场景）
若业务可接受按字段类型分发查询，直接面向具体子类编写 JPQL：
@Repository
public interface FieldValueRepository extends JpaRepository<Master, String> {
// 查询字符串型字段
@Query("SELECT s FROM StringFieldValue s WHERE s.value = :searchTerm")
List<StringFieldValue> findStringByValue(@Param("searchTerm") String searchTerm);
// 查询布尔型字段（注意：原问题中 BooleanFieldValue 的 value 类型为 LocalDate —— 显然是笔误，应为 Boolean）
@Query("SELECT b FROM BooleanFieldValue b WHERE b.value = :searchTerm")
List<BooleanFieldValue> findBooleanByValue(@Param("searchTerm") Boolean searchTerm);
// 若需统一返回，可手动合并结果（注意类型转换与泛型擦除）
default List<Master> findAllByValue(Object searchTerm) {
List<Master> result = new ArrayList<>();
if (searchTerm instanceof String) {
result.addAll(findStringByValue((String) searchTerm));
// 若需匹配布尔字符串 "true"/"false"，可额外解析后查 BooleanFieldValue
Boolean boolVal = parseBooleanString((String) searchTerm);
if (boolVal != null) {
result.addAll(findBooleanByValue(boolVal));
}
} else if (searchTerm instanceof Boolean) {
result.addAll(findBooleanByValue((Boolean) searchTerm));
}
return result;
}
private Boolean parseBooleanString(String str) {
return "true".equalsIgnoreCase(str) ? true :
"false".equalsIgnoreCase(str) ? false : null;
}
}⚠️ 注意事项： 原问题中 BooleanFieldValue 的 value 字段声明为 LocalDate，但 setValue() 却解析 Boolean.valueOf(...) —— 这是严重类型不一致，必须修正为 private Boolean value;，否则运行时抛 ClassCastException。 所有子类的 @Table 名称需与实体类名严格对应（如 @Table(name = "FIELDS_STRING") 对应 StringFieldValue），且 @PrimaryKeyJoinColumn 的 name 必须与父表主键列名一致（通常为 "id"）。
方案二：使用 Criteria API 实现类型安全的联合查询（高级适用）
若需真正“一次查询所有子类型中 value 匹配的记录”，可借助 CriteriaBuilder.unionAll() 模拟 SQL UNION（需 Hibernate 5.4+）：
public List<Master> findByValueUnion(Object searchTerm) {
CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<Master> query = cb.createQuery(Master.class);
Root<StringFieldValue> stringRoot = query.from(StringFieldValue.class);
Root<BooleanFieldValue> boolRoot = query.from(BooleanFieldValue.class);
// 构建各子类查询分支
CriteriaQuery<Master> stringQuery = cb.createQuery(Master.class);
stringQuery.select(stringRoot).where(cb.equal(stringRoot.get("value"), searchTerm));
CriteriaQuery<Master> boolQuery = cb.createQuery(Master.class);
boolQuery.select(boolRoot).where(cb.equal(boolRoot.get("value"), searchTerm));
// 合并（注意：unionAll 要求 SELECT 列完全一致，此处均为 Master 类型，可行）
query = cb.createQuery(Master.class);
query.unionAll(stringQuery, boolQuery);
return entityManager.createQuery(query).getResultList();
}? 提示：此方式灵活性高，但需确保所有参与 UNION 的子类查询返回相同实体类型，并注意性能（全表扫描风险）。
总结
JPQL 的本质是面向对象的查询语言，其能力边界由 JPA 规范和 Hibernate 实现共同决定。对于 JOINED 继承中分散在子表的字段，不存在“透明跨表查询 value”的捷径。开发者必须：
- 优先采用按子类型分治查询，清晰、高效、易维护；
- 在必须统一入口时，通过服务层聚合结果，或升级至 Criteria API 实现 UNION；
- 严格校验继承结构的类型一致性（如 BooleanFieldValue.value 必须是 Boolean）；
- 避免在 JPQL 中引用 Java 方法——只操作实体属性（s.value），而非行为（s.getValue()）。
这一约束并非缺陷，而是 ORM 抽象与关系数据库范式之间必要张力的体现。
