Hibernate JPA多对一映射查询数据报错问题排查

这个报错的核心原因是你的Criteria Query没有正确遍历到关联的UserEntity对象，而是直接从BaseEntity/GroupEntity的路径下去查找仅属于UserEntity的userCode属性，JPA自然找不到该属性。以下是具体排查和修复步骤：

1. 先确认实体关联的正确性 #

确保GroupEntity中与UserEntity的ManyToOne关联字段定义正确，示例如下：

@Entity
public class GroupEntity extends BaseEntity {
    // 正确定义ManyToOne关联，字段名比如为user
    @ManyToOne
    @JoinColumn(name = "user_id")
    private UserEntity user;
    // 其他业务字段
}

@Entity
public class UserEntity extends BaseEntity {
    // 目标字段userCode
    private String userCode;
    // 其他业务字段
}

2. 修复Criteria Query的路径错误 #

错误写法示例（导致报错） #

直接从GroupEntity的Root对象获取userCode，JPA会在GroupEntity及其父类BaseEntity中查找该属性：

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<GroupEntity> query = cb.createQuery(GroupEntity.class);
Root<GroupEntity> root = query.from(GroupEntity.class);
// 错误：root对应GroupEntity，无userCode属性
query.select(root.get("userCode"));

正确写法示例 #

需要先通过GroupEntity的关联字段join到UserEntity，再从UserEntity的路径获取userCode：

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
// 如果仅需查询userCode，返回类型设为String
CriteriaQuery<String> query = cb.createQuery(String.class);
Root<GroupEntity> groupRoot = query.from(GroupEntity.class);

// 1. 关联到UserEntity，参数是GroupEntity中定义的关联字段名（比如"user"）
Join<GroupEntity, UserEntity> userJoin = groupRoot.join("user");
// 2. 从UserEntity的路径获取userCode
query.select(userJoin.get("userCode"));

// 若需添加筛选条件，比如根据userCode过滤
query.where(cb.equal(userJoin.get("userCode"), "USER_001"));

List<String> userCodes = entityManager.createQuery(query).getResultList();

3. 进阶：使用元模型（Metamodel）避免字符串硬编码 #

为了避免手写字段名出错，可使用JPA元模型类（需提前生成），写法更安全：

// 假设生成的元模型类为GroupEntity_和UserEntity_
CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<String> query = cb.createQuery(String.class);
Root<GroupEntity> groupRoot = query.from(GroupEntity.class);

Join<GroupEntity, UserEntity> userJoin = groupRoot.join(GroupEntity_.user);
query.select(userJoin.get(UserEntity_.userCode));

4. 额外排查：继承策略问题 #

如果BaseEntity是标注了@Entity而非@MappedSuperclass，需确保继承策略（如TABLE_PER_CLASS、JOINED）配置正确，但这个报错大概率和路径错误无关，优先检查前面的步骤。

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