Hibernate：如何仅加载实体关联集合中实体的指定列（如ID）

这个需求完全可行，问题出在实体图的配置和查询提示的选择上。以下是具体分析和解决步骤：

问题分析 #

你当前的核心问题有两点：

1. 使用了jakarta.persistence.fetchgraph提示，它的规则是仅加载实体图中明确列出的属性——但你的实体图只指定了users关联属性，导致主User的非主键属性（如xpto、xpto2）会被懒加载；同时关联的users实体虽配置了subgraph，但如果后续代码不小心访问了它们的非id属性，会触发懒加载查询完整数据，看起来像是“完整加载”了关联实体。
2. 若你的目标是主User加载全部属性、仅关联users只加载id，fetchgraph并不适配这个场景，应该改用loadgraph提示，或者调整实体图包含主实体的所有属性。

解决方案 #

方案1：改用LoadGraph（推荐） #

loadgraph的行为是加载实体的所有默认属性（主键、非懒加载字段），同时加载实体图中指定的关联属性，且关联属性严格遵循subgraph的配置。

步骤1：修正实体图配置

无需修改主实体的属性定义，只需确保关联属性的subgraph正确指定id：

@Entity
@Table(name = "USERS")
@NamedEntityGraph(
        name = "User.withUsersIds",
        attributeNodes = {
                @NamedAttributeNode(value = "users", subgraph = "userIdOnly")
        },
        subgraphs = {
                @NamedSubgraph(name = "userIdOnly", attributeNodes = {
                        @NamedAttributeNode("id")
                })
        }
)
public class User {
    // 原有构造方法、属性、getter/setter保持不变
}

步骤2：修改查询代码，替换为loadgraph提示

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<User> cq = cb.createQuery(User.class);

EntityGraph<?> eg = entityManager.getEntityGraph("User.withUsersIds");

Root<User> root = cq.from(User.class);
Predicate predicate = cb.equal(root.get("id"), 1L);

cq.select(root).distinct(true).where(predicate);

TypedQuery<User> tq = entityManager.createQuery(cq);
// 关键：改用loadgraph提示
return tq.setHint("jakarta.persistence.loadgraph", eg).getSingleResult();

方案2：使用FetchGraph并包含主实体所有属性 #

如果坚持使用fetchgraph，需要在实体图中明确列出主User的所有需加载属性，避免它们被懒加载：

@NamedEntityGraph(
        name = "User.fullWithUsersIds",
        attributeNodes = {
                @NamedAttributeNode("id"),
                @NamedAttributeNode("xpto"),
                @NamedAttributeNode("xpto2"),
                @NamedAttributeNode(value = "users", subgraph = "userIdOnly")
        },
        subgraphs = {
                @NamedSubgraph(name = "userIdOnly", attributeNodes = {
                        @NamedAttributeNode("id")
                })
        }
)

查询时依然使用jakarta.persistence.fetchgraph提示即可。

关键注意事项 #

• 关联的users集合中的User对象是代理对象，只有id被初始化，其他属性未加载。如果后续代码调用了这些对象的getXpto()等方法，会触发懒加载，导致Hibernate去数据库查询完整数据，这是需要避免的。
• 若要彻底杜绝关联实体加载其他属性，可以使用投影查询直接返回只包含id的结构，这是更直接的方式：

  CriteriaBuilder cb = entityManager.getCriteriaBuilder();
  CriteriaQuery<Tuple> cq = cb.createTupleQuery();
  Root<User> root = cq.from(User.class);
  Join<User, User> usersJoin = root.join("users");
  
  cq.multiselect(
          root.get("id"), root.get("xpto"), root.get("xpto2"),
          usersJoin.get("id")
  ).where(cb.equal(root.get("id"), 1L)).distinct(true);
  
  List<Tuple> results = entityManager.createQuery(cq).getResultList();
  // 手动转换为业务需要的对象结构
  

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