通过Hibernate Criteria按InsurerId查询StateEntity报错求助

咱们先拆解下你遇到的两个错误原因，再给出正确的实现方案：

错误原因分析 #

1. IllegalArgumentException：参数值[74]与预期类型InsurerEntity不匹配
   你之前应该是直接写了类似Restrictions.eq("insurer", "74")的代码——insurer字段是InsurerEntity类型，不是字符串ID，Hibernate自然会报错类型不匹配，不能直接把字符串赋值给实体对象属性。

2. ClassCastException：SqlNode无法转换为FromReferenceNode
   这个错误一般是因为你在关联实体的时候写法有误，比如错误地构造了关联路径，或者使用了不符合Hibernate解析规则的关联方式，导致SQL生成时节点解析失败。

正确的Hibernate Criteria实现方案 #

下面提供两种可行的写法，适配不同的Hibernate版本：

1. 传统Criteria API（适用于Hibernate 5.2之前的版本）

你可以通过关联实体的属性路径或者创建别名的方式来匹配Insurer的ID：

方式一：使用属性路径直接匹配

Session session = sessionFactory.getCurrentSession();
Criteria criteria = session.createCriteria(StateEntity.class);

// 通过关联属性路径指定Insurer的主键条件
criteria.add(Restrictions.eq("insurer.insurerId", "74"));
// 只投影查询StateName字段，避免加载整个实体
criteria.setProjection(Projections.property("stateName"));

// 执行查询获取结果
List<String> stateNames = criteria.list();

方式二：创建实体别名关联查询

Session session = sessionFactory.getCurrentSession();
Criteria criteria = session.createCriteria(StateEntity.class);

// 给InsurerEntity创建别名"i"，方便后续条件查询
criteria.createAlias("insurer", "i");
// 通过别名指定主键条件
criteria.add(Restrictions.eq("i.insurerId", "74"));
// 投影查询StateName
criteria.setProjection(Projections.property("stateName"));

List<String> stateNames = criteria.list();

2. 推荐使用的CriteriaBuilder API（Hibernate 5.2+ 官方推荐）

传统Criteria API已经被标记为废弃，官方更推荐使用CriteriaBuilder和CriteriaQuery：

Session session = sessionFactory.getCurrentSession();
CriteriaBuilder cb = session.getCriteriaBuilder();

// 创建返回类型为String的查询（因为我们只查StateName）
CriteriaQuery<String> cq = cb.createQuery(String.class);
Root<StateEntity> stateRoot = cq.from(StateEntity.class);

// 选择StateName字段，添加InsurerId匹配条件
cq.select(stateRoot.get("stateName"))
  .where(cb.equal(stateRoot.get("insurer").get("insurerId"), "74"));

// 执行查询
List<String> stateNames = session.createQuery(cq).getResultList();

关键注意点 #

• 一定要通过insurer.insurerId这种属性路径去关联查询，而不是直接把ID赋值给insurer实体字段；
• 如果使用投影查询（只查指定字段），记得用Projections.property（传统API）或者直接指定字段路径（CriteriaBuilder），避免加载不必要的实体数据，提升性能。

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