HQL查询遇错：Application_Identity未映射问题求助

嗨，咱们来解决你遇到的这个HQL映射错误吧——这是个超常见的问题，我一步步给你说清楚哪里出问题了，该怎么修：

你遇到的错误 java.lang.IllegalArgumentException: org.hibernate.hql.internal.ast.QuerySyntaxException: Application_Identity is not mapped，本质是Hibernate找不到你在HQL中引用的实体类，要么是你的HQL语法写错了，要么是实体类没被正确配置到Hibernate的映射体系中。

1. 先修正你的HQL语句 #

你当前的HQL是 from Application_Identity(class name)，这明显有语法错误——括号里的 (class name) 是多余的，完全不符合HQL的语法规则。

正确的HQL应该直接引用实体类的类名：

from Application_Identity

如果需要给实体类起别名方便后续条件查询，也可以这么写：

from Application_Identity ai where ai.id = :userId

2. 确保实体类被Hibernate正确扫描/映射 #

Hibernate必须明确知道 Application_Identity 是一个实体类，才能在HQL中识别它，分两种配置场景处理：

场景1：使用hibernate.cfg.xml配置 #

打开你的 hibernate.cfg.xml 文件，确保里面添加了该实体类的映射配置，替换成你实际的包路径：

<mapping class="com.your.project.package.Application_Identity"/>

场景2：Spring/Spring Boot项目 #

• 如果是Spring Boot，检查你的主启动类是否添加了 @EntityScan 注解，指定实体类所在的包：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.domain.EntityScan;

@SpringBootApplication
@EntityScan(basePackages = "com.your.project.package") // 替换成你的实体包路径
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

• 如果是传统Spring项目，确保你的 applicationContext.xml 里配置了实体扫描，或者使用注解配置时开启了实体扫描功能。

3. 检查实体类的注解是否正确 #

确认你的 Application_Identity 类的注解没有问题：

• 确保 @Entity 注解导入的是正确的包：Hibernate 5及之前用 javax.persistence.Entity，Hibernate 6及以后用 jakarta.persistence.Entity（注意和你的Hibernate版本匹配）。
• 类名拼写完全和HQL中的一致——HQL对实体类名是区分大小写的，别写错大小写。

给你补全一个正确的实体类示例（基于你提供的代码片段）：

import java.io.Serializable;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.Id;

@SuppressWarnings("serial")
@Entity
public class Application_Identity implements Serializable {

    @Id
    @Column(name = "identity_id") // 这里是数据库表的字段名，根据你的实际情况修改
    private Long id;

    // 其他字段示例
    @Column(name = "username")
    private String username;

    // getter和setter方法
    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }
}

按照上面的步骤一步步排查：先改对HQL语法，再确认实体类被Hibernate正确映射，最后检查注解和类名匹配。这个问题基本就能解决了。

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