Spring Boot 3 Fat Jar无法扫描lib及config目录问题求助

问题根源 #

Spring Boot的Fat Jar（可执行Jar）默认不会自动把同级的lib和config目录加入类路径——你之前了解的规则针对的是传统War包部署或解压后运行的场景，而非直接执行Fat Jar的情况。直接用java -jar启动时，JVM仅将Fat Jar本身作为类路径，不会扫描同级的额外目录。

解决方案 #

1. 加载外部config目录的配置文件 #

启动时通过--spring.config.location参数指定外部配置路径，或用spring.config.additional-location追加配置（不会覆盖Jar内原有配置）：

# 指定外部config目录，优先级高于Jar内配置
java -jar MyApp.jar --spring.config.location=./config/
# 追加外部配置，同时保留Jar内配置
java -jar MyApp.jar --spring.config.additional-location=./config/

若配置文件名不是application.properties，可直接指定文件路径：

java -jar MyApp.jar --spring.config.location=./config/custom.properties

2. 加载lib目录下的额外Jar（插件化） #

要加载外部Jar，需通过-cp（类路径）参数同时指定Fat Jar和外部lib目录，再指定Spring Boot的启动类：

java -cp "MyApp.jar:./lib/*" com.example.MyApplication

注意：Windows系统下路径分隔符用;，即"MyApp.jar;./lib/*"

这种方式会将Fat Jar和lib目录下所有Jar加入类路径，Spring Boot会自动扫描这些Jar中的@Component、@Configuration等组件，实现插件化功能。

3. 生产环境优雅启动（可选） #

不想每次启动都输入长参数的话，可创建启动脚本：

Linux/macOS脚本（start.sh）

#!/bin/bash
java -cp "MyApp.jar:./lib/*" com.example.MyApplication --spring.config.additional-location=./config/

Windows脚本（start.bat）

@echo off
java -cp "MyApp.jar;./lib/*" com.example.MyApplication --spring.config.additional-location=./config/

给脚本添加执行权限后，直接运行即可。

验证方法 #

• 配置验证：在外部config/application.properties中添加自定义属性（如custom.plugin.enabled=true），代码中用@Value("${custom.plugin.enabled}")注入并打印，确认是否加载成功。
• 插件验证：在外部lib的Jar中添加标注@Component的类，启动后通过Spring上下文获取该Bean，或查看日志中的组件扫描记录。

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