Spring Boot @ComponentScan打Jar包失效 未打包直接运行正常问题咨询

技术版本 #

• Spring version: 5.3.9
• Spring Boot version: 2.5.3

项目结构 #

类包层级 #

my.app
   - MyApplication.class
     .data
      - MyDataRelatedComponent.class
     .service
      - MyServiceRelatedComponent.class

物理目录结构 #

/myapp/config/
      /libs/

• MyApplication类添加了@SpringBootApplication注解，其余业务类添加了@Service、@Component等注解
• application.yml存放在/myapp/config/目录下，应用依赖的所有Jar包均存放在/myapp/libs目录下

1. 通过Eclipse的JAR EXPORT功能将业务类打包为Jar放到/myapp/libs目录下，执行以下命令启动时，Spring无法扫描到任何Bean候选类，功能失效：

java -cp /myapp/config:/myapp/libs/* my.app.MyApplication

2. 若创建**/myapp/classes**目录，将业务类直接放到该目录下，执行以下命令启动时，Spring可正常扫描到Bean候选类，功能运行正常：

java -cp /myapp/classes:/myapp/config:/myapp/libs/* my.app.MyApplication

该问题的根本原因和Eclipse导出Jar的结构有关：
如果导出时选择的是可运行JAR（Runnable JAR File），导出的Jar会遵循Spring Boot可执行Jar的结构规范，所有业务类会被放在Jar包内部的BOOT-INF/classes/路径下。而普通JDK类加载器默认不会扫描Jar包内BOOT-INF/前缀路径下的类，因此Spring组件扫描时找不到带@Service、@Component注解的业务类，导致Bean注册失败。
当业务类直接放在/myapp/classes目录下时，类路径为标准的my/app/XXX.class结构，类加载器可以正常加载，Spring也能正常完成扫描。

方案1：调整Eclipse导出配置（推荐） #

导出Jar时选择普通JAR File（非Runnable JAR File），导出过程中确保勾选保留Java包结构，最终导出的Jar包内部第一层直接为my文件夹，而非BOOT-INF文件夹。将导出的Jar放到/myapp/libs目录下，原启动命令即可正常运行。

方案2：显式配置类路径 #

如果必须使用可运行Jar的结构，可调整启动命令，将Jar包内部的BOOT-INF/classes路径加到类路径中（示例中业务Jar名为myapp-business.jar，请替换为实际Jar名）：

java -cp /myapp/config:/myapp/libs/*:/myapp/libs/myapp-business.jar!/BOOT-INF/classes my.app.MyApplication

同时可以在启动类上显式指定扫描包，避免路径识别异常：

@SpringBootApplication(scanBasePackages = "my.app")

方案3：自定义MANIFEST.MF文件 #

导出Jar时自定义MANIFEST.MF文件，添加以下配置：

Main-Class: my.app.MyApplication
Spring-Boot-Classes: BOOT-INF/classes/
Spring-Boot-Lib: BOOT-INF/lib/

导出完成后可直接使用java -jar命令启动，无需配置复杂的classpath：

java -jar /myapp/libs/myapp-business.jar

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