Spring Boot3.2+Java21下Hibernate报Not a managed type问题求助

常见原因及解决步骤 #

1. 实体类未被Spring Boot扫描到 #

• 检查启动类包路径：若启动类在hackdays2025.poweroutage包下，实体类在子包entity下，默认扫描逻辑是覆盖启动类所在包及子包，此时无需额外配置；若启动类在其他包，需手动指定扫描路径，在启动类添加注解：

  @EntityScan(basePackages = "hackdays2025.poweroutage.entity")
  

• 确认实体类Poweroutage上标注了@Entity注解，若指定表名，@Table注解的name属性需与数据库表名一致（大小写敏感需匹配数据库规则）。

2. Repository接口配置问题 #

• 检查Repository是否正确继承Spring Data JPA接口（如JpaRepository<Poweroutage, 主键类型>），且所在包被Spring扫描到。若Repository不在启动类扫描范围内，在启动类添加：

  @EnableJpaRepositories(basePackages = "hackdays2025.poweroutage.repository")
  

  替换为你的Repository实际包路径。

3. 自定义DataSourceConfig干扰 #

• 若自定义了DataSourceConfig，避免覆盖默认JPA配置导致实体扫描失效：
  • 若手动创建EntityManagerFactory，需在LocalContainerEntityManagerFactoryBean中设置实体扫描路径：

    @Bean
    public LocalContainerEntityManagerFactoryBean entityManagerFactory() {
        LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
        em.setDataSource(dataSource());
        em.setPackagesToScan("hackdays2025.poweroutage.entity"); // 新增此行指定实体包
        // 其他配置逻辑...
        return em;
    }
    

4. pom.xml依赖问题 #

• 确保引入正确的Spring Data JPA starter（避免单独引入Hibernate核心包，Spring Boot starter会管理兼容版本）：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
  

• 确认PostgreSQL驱动依赖正确：

  <dependency>
      <groupId>org.postgresql</groupId>
      <artifactId>postgresql</artifactId>
      <scope>runtime</scope>
  </dependency>
  

5. 类名或包路径拼写错误 #

• 核对错误信息中的全限定类名hackdays2025.poweroutage.entity.Poweroutage与实际类的包路径、类名是否完全一致，注意Java类名的大小写规则。

验证操作 #

1. 调整配置后重新执行mvn spring-boot:run。
2. 查看启动日志，确认是否出现类似HHH000220: Found class hackdays2025.poweroutage.entity.Poweroutage的日志，以此判断实体类是否被Hibernate正确加载。

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