Hibernate/JPA处理OneToOne关联时生成无效SQL查询问题

问题原因 #

升级到Spring 3.0后，配套的Hibernate版本（多为Hibernate 6.x）调整了JPQL解析逻辑。原查询中通过t.taskLocation.vineyard.id这种嵌套关联路径手动关联Vineyard时，Hibernate 6.x会优先解析最外层的Vineyard并提前生成JOIN语句，但此时作为中间表的vin_task_location还未被关联，导致SQL中出现引用未定义表别名t4_0的错误。而Spring 2.x对应的Hibernate 5.x会按关联路径的层级顺序生成JOIN，因此未出现该问题。

解决方案 #

方案1：显式JOIN所有中间关联表 #

修改JPQL查询，先显式关联TaskLocation，再通过它关联Vineyard，强制Hibernate按正确顺序生成SQL：

@Query("select distinct t from Task t " +
        "join TaskEventLog tel on tel.task.id = t.id " +
        "join t.taskLocation tl " + // 显式关联TaskLocation
        "join tl.vineyard v "       // 通过TaskLocation关联Vineyard
        "where v.id in :vineyardIds " +
        "and tel.timestamp >= :startDate " +
        "and tel.timestamp <= :endDate " +
        "and t.status <> app.vinitor.server.task.evenStatus.EventStatus.DRAFT " +
        "and tel.deleted=0 " +
        "and t.deleted=0 " +
        "order by t.plannedStartDate, t.priority")
List<Task> getByVineyardsAndEventLogTimeframe(List<UUID> vineyardIds, @Param("startDate") LocalDateTime startDate, @Param("endDate") LocalDateTime endDate);

方案2：移除手动JOIN，直接通过关联路径过滤 #

利用实体间已定义的关联关系，直接在WHERE条件中使用嵌套路径过滤，让Hibernate自动处理JOIN顺序：

@Query("select distinct t from Task t " +
        "join TaskEventLog tel on tel.task.id = t.id " +
        "where t.taskLocation.vineyard.id in :vineyardIds " + // 直接用关联路径过滤
        "and tel.timestamp >= :startDate " +
        "and tel.timestamp <= :endDate " +
        "and t.status <> app.vinitor.server.task.evenStatus.EventStatus.DRAFT " +
        "and tel.deleted=0 " +
        "and t.deleted=0 " +
        "order by t.plannedStartDate, t.priority")
List<Task> getByVineyardsAndEventLogTimeframe(List<UUID> vineyardIds, @Param("startDate") LocalDateTime startDate, @Param("endDate") LocalDateTime endDate);

方案3：升级Hibernate到修复该问题的版本 #

Hibernate 6.x早期版本存在此类关联路径解析BUG，可尝试升级到Hibernate 6.1.x及以上的稳定版本，官方已修复JOIN顺序生成的相关问题。

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