Hibernate 5 Criteria一对多关联查询结果不符问题求助

你现在碰到的是Hibernate一对多关联查询里的典型问题——虽然你的代码成功筛选出了包含名为John的学生的学校，但访问学校的学生列表时，还是拿到了该学校的所有学生，而不是仅John一个。

问题根源 #

你的查询逻辑只是通过Student的name条件筛选出符合要求的School，但这里的root.join()只是用来构建查询条件的关联关系，并没有改变Hibernate加载关联集合的方式。默认情况下，Hibernate会按照实体映射的配置（懒加载/急加载）来加载完整的Student集合，不会自动把查询条件应用到关联集合的加载上。

解决方案 #

这里给你三种可行的解决思路，你可以根据自己的场景选择：

方案1：使用Fetch Join + 条件过滤（最直接推荐）

你需要用fetch()替代join()，它会告诉Hibernate在加载School的同时，只加载符合条件的Student对象，同时配合distinct避免重复的School实例：

CriteriaBuilder builder = session.getCriteriaBuilder();
CriteriaQuery<SchoolTO> cquery = builder.createQuery(SchoolTO.class);
Root<SchoolTO> root = cquery.from(SchoolTO.class);

// 使用fetch join加载关联的studentList，同时添加过滤条件
Fetch<SchoolTO, StudentTO> fetch = root.fetch(SchoolTO_.studentList, JoinType.INNER);
cquery.select(root);
cquery.where(builder.equal(fetch.get(StudentTO_.name), "john"));
cquery.distinct(true);

List<SchoolTO> list = session.createQuery(cquery).getResultList();

这样执行后，每个返回的School对象里的studentList就只会包含名字是John的学生了。

方案2：使用@Filter注解实现全局过滤

如果你的系统中多个地方都需要过滤特定条件的Student，可以在实体上定义过滤器：

1. 先在Student实体类上添加过滤器定义：

@Entity
@FilterDef(name = "studentNameFilter", parameters = @ParamDef(name = "name", type = String.class))
@Filter(name = "studentNameFilter", condition = "name = :name")
public class Student {
    private School school;
    // 其他字段、getter/setter
}

2. 在查询时启用这个过滤器：

// 启用过滤器并设置参数
session.enableFilter("studentNameFilter").setParameter("name", "john");

// 执行你原来的查询逻辑
CriteriaBuilder builder = session.getCriteriaBuilder();
CriteriaQuery<SchoolTO> cquery = builder.createQuery(SchoolTO.class);
Root<SchoolTO> root = cquery.from(SchoolTO.class);
Join<SchoolTO, StudentTO> join = root.join(SchoolTO_.studentList);
cquery.select(root);
cquery.where(builder.equal(join.get(StudentTO_.name), "john"));
cquery.distinct(true);

List<SchoolTO> list = session.createQuery(cquery).getResultList();

// 记得用完后关闭过滤器（可选，会话结束会自动关闭）
session.disableFilter("studentNameFilter");

这种方式适合需要重复使用相同过滤规则的场景，属于全局级别的过滤。

方案3：投影查询返回DTO

如果不需要完整的School实体，只需要School的核心信息和匹配的John，可以构造一个DTO来接收结果：

1. 先定义DTO类：

public class SchoolWithJohnDTO {
    private Long schoolId;
    private String schoolName;
    private StudentTO johnStudent;

    // 构造方法要和查询中投影的字段顺序一致
    public SchoolWithJohnDTO(Long schoolId, String schoolName, StudentTO johnStudent) {
        this.schoolId = schoolId;
        this.schoolName = schoolName;
        this.johnStudent = johnStudent;
    }

    // getter/setter
}

2. 构造投影查询：

CriteriaBuilder builder = session.getCriteriaBuilder();
CriteriaQuery<SchoolWithJohnDTO> cquery = builder.createQuery(SchoolWithJohnDTO.class);
Root<SchoolTO> root = cquery.from(SchoolTO.class);
Join<SchoolTO, StudentTO> join = root.join(SchoolTO_.studentList);

// 构造DTO实例，指定投影字段
cquery.select(builder.construct(SchoolWithJohnDTO.class,
        root.get(SchoolTO_.id),
        root.get(SchoolTO_.name),
        join));
cquery.where(builder.equal(join.get(StudentTO_.name), "john"));

List<SchoolWithJohnDTO> list = session.createQuery(cquery).getResultList();

这种方式直接返回你需要的数据，避免了实体集合加载的问题，适合只需要部分数据的场景。

内容的提问来源于stack exchange，提问作者Santosh Balaji Selvaraj