66项目中 Spring Boot 配置文件未生效该如何解决

网罗开发 （小红书、快手、视频号同名）

大家好，我是展菲，目前在上市企业从事人工智能项目研发管理工作，平时热衷于分享各种编程领域的软硬技能知识以及前沿技术，包括iOS、前端、Harmony OS、Java、Python等方向。在移动端开发、鸿蒙开发、物联网、嵌入式、云原生、开源等领域有深厚造诣。

图书作者：《ESP32-C3 物联网工程开发实战》
图书作者：《SwiftUI 入门，进阶与实战》
超级个体：COC上海社区主理人
特约讲师：大学讲师，谷歌亚马逊分享嘉宾
科技博主：华为HDE/HDG

我的博客内容涵盖广泛，主要分享技术教程、Bug解决方案、开发工具使用、前沿科技资讯、产品评测与使用体验 。我特别关注云服务产品评测、AI 产品对比、开发板性能测试以及技术报告，同时也会提供产品优缺点分析、横向对比，并分享技术沙龙与行业大会的参会体验。我的目标是为读者提供有深度、有实用价值的技术洞察与分析。

展菲：您的前沿技术领航员

👋 大家好，我是展菲！

📱 全网搜索"展菲"，即可纵览我在各大平台的知识足迹。

📣 公众号"Swift社区"，每周定时推送干货满满的技术长文，从新兴框架的剖析到运维实战的复盘，助您技术进阶之路畅通无阻。

💬 微信端添加好友"fzhanfei"，与我直接交流，不管是项目瓶颈的求助，还是行业趋势的探讨，随时畅所欲言。

📅 最新动态：2025 年 3 月 17 日

快来加入技术社区，一起挖掘技术的无限潜能，携手迈向数字化新征程！

文章目录

- 前言
- 配置文件路径问题
- [Profile 没有正确激活](#Profile 没有正确激活)
- [IDEA 启动配置的问题](#IDEA 启动配置的问题)
- 实际场景举例
- 总结

前言

在日常开发 Spring Boot 项目的时候，大家应该都遇到过这样一种情况：明明写了 application.yml，但是项目跑起来之后，配置好像完全没被加载。比如数据库连接还是旧的值，日志级别也没生效。这种情况其实挺常见，往往不是 Spring Boot 本身有问题，而是我们在配置文件路径、Profile 激活或者 IDE 启动参数上出了岔子。

这篇文章就来聊聊 Spring Boot 配置文件未生效 的几个典型场景，并配合 Demo 代码来演示如何解决。

配置文件路径问题

首先需要明确：Spring Boot 默认会从以下位置加载配置文件（优先级从高到低）：

classpath:/application.yml
classpath:/config/application.yml
file:./application.yml
file:./config/application.yml

所以，如果你把 application.yml 放在了一个奇怪的位置（比如 resources/configs/），自然不会生效。

来看个例子：

yaml 复制代码

# src/main/resources/application.yml
server:
  port: 8081

spring:
  application:
    name: demo-app

然后写一个最简单的 Spring Boot 应用：

java 复制代码

@SpringBootApplication
@RestController
public class DemoApplication {

    @Value("${server.port}")
    private int port;

    @GetMapping("/hello")
    public String hello() {
        return "App is running on port: " + port;
    }

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

如果 application.yml 正常被加载，启动后访问 http://localhost:8081/hello，会看到：

复制代码

App is running on port: 8081

但如果你把 application.yml 放到 src/main/resources/configs/application.yml，那它就不会生效，Spring Boot 根本不会去那个目录找。

解决办法 ：要么挪到正确路径，要么用 --spring.config.location 指定路径：

bash 复制代码

java -jar demo.jar --spring.config.location=classpath:/configs/

Profile 没有正确激活

Spring Boot 支持多环境配置，比如：

yaml 复制代码

# application.yml
spring:
  profiles:
    active: dev

yaml 复制代码

# application-dev.yml
server:
  port: 8082

# application-prod.yml
server:
  port: 8083

如果你没激活 profile，那么默认只会加载 application.yml。有时候大家忘记在 application.yml 里写 spring.profiles.active，导致环境配置根本没切换。

另一种情况是你在 IDEA 里配置了 VM options，例如：

复制代码

-Dspring.profiles.active=prod

那就会优先使用 application-prod.yml，而不是 application-dev.yml。

小 Demo 验证：

java 复制代码

@Value("${server.port}")
private int port;

@GetMapping("/profile")
public String profile() {
    return "Running on port: " + port;
}

当激活 dev 时，返回 Running on port: 8082；当激活 prod 时，返回 Running on port: 8083。

如果你明明写了 application-dev.yml 却发现不起作用，那大概率是 spring.profiles.active 没有正确指定。

IDEA 启动配置的问题

很多同学在用 IDEA 跑 Spring Boot 项目的时候，遇到配置不生效，其实是因为 IDEA 的 Run/Debug Configurations 里没传递参数。

比如你在命令行里用：

bash 复制代码

java -jar demo.jar --spring.profiles.active=dev

是没问题的。

但是在 IDEA 里如果你什么都不配，就可能跑成默认环境。正确做法是在 Run/Debug Configurations → VM options 里加上：

复制代码

-Dspring.profiles.active=dev

这样无论是运行还是调试，都会加载对应的配置文件。

实际场景举例

举个比较真实的场景：

有个同事写了 application-dev.yml 配置了数据库连接：

yaml 复制代码

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/demo
    username: root
    password: root123

结果启动的时候报错：

复制代码

Cannot load driver class: com.mysql.cj.jdbc.Driver

后来排查发现，原因有两个：

application-dev.yml 没生效，因为 spring.profiles.active 没指定；
Maven 依赖缺少 mysql-connector-java。

改好之后就正常运行了。这个案例说明：配置文件问题往往不止一个，要结合日志一步步分析。

总结

Spring Boot 配置文件未生效主要有三个大坑：

路径问题：放错位置，Spring Boot 根本找不到。
Profile 激活问题 ：没指定 spring.profiles.active，导致环境没切换。
IDEA 配置问题：运行参数没传递，结果和预期不一致。

我的建议是：

路径一定放在标准目录；
配置多环境时，一定检查 spring.profiles.active；
用 IDEA 启动时，确保 VM options 和命令行一致；
另外，多看看启动日志，Spring Boot 在启动时会打印加载了哪些配置文件，非常直观。