Hibernate为何不支持FULL OUTER JOIN？有无解决方案？

为什么Hibernate Criteria API不支持FULL JOIN？ #

• 数据库兼容性限制：不是所有主流数据库都支持全外连接，比如MySQL在8.0.19版本之前完全不支持该语法。Hibernate作为跨数据库的ORM框架，要保证API在多数数据库上都能正常运行，所以没有将FULL JOIN纳入标准Criteria API的支持范围，避免在不兼容的数据库上抛出异常。
• 实际需求占比低：全外连接的业务场景相对小众，绝大多数关联查询需求都能通过LEFT JOIN、RIGHT JOIN或者子查询组合实现，Hibernate团队在功能优先级上没有优先支持它。
• Criteria API设计定位：Criteria API的核心目标是构建跨数据库兼容的类型安全查询，而全外连接属于部分数据库特有的语法，不符合其“通用兼容”的设计初衷。

可行的解决方案 #

1. 用LEFT JOIN + RIGHT JOIN结合UNION实现

分别构建LEFT JOIN和RIGHT JOIN的查询，再通过UNION合并结果并去重，效果等同于全外连接。示例代码：

CriteriaBuilder cb = entityManager.getCriteriaBuilder();

// LEFT JOIN 查询
CriteriaQuery<ResultDto> leftQuery = cb.createQuery(ResultDto.class);
Root<EntityA> rootA = leftQuery.from(EntityA.class);
Join<EntityA, EntityB> leftJoin = rootA.join("entityB", JoinType.LEFT);
leftQuery.select(cb.construct(ResultDto.class, rootA.get("id"), leftJoin.get("name")));

// RIGHT JOIN 查询
CriteriaQuery<ResultDto> rightQuery = cb.createQuery(ResultDto.class);
Root<EntityB> rootB = rightQuery.from(EntityB.class);
Join<EntityB, EntityA> rightJoin = rootB.join("entityA", JoinType.RIGHT);
rightQuery.select(cb.construct(ResultDto.class, rightJoin.get("id"), rootB.get("name")));

// 合并两个查询
CriteriaQuery<ResultDto> fullJoinQuery = cb.createQuery(ResultDto.class);
fullJoinQuery.select(fullJoinQuery.from(ResultDto.class))
             .union(leftQuery, rightQuery);

List<ResultDto> results = entityManager.createQuery(fullJoinQuery).getResultList();

2. 直接使用原生SQL查询

如果你的目标数据库支持FULL JOIN（比如PostgreSQL、SQL Server、MySQL 8.0.19+），原生SQL是最直接的解决方案：

String sql = "SELECT a.id, b.name FROM entity_a a FULL JOIN entity_b b ON a.b_id = b.id";
List<Object[]> rawResults = entityManager.createNativeQuery(sql).getResultList();

// 映射到DTO
List<ResultDto> results = rawResults.stream()
    .map(arr -> new ResultDto((Long) arr[0], (String) arr[1]))
    .collect(Collectors.toList());

3. 使用HQL替代Criteria API

HQL支持FULL JOIN（前提是数据库本身支持），可以直接用HQL构建查询：

String hql = "SELECT new com.example.ResultDto(a.id, b.name) FROM EntityA a FULL JOIN a.entityB b";
List<ResultDto> results = entityManager.createQuery(hql, ResultDto.class).getResultList();

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