在Hibernate中获取单个int结果时遇实体未映射错误如何解决？

这个错误的核心原因很明确：你在HQL里直接用了数据库表名app_user，但HQL是面向实体类的查询语言，它认的是你的Java实体类名称，不是数据库里的表名。另外还存在参数绑定不匹配的问题，咱们一步步来改：

1. 确认实体类的映射关系 #

首先你得有一个对应app_user表的实体类，比如叫AppUser（通常是驼峰命名），并且这个类要正确配置Hibernate/JPA映射：

@Entity
@Table(name = "app_user") // 这里指定对应数据库表名
public class AppUser {
    @Id
    private Integer id;
    
    @Column(name = "sso_id") // 对应数据库的sso_id字段
    private String ssoId;
    
    // 其他字段、getter/setter省略
}

要确保这个实体类被Hibernate的扫描路径包含，比如在配置类里加了@EntityScan或者在hibernate.cfg.xml里声明了这个实体。

2. 修改HQL查询语句 #

把HQL里的表名换成实体类名，字段名换成实体类的属性名（注意是Java属性名，不是数据库列名）：
原来的错误HQL：

select id from app_user where sso_id=:name

修改后（假设实体类是AppUser，属性名是ssoId）：

select au.id from AppUser au where au.ssoId=:username

这里用了别名au让语句更清晰，参数名也改成了更语义化的username。

3. 修正参数绑定&结果处理 #

原来的代码里参数绑定用了sso_id，但HQL里的参数是:name，这完全不匹配，必须对应起来。另外getSingleResult()如果查不到数据会抛出NoResultException，最好捕获这个异常避免程序崩溃：
修改后的getDbId方法：

public Integer getDbId(String name){
    Session currentSession = sessionFactory.getCurrentSession();
    // 使用实体类名和属性名的HQL，指定泛型避免强制类型转换
    Query<Integer> theQuery = currentSession.createQuery(
        "select au.id from AppUser au where au.ssoId=:username", 
        Integer.class
    );
    // 参数名要和HQL里的:username严格对应
    theQuery.setParameter("username", name);
    
    try {
        // 获取单个结果
        return theQuery.getSingleResult();
    } catch (NoResultException e) {
        // 处理用户不存在的情况，比如返回null或者抛出自定义业务异常
        return null;
        // 或者 throw new UserNotFoundException("User with ssoId: " + name + " not found");
    }
}

额外提示 #

• 尽量用泛型Query<Integer>替代原生Query，这样不用强制类型转换，类型更安全。
• 永远记得处理getSingleResult()的异常，因为当没有匹配数据时Hibernate会抛出RuntimeException，不处理会直接导致请求失败。

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