Spring Boot 3.1.0升级至3.1.1后LEFT JOIN查询被错误替换为JOIN求助

针对你遇到的升级后LEFT JOIN被替换为INNER JOIN的问题，无需改写为原生SQL，有以下几种可行方案：

方案1：使用Criteria API构建查询 #

通过Criteria API可以明确指定关联的JOIN类型，避免Hibernate自动优化为INNER JOIN，同时支持动态分页和排序参数：

public Page<ApiKey> findApiKeys(UUID projectId, Pageable pageable) {
    return apiKeyRepository.findAll((root, query, cb) -> {
        // 明确指定LEFT JOIN关联role表
        root.join("role", JoinType.LEFT);
        return cb.equal(root.get("projectId"), projectId);
    }, pageable);
}

这种方式会严格按照你指定的JOIN类型生成SQL，即使排序涉及role.name字段，也不会转为INNER JOIN。

方案2：在JPQL中显式包含排序逻辑并移除Pageable中的排序参数 #

如果排序规则相对固定，可以将排序逻辑直接写在JPQL中，Pageable仅用于传递分页（页码、每页数量）参数：

@Query("""
    SELECT ak FROM ApiKey ak
    LEFT JOIN ak.role r
    WHERE ak.projectId = :projectId
    ORDER BY r.name NULLS FIRST
    """)
Page<ApiKey> find(@Param("projectId") UUID projectId, Pageable pageable);

调用时，创建仅包含分页信息的Pageable对象：

Pageable pageable = PageRequest.of(pageNum, pageSize);
apiKeyRepository.find(projectId, pageable);

若需要动态排序方向，可以通过JPQL的SpEL表达式实现：

@Query("""
    SELECT ak FROM ApiKey ak
    LEFT JOIN ak.role r
    WHERE ak.projectId = :projectId
    ORDER BY r.name :sortDirection
    """)
Page<ApiKey> find(@Param("projectId") UUID projectId, 
                  @Param("sortDirection") Sort.Direction sortDirection,
                  Pageable pageable);

方案3：强制保留LEFT JOIN语义（临时 workaround） #

在JPQL的WHERE子句中添加一个不影响业务逻辑的条件，强制Hibernate保留LEFT JOIN：

@Query("""
    SELECT ak FROM ApiKey ak
    LEFT JOIN ak.role r
    WHERE ak.projectId = :projectId
      AND (r.id IS NULL OR r.id IS NOT NULL)
    """)
Page<ApiKey> find(@Param("projectId") UUID projectId, Pageable pageable);

这个条件对查询结果无影响，但会让Hibernate意识到关联实体可能为null，从而保留LEFT JOIN。

额外检查 #

确认你的ApiKey实体中role关联的配置是否正确设置为可选：

@ManyToOne(optional = true)
@JoinColumn(name = "role_id")
private Role role;

optional=true是Hibernate识别可选关联的关键配置，若缺失可能导致JOIN类型被错误转换。

内容的提问来源于stack exchange，提问作者Sebastiaan van den Broek