Spring Boot项目无法找到application配置文件问题求助

问题背景 #

接手的Spring Boot项目一直存在找不到application.yml和resources目录的问题：

• IDEA中已将resources目录标记为资源根目录
• target/resources目录下确实存在目标yml文件
• 调试ConfigFileApplicationListener的load方法时，无论把spring.config.location配置成file:application-local.yml还是file:resources/application-local.yml，resource.exists()都返回false
• 目前只有通过环境变量或者绝对路径能读取配置文件，用classpath:/resources/路径完全无效

排查解决步骤 #

1. 纠正classpath路径的错误用法 #

classpath的根目录是resources编译后的位置，也就是target/classes（不是target/resources）。所以正确的classpath路径应该是classpath:/application-local.yml——因为resources目录里的文件编译后会直接放到target/classes下，原resources目录本身不会出现在classpath路径里。

2. 检查IDEA的编译输出与资源目录配置 #

打开IDEA的File -> Project Structure -> Modules：

• 切换到Paths标签页，确认Output path和Test output path分别指向target/classes和target/test-classes
• 切换到Sources标签页，再次确认resources目录的类型是Resources（显示蓝色文件夹图标）

3. 验证构建工具的资源编译配置 #

如果用Maven，检查pom.xml里的resources节点，确保没有错误的路径排除或重定向：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <filtering>false</filtering>
        </resource>
    </resources>
</build>

如果用Gradle，检查build.gradle的sourceSets配置：

sourceSets {
    main {
        resources {
            srcDirs = ['src/main/resources']
        }
    }
}

执行一次clean再compile，确认资源文件被正确复制到target/classes（Maven）或build/resources/main（Gradle）目录下。

4. 修正spring.config.location的配置 #

• 用file:协议的相对路径时，路径是相对于IDEA的项目根目录，不是模块目录或target目录。比如项目根目录下的src/main/resources/application-local.yml，对应的file路径应该是file:src/main/resources/application-local.yml
• 更推荐用classpath路径：spring.config.location=classpath:/application-local.yml，Spring会自动从编译后的classpath根目录查找文件

5. 检查IDEA运行配置的工作目录 #

打开Run -> Edit Configurations，查看Working directory是否设置为项目根目录。如果这个路径被修改过，相对路径的file:配置就会找不到文件。

6. 清理IDEA缓存并重启 #

执行File -> Invalidate Caches... -> Invalidate and Restart，有时候IDEA的缓存异常会导致资源目录识别出错。

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