Spring Boot中如何用JPQL实现带条件LEFT JOIN并保留空关联？

DevOps 小满

2026-7-7

解决方案：用JPQL实现需求

完全可以用JPQL实现你的需求，以下是几种可行方案：

方案1：JPQL LEFT JOIN FETCH + ON子句（推荐）

利用JPA 2.1及以上支持的ON子句，结合实体间的关联关系过滤关联集合，同时保证无匹配Resolution时返回空列表：

SELECT rl FROM ResolutionList rl
LEFT JOIN FETCH rl.resolutions r
ON r.publish = true
WHERE rl.userId = ?1 AND rl.publish = true

关键说明：

必须关联实体中定义的resolutions集合（rl.resolutions），而非直接JOIN Resolution r，这样才能将过滤条件绑定到当前ResolutionList的关联对象上。
LEFT JOIN FETCH会一次性加载符合条件的关联Resolution，避免N+1查询问题；ON r.publish = true确保只加载publish=true的Resolution，无匹配时resolutions集合为空。

方案2：实体类添加固定过滤条件

如果你的业务始终只需要加载publish=true的Resolution，可以直接在实体的关联字段上添加@Where注解：

修改ResolutionList类的resolutions字段：

@OneToMany(mappedBy = "resolutionList", cascade = CascadeType.ALL)
@Where(clause = "publish = true")
private List<Resolution> resolutions;

此时查询JPQL简化为：

SELECT rl FROM ResolutionList rl
WHERE rl.userId = ?1 AND rl.publish = true

注意：

该方案的过滤条件是全局固定的，若后续需要查询包含未发布Resolution的场景会受限，适合需求固定的场景。

方案3：修复原生查询的别名冲突问题

如果你坚持使用原生SQL，只需为重复列名指定别名即可解决冲突：

SELECT 
    rl.id AS rl_id, 
    rl.user_id, 
    rl.publish AS rl_publish, 
    r.id AS r_id, 
    r.publish AS r_publish
FROM resolution_list rl 
LEFT JOIN resolution r ON r.resolution_list_id=rl.id AND r.publish = true 
WHERE rl.user_id=?1 AND rl.publish=true

你可以通过@SqlResultSetMapping将结果映射到实体或自定义DTO中，避免字段别名冲突。