启动Spring Boot项目时为何出现‘Not a managed type’错误？

以下是针对该问题的排查和解决步骤，按优先级尝试：

• 直接指定实体类扫描，避免路径歧义
  放弃依赖包路径配置，在项目A的启动类上用@EntityScan的basePackageClasses参数直接指定目标实体类，彻底规避路径拼写、层级漏扫的问题：

  @SpringBootApplication
  @EntityScan(basePackageClasses = {x.y.z.YourLocalEntity.class, a.b.c.models.MyEntity.class})
  @ComponentScan(basePackages = {"x.y.z", "a.b.c"})
  public class ApplicationA {
      public static void main(String[] args) {
          SpringApplication.run(ApplicationA.class, args);
      }
  }
  

• 验证项目B的打包完整性
  直接解压项目B生成的jar包，检查是否存在a/b/c/models/MyEntity.class文件。若缺失，排查B的构建配置：

  • Maven：检查pom.xml的build节点，确认没有在resources或插件配置中排除实体类路径；
  • Gradle：检查sourceSets.main.java的includes/excludes规则，确保实体类被纳入打包范围。

• 核对JPA注解的版本兼容性
  确认项目A和B的JPA注解包完全一致：

  • 若A用Spring Boot 3.x+，则注解应为jakarta.persistence.Entity；若B仍使用旧版javax.persistence.Entity，需将B的JPA依赖升级到Jakarta版本，否则注解无法被识别。

• 检查自定义EntityManagerFactory的覆盖问题
  如果项目A中手动配置了LocalContainerEntityManagerFactoryBean，必须显式设置packagesToScan参数，否则@EntityScan的配置会被覆盖：

  @Bean
  public LocalContainerEntityManagerFactoryBean entityManagerFactory(EntityManagerFactoryBuilder builder) {
      return builder
              .dataSource(dataSource())
              .packages("x.y.z", "a.b.c.models") // 必须包含B的实体所在包
              .persistenceUnit("default")
              .build();
  }
  

• 排查依赖版本冲突
  用依赖分析工具确认项目A仅引入了正确版本的B：

  • Maven：执行mvn dependency:tree，搜索a.b.c相关依赖，排除重复或旧版本的B；
  • Gradle：执行gradle dependencies，查看依赖树，移除冲突的依赖项。

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