Spring Boot @EntityScan能否递归扫描基础包下子包中的实体类？

当然可以用@EntityScan实现递归扫描，而且这正是简化配置的最佳方式！不用再一个个手动指定子包路径，下面给你详细说怎么操作：

基础用法：递归扫描基础包 #

@EntityScan默认就支持递归扫描指定包下的所有子包，只要你指定基础包的根路径就行。比如你的实体类都放在com.example.app.entities这个根包的子包里（比如com.example.app.entities.user、com.example.app.entities.order），只需要这样配置：

@SpringBootApplication
@EntityScan(basePackages = "com.example.app.entities")
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

这样Spring会自动扫描com.example.app.entities下的所有层级子包，把里面的@Entity注解类都注册成实体Bean，完全不用逐个列子包。

进阶：更简洁的写法 #

如果你的启动类本身就在基础包的上层或者同层级，还可以用basePackageClasses参数，直接指定某个实体类的Class，Spring会自动扫描这个类所在的包及其所有子包：

@SpringBootApplication
@EntityScan(basePackageClasses = UserEntity.class)
public class YourApplication {
    // ...
}

这种写法的好处是不用硬编码包名，避免后续包结构调整时还要改配置，更灵活。

额外提醒：注意扫描范围 #

• 如果你同时用了@SpringBootApplication，它默认会扫描启动类所在包及其子包的组件，但实体类的扫描是由@EntityScan单独控制的，所以如果实体包不在启动类的扫描范围内，必须显式配置@EntityScan。
• 要是只想扫描部分子包，也可以结合使用：basePackages = {"com.example.app.entities.user", "com.example.app.entities.order"}，不过这就失去了递归的便捷性，除非有特殊需求。

总结一下，最简便的方式就是给@EntityScan指定实体类的根基础包，它会自动递归扫描所有子包，完全替代逐个指定子包的繁琐操作。

内容的提问来源于stack exchange，提问作者Jan Peter König