
Spring Boot 默认支持从 JAR 文件所在目录自动加载 application.yml 或 application.yaml,无需硬编码路径或手动配置 spring.config.import,只需将外部配置文件置于 JAR 同级目录即可生效。
spring boot 应用启动时自动加载同目录 yaml 配置文件的正确实践:spring boot 默认支持从 jar 文件所在目录自动加载 `application.yml` 或 `application.yaml`,无需硬编码路径或手动配置 `spring.config.import`,只需将外部配置文件置于 jar 同级目录即可生效。
在 Spring Boot 2.4+ 版本中,配置加载机制已全面升级,默认会自动扫描并加载以下位置的 application.yml/application.yaml 文件(按优先级从高到低):
- 当前目录下的
/config子目录(如./config/application.yaml) - 当前目录(即 JAR 所在目录,如
./application.yaml) - Classpath 中的
/config包 - Classpath 根路径
✅ 因此,您只需将外部配置文件(如 application.yaml)直接放在 JAR 文件同一目录下,例如:
C:/Users/Igor/Desktop/myapp.jar C:/Users/Igor/Desktop/application.yaml ← Spring Boot 会自动识别并加载!
其中 application.yaml 内容可为:
myapp:
src:
ip: 111.22.333.444
⚠️ 关键注意事项:
-
无需在项目内嵌 YAML 中配置
spring.config.import指向绝对路径(如C:/Users/.../application.yaml),这不仅破坏可移植性,还可能因路径不存在导致启动失败; -
应删除 JAR 包内冗余的
application.yaml或spring.config.import声明——外部配置会自动覆盖内部配置,保留内部配置反而可能引发意外交互; - 若需加载非标准名称的 YAML(如
myapp-config.yaml),才需显式使用--spring.config.location启动参数(推荐相对路径或file:./前缀):java -jar myapp.jar --spring.config.location=file:./myapp-config.yaml
- Spring Boot 3.x 进一步强化了该机制,支持
spring.config.import动态导入(如optional:file:./config/*.yaml),但基础场景仍推荐“零配置”默认行为。
? 总结:遵循约定优于配置原则,将 application.yaml 放在 JAR 同目录是最简洁、安全、跨平台的外部化配置方案——Spring Boot 会自动发现、解析并合并配置,无需任何路径硬编码或额外配置文件。











