今天遇到一个很有意思的问题,最下面的application.yml被自己删除了,然后在上面的配置文件夹config,然后把resources下的application.yml删除了,程序启动不起来了。炸了,服务器上程序也启动不起来了。这是为什么呢?

为什么必须在 src/main/resources/
下?
-
构建工具约定(Maven/Gradle) :
- Maven 和 Gradle 这两个主流构建工具都约定:
src/main/resources/
目录下的所有文件在项目编译时,会被原封不动地打包到最终的 JAR 或 WAR 包的类路径根目录(BOOT-INF/classes/
) 下。 - Spring Boot 启动时,会自动在类路径(classpath) 的根目录下寻找名为
application.yml
或application.properties
的文件。
- Maven 和 Gradle 这两个主流构建工具都约定:
-
Spring Boot 的默认配置加载机制 :
Spring Boot 有一个严格的配置文件搜索顺序 。它会在以下位置按优先级从高到低查找
application.yml
,而classpath:/
(即类路径根目录)是其中最关键且最常用的一个位置。如果文件不在正确的位置,它就不会被打包到最终的应用程序中,因此运行时根本找不到这个配置文件。
正确的项目结构
一个标准的 Maven/Gradle 项目结构应该是这样的:
text
bash
your-spring-boot-project/
├── src/
│ ├── main/
│ │ ├── java/ # 你的Java源代码
│ │ └── resources/ # 资源文件目录
│ │ ├── application.yml # 主配置文件 ← 就在这里!
│ │ ├── static/ # 静态资源 (CSS, JS, images)
│ │ └── templates/ # 模板文件 (Thymeleaf, Freemarker)
│ └── test/ # 测试代码和资源
├── pom.xml # Maven 配置文件(或 build.gradle)
└── target/ # 编译输出目录(由Maven/Gradle生成)
如果放错了地方会怎样?
如果你的 application.yml
文件放在其他地方,比如 src/main/java/
目录下,那么在项目编译打包时,它不会被包含在最终的 JAR 包中。导致的结果是:
- 所有自定义配置(如服务器端口、数据库连接、文件上传大小限制等)全部失效。
- 应用将完全使用 Spring Boot 的默认配置(例如服务器运行在 8080 端口,使用内存数据库等)。
- 你会非常困惑,明明修改了配置文件,为什么就是不生效。
如何检查和修复?
-
检查当前位置 :首先确认你的
application.yml
文件是否确实在src/main/resources/
目录下。 -
重新放置:如果不在,请将它移动到正确的目录。
-
清理和重建 :移动后,最好执行一下 Maven 的
clean
和compile
命令,确保新的资源文件被正确打包。bash
pythonmvn clean compile # 或者直接运行 mvn spring-boot:run
-
验证 :启动应用,查看控制台日志。Spring Boot 启动时通常会打印出激活的配置文件(
Profiles
)和加载的配置属性,你可以从这里确认配置是否已正确加载。
高级用法:覆盖默认位置(如果需要)
虽然在 99% 的情况下都推荐使用默认位置,但在特殊场景下(如为了区分不同环境),你也可以通过启动命令参数来指定一个完全不同的外部配置文件位置(这不会改变打包规则,只是运行时指定新路径):
bash
arduino
java -jar your-application.jar --spring.config.location=file:/path/to/your/custom-config-dir/application.yml
或者使用 spring.config.location
作为环境变量。
但请记住,这只是一个高级特性。开发阶段最省事、最规范的做法依然是老老实实把 application.yml
放在 src/main/resources/
目录下。