如何通过Hibernate Query仅获取实体的指定字段（含关联字段）？

刚接触Hibernate的话，这种只想加载实体部分字段的需求太常见了，我给你整理了几个实用的方案，你可以根据自己的场景选：

1. HQL/JPQL投影查询（返回Object数组） #

这是最直接的方式，直接在HQL里指定要查询的字段，不用加载整个实体。针对你的Foo实体，查询语句可以这么写：

SELECT f.id, f.bar, f.bar1, f.bar3 FROM Foo f
-- 如果bar是关联实体，需要确保关联被加载的话，加上JOIN FETCH避免懒加载
SELECT f.id, f.bar, f.bar1, f.bar3 FROM Foo f JOIN FETCH f.bar

执行这个查询后，你会得到一个List<Object[]>，数组里的元素顺序和你SELECT里的字段顺序完全对应——比如第一个元素是id，第二个是bar实体，以此类推。你可以手动遍历这些数组，取出需要的值。

2. 用自定义DTO接收结果（类型更安全） #

如果觉得处理Object数组麻烦，推荐你创建一个DTO类来接收查询结果，这样代码更清晰，也能避免类型转换错误。比如先写一个FooDTO：

public class FooDTO {
    private Long id;
    private Bar bar; // 对应Foo里的bar关联字段
    private String bar1; // 假设bar1是字符串类型
    private Integer bar3; // 假设bar3是整数类型

    // 注意：构造函数的参数顺序要和HQL里SELECT的字段顺序完全一致
    public FooDTO(Long id, Bar bar, String bar1, Integer bar3) {
        this.id = id;
        this.bar = bar;
        this.bar1 = bar1;
        this.bar3 = bar3;
    }

    // 可选：添加getter方法方便取值
}

然后用HQL的构造函数查询：

SELECT new com.yourpackage.FooDTO(f.id, f.bar, f.bar1, f.bar3) FROM Foo f

执行后直接得到List<FooDTO>，不用再手动处理数组，非常省心。

3. Criteria API投影查询（类型安全的编程式查询） #

如果你不喜欢写字符串形式的HQL，Hibernate的Criteria API可以帮你用代码构建查询，同样支持投影：

// 获取CriteriaBuilder实例
CriteriaBuilder cb = entityManager.getCriteriaBuilder();
// 定义查询返回Object数组类型
CriteriaQuery<Object[]> query = cb.createQuery(Object[].class);
Root<Foo> root = query.from(Foo.class);

// 指定要选择的字段
query.select(cb.array(
    root.get("id"),
    root.get("bar"),
    root.get("bar1"),
    root.get("bar3")
));

// 如果需要关联加载bar，显式添加join避免懒加载
root.join("bar", JoinType.INNER);

// 执行查询并获取结果
List<Object[]> results = entityManager.createQuery(query).getResultList();

当然你也可以用Criteria API返回DTO，逻辑和HQL构造函数查询类似，只是用代码来指定构造函数。

重要注意事项 #

• 如果你要加载的关联字段（比如bar）默认是懒加载的，一定要用JOIN FETCH或者显式join，不然后续访问bar的时候会触发额外的懒加载查询，导致N+1性能问题。
• 尽量不要尝试使用“部分加载的实体”（比如只加载部分字段的Foo对象），因为Hibernate需要维护实体的完整性，部分加载的实体可能会引发脏检查错误等意料之外的问题。所以优先用投影或者DTO的方式实现需求。

内容的提问来源于stack exchange，提问作者Keshav sardana