Hibernate映射异常：本地正常但K8s Pod中实体未映射

你的判断完全正确，这个错误和数据库连接无关——如果是连接问题，会抛出连接超时、认证失败或数据库不可达类的异常，而非实体未映射的错误。

本地正常但K8s Pod中出现实体未映射，核心原因是Hibernate在K8s环境下没有正确扫描到实体类，以下是具体排查方向：

1. 实体扫描配置检查 #

• 若使用Spring Boot，确认启动类上的@EntityScan注解是否指定了实体类所在的包路径，比如@EntityScan("com.yourproject.model")。本地IDE可能会自动识别实体，但打包部署时必须显式配置扫描路径。
• 若使用原生Hibernate，检查persistence.xml：
  • 是否添加了所有实体类的<class>标签，比如<class>com.yourproject.model.User</class>；
  • 是否设置了<exclude-unlisted-classes>false</exclude-unlisted-classes>，允许Hibernate自动检测未显式声明的实体类。

2. 打包完整性验证 #

• 进入K8s Pod检查应用包内容：

  kubectl exec -it <你的Pod名称> -- bash
  jar tf <你的应用jar包名>.jar | grep User.class
  

  如果没有输出，说明实体类未被正确打包到应用中。此时需要检查Maven/Gradle的打包配置，确保实体类所在的源码目录被纳入编译和打包范围。

3. 环境配置一致性检查 #

• 对比本地和K8s环境的Hibernate配置：
  • 确认hibernate.archive.autodetection参数是否设置为class,hbm，确保Hibernate能自动检测实体类和映射文件；
  • 检查spring.jpa.hibernate.ddl-auto（Spring Boot）或hibernate.hbm2ddl.auto（原生Hibernate）的配置值，K8s环境下的配置是否意外禁用了实体类的加载逻辑。

4. 依赖冲突排查 #

• 检查应用的依赖树，确认是否存在多版本Hibernate依赖冲突：
  • Maven：mvn dependency:tree
  • Gradle：gradle dependencies
    冲突的依赖可能导致K8s环境下类加载异常，无法识别实体类注解。

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