Spring使用@EntityScan为何会禁用默认自动实体发现机制

问题根因 #

这是Spring Boot JPA自动配置的设计规则，并非bug：

• 当项目中没有任何显式声明的@EntityScan或@EnableJpaRepositories注解时，Spring Boot会自动扫描主启动类所在包及其子包下的所有实体类、JPA Repository接口，也就是你提到的「全局自动实体/Repo发现」。
• 一旦Spring上下文里出现任意一个显式的@EntityScan或@EnableJpaRepositories注解（不管这个注解是定义在当前项目的类里，还是引入的依赖包的配置类里），Spring Boot就会完全关闭默认的自动扫描逻辑，只识别你显式配置的扫描路径。

你在core的CoreSharedConfig里只配置了com.example.core相关的扫描路径，引入到worker项目后，默认的自动扫描被关闭，worker自己的com.example.worker路径下的实体和Repo自然无法被识别，必须手动追加worker的扫描路径才能正常实例化。

更优雅的解决方案 #

你不需要为worker单独新增配置类，可以根据业务场景选以下两种方案：

方案1：在worker启动类统一配置扫描路径 #

直接在worker的主启动类上声明注解，同时包含core和worker的扫描路径即可：

@SpringBootApplication
@Import(CoreSharedConfig.class)
@EntityScan(basePackages = {"com.example.worker.entities", "com.example.core.entities"})
@EnableJpaRepositories(basePackages = {"com.example.worker.repo", "com.example.core.repo"})
public class WorkerApplication {
    public static void main(String[] args) {
        SpringApplication.run(WorkerApplication.class, args);
    }
}

同时可以把core的CoreSharedConfig里的@EntityScan和@EnableJpaRepositories注解删掉，避免影响其他引入core的下游项目的默认扫描逻辑。

方案2：core配置类使用多路径通配（适合core固定对接同一命名空间的下游项目） #

如果所有引入core的业务项目包名都统一在com.example下，可以直接修改core的配置类注解，一次性覆盖所有子包：

@Configuration
@ComponentScan("com.example.core")
@EnableJpaRepositories(basePackages = "com.example.**.repo")
@EntityScan(basePackages = "com.example.**.entities")
public class CoreSharedConfig {}

这样不管是core还是下游worker项目的对应路径下的实体、Repo都能被自动识别，下游项目不需要额外加任何扫描配置。

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