如何使用CriteriaQuery API对ComponentType中的关联执行LEFT_JOIN操作

方案1：显式类型转换实现左连接 #

你遇到的报错是因为root.get()默认返回的SingularAttributePath类型没有公开join()方法，但@Embedded属性对应的路径本质上实现了From接口，强制类型转换后即可调用join方法，正确写法如下：

CriteriaBuilder builder = session.getCriteriaBuilder();
CriteriaQuery<Tuple> query = builder.createTupleQuery();
Root<ProductProviderDetail> root = query.from(ProductProviderDetail.class);

// 强转嵌入属性路径为From类型
From<ProductProviderDetail, AuditInformation> auditPath = (From) root.get("auditInformation");
// 执行左连接
Join<AuditInformation, Head> headJoin = auditPath.join("head", JoinType.LEFT);

query.multiselect(headJoin);

这种写法兼容JPA 2.1及以上所有实现版本，转换操作是符合JPA规范的安全操作。

方案2：使用静态元模型实现类型安全的查询 #

如果要避免硬编码属性名和强制类型转换，可以搭配JPA静态元模型生成器使用，写法更安全：

1. 首先引入对应持久层框架的静态元模型生成器（比如Hibernate的hibernate-jpamodelgen），编译时会自动生成带_后缀的元模型类
2. 调整查询代码如下：

CriteriaBuilder builder = session.getCriteriaBuilder();
CriteriaQuery<Tuple> query = builder.createTupleQuery();
Root<ProductProviderDetail> root = query.from(ProductProviderDetail.class);

// 直接基于元模型链式调用join，不需要强转，编译时就会校验属性合法性
Join<AuditInformation, Head> headJoin = root
        .get(ProductProviderDetail_.auditInformation)
        .join(AuditInformation_.head, JoinType.LEFT);

query.multiselect(headJoin);

补充说明 #

嵌入属性本身和主表字段映射在一起，所以不需要为嵌入属性单独加左连接，直接对嵌入属性内的关联属性做左连接即可，不会丢失主表数据。

内容的提问来源于stack exchange，提问作者Ngọc Hy