AWS环境下Hibernate 5报错：org.hibernate.MappingException（未知实体）

我帮你分析下这个问题——你把原本适配MySQL的Lambda-RDS代码改成PostgreSQL后遇到的这个MappingException，核心原因就是Hibernate没法识别并加载org.sample.serverless.aws.rds.Employee这个实体类。结合PostgreSQL的特性和Hibernate的工作机制，给你几个具体的排查和修复方向：

1. 先检查实体类的基础注解配置 #

• 确保Employee类上必须有@Entity注解，这是Hibernate识别实体的核心标记
• 注意PostgreSQL的表名默认是小写的！如果原来MySQL的表名是驼峰或大写（比如Employee），记得把@Table注解的名称改成小写，比如@Table(name = "employee")，避免Hibernate找不到对应的表而触发映射错误
• 主键字段的生成策略要适配PostgreSQL：别再用MySQL的AUTO_INCREMENT对应的策略，换成@GeneratedValue(strategy = GenerationType.IDENTITY)，或者如果用序列的话，配置@SequenceGenerator配合使用

2. 确认Hibernate能扫描到你的实体类 #

• 如果用的是hibernate.cfg.xml配置文件，一定要在里面加上实体映射项：

  <mapping class="org.sample.serverless.aws.rds.Employee"/>
  

• 如果项目用到了Spring Boot，检查主启动类上有没有@EntityScan(basePackages = "org.sample.serverless.aws.rds")注解——没有的话Spring没法自动扫描到这个包下的实体类
• 排查Lambda的部署包：解压后看看Employee.class是不是在org/sample/serverless/aws/rds/这个路径下，有时候打包工具会不小心遗漏实体类文件

3. 必须切换Hibernate的方言配置 #

从MySQL改成PostgreSQL，一定要把Hibernate的方言换成PostgreSQL对应的，比如在配置文件里设置：

hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

如果是较新版本的PostgreSQL，也可以用更具体的方言比如PostgreSQL15Dialect，错误的方言会导致Hibernate无法正确解析实体映射规则

4. 检查SessionFactory的初始化逻辑 #

如果是编程式创建SessionFactory，确保你已经把Employee类添加到配置中了，比如：

Configuration config = new Configuration();
config.configure();
// 手动添加实体类，避免遗漏
config.addAnnotatedClass(Employee.class);
SessionFactory sessionFactory = config.buildSessionFactory();

要是这里漏加了实体类，Hibernate肯定识别不到它

你遇到的错误信息：
{
"errorMessage": "Unknown entity: org.sample.serverless.aws.rds.Employee",
"errorType": "org.hibernate.MappingException",
"stackTrace": [
"org.hibernate.metamodel.internal.MetamodelImpl.entityPersister(MetamodelImpl.java:620)",
"org.hibernate.internal.SessionImpl.getEntityPersister(SessionImpl.jav..."
]
}

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