HQL查询中带嵌套Join的WHERE子句不生效问题排查及非原生查询解决方案咨询

你的测试失败核心原因是JPA的查询筛选逻辑和实体关联加载行为的差异：

当你执行SELECT e FROM Event e JOIN e.sessions s JOIN s.sessionHistory sh WHERE sh.status = 'SALE'时，这条SQL的作用仅仅是筛选出「存在至少一个状态为'SALE'的SessionHistory」的Event，但它并不会修改Event关联的Session集合，也不会过滤Session关联的SessionHistory集合。

由于Session和SessionHistory之间是FetchType.LAZY关联，当你访问event.getSessions().getSessionHistory()时，JPA会触发额外的懒加载SQL，查询该Session的所有SessionHistory记录（包括状态为'SOON'的那条），所以最终集合大小是2，和预期的1不符。

下面提供几种不同场景下的可行方案，从简单到高级：

方案1：JOIN FETCH + ON子句过滤（JPA 2.1+ 推荐） #

直接在JPQL中使用JOIN FETCH加载关联数据，同时通过ON子句过滤SessionHistory的状态，让JPA在一次查询中就加载符合条件的关联内容，避免后续懒加载：

@Repository
public interface EventRepo extends JpaRepository<Event, UUID> {
    // 保留原有方法...

    @Query("SELECT e FROM Event e " +
            "JOIN FETCH e.sessions s " +
            "JOIN FETCH s.sessionHistory sh ON sh.status = 'SALE' " +
            "WHERE EXISTS (" +
                "SELECT 1 FROM SessionHistory sh2 " +
                "WHERE sh2.session.id = s.id AND sh2.status = 'SALE'" +
            ")")
    List<Event> findAllBy();
}

• ON sh.status = 'SALE'：直接过滤Session的sessionHistory集合，只加载状态为'SALE'的记录
• WHERE EXISTS：确保只返回确实包含符合条件SessionHistory的Event，避免出现空Session集合的情况

方案2：JPA过滤器（@Filter） #

通过@Filter定义全局的关联过滤规则，在需要的时候启用，适合需要多次复用过滤逻辑的场景：

1. 在Session类的sessionHistory关联上添加过滤器：

@Data
@Entity
@Builder
@NoArgsConstructor
@AllArgsConstructor
@Table(name = "session")
@FieldDefaults(level = AccessLevel.PRIVATE)
public class Session {
    // 保留原有字段...

    @OneToMany(cascade = CascadeType.ALL, fetch = FetchType.LAZY)
    @JoinColumn(name = "session_id")
    @Filter(name = "statusFilter", condition = "status = :status")
    Set<SessionHistory> sessionHistory;
}

2. 在业务逻辑中启用过滤器（需要获取EntityManager）：

// 注入EntityManager
@Autowired
private EntityManager entityManager;

// 查询前启用过滤器
Session hibernateSession = entityManager.unwrap(Session.class);
hibernateSession.enableFilter("statusFilter")
               .setParameter("status", Status.SALE);

Optional<Event> event = eventRepo.findAllBy().stream().findAny();

// 可选：查询完成后关闭过滤器
hibernateSession.disableFilter("statusFilter");

这样懒加载Session的sessionHistory时，Hibernate会自动应用过滤器，只返回状态为'SALE'的记录。

方案3：DTO投影（纯查询场景推荐） #

如果不需要修改实体，只是需要查询展示数据，使用DTO投影可以完全规避JPA实体关联的加载问题，精确控制返回内容：

1. 创建对应DTO类：

// EventDTO
@Data
@AllArgsConstructor
public class EventDTO {
    private UUID id;
    private String name;
    private Set<SessionDTO> sessions;
}

// SessionDTO
@Data
@AllArgsConstructor
public class SessionDTO {
    private UUID id;
    private Set<SessionHistoryDTO> sessionHistory;
}

// SessionHistoryDTO
@Data
@AllArgsConstructor
public class SessionHistoryDTO {
    private UUID id;
    private Status status;
}

2. 修改Repository方法返回DTO：

@Repository
public interface EventRepo extends JpaRepository<Event, UUID> {
    // 保留原有方法...

    @Query("SELECT new com.yourpackage.EventDTO(e.id, e.name, " +
            "new com.yourpackage.SessionDTO(s.id, " +
            "new com.yourpackage.SessionHistoryDTO(sh.id, sh.status))) " +
            "FROM Event e JOIN e.sessions s JOIN s.sessionHistory sh WHERE sh.status = 'SALE'")
    List<EventDTO> findAllBy();
}

返回的DTO中只会包含状态为'SALE'的SessionHistory，完全符合测试预期。

方案4：EntityGraph（高级关联加载控制） #

如果你需要更灵活的关联加载策略，可以结合@EntityGraph和过滤条件使用：

1. 在Event实体上定义EntityGraph：

@Entity
@NamedEntityGraph(
    name = "Event.withFilteredSessionHistory",
    attributeNodes = {
        @NamedAttributeNode(value = "sessions", subgraph = "sessions.withFilteredHistory")
    },
    subgraphs = {
        @NamedSubgraph(
            name = "sessions.withFilteredHistory",
            attributeNodes = @NamedAttributeNode("sessionHistory")
        )
    }
)
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
@Table(name = "event")
@FieldDefaults(level = AccessLevel.PRIVATE)
public class Event {
    // 保留原有字段...
}

2. 修改Repository方法使用EntityGraph：

@Repository
public interface EventRepo extends JpaRepository<Event, UUID> {
    // 保留原有方法...

    @EntityGraph(value = "Event.withFilteredSessionHistory", type = EntityGraph.EntityGraphType.FETCH)
    @Query("SELECT e FROM Event e " +
            "JOIN e.sessions s " +
            "JOIN s.sessionHistory sh ON sh.status = 'SALE'")
    List<Event> findAllBy();
}

注意：EntityGraph本身只负责关联加载，仍需要配合ON子句来过滤集合内容，才能达到预期效果。

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