Spring Boot 应用中，YAML 配置文件（如 application-dev.yml）引用环境变量（如 ${URL}）时未被正确解析，导致启动失败——常见于 IntelliJ IDEA 中环境变量未被及时加载，需重启 IDE 或改用更可靠的配置方式。
spring boot 应用中，yaml 配置文件（如 application-dev.yml）引用环境变量（如 `${url}`）时未被正确解析，导致启动失败——常见于 intellij idea 中环境变量未被及时加载，需重启 ide 或改用更可靠的配置方式。
在 Spring Boot 项目中，通过 ${VAR_NAME} 语法在 application.yml（或 profile-specific 文件如 application-dev.yml）中引用系统环境变量，是一种推荐的外部化配置方式。例如：
spring:
datasource:
url: ${DATABASE_URL:jdbc:h2:mem:testdb}
username: ${DATABASE_USERNAME:sa}
password: ${DATABASE_PASSWORD:""}上述写法中，${DATABASE_URL:...} 使用了默认值语法（冒号后为 fallback 值），既提升健壮性，也便于本地调试。
然而，许多开发者（尤其使用 IntelliJ IDEA）会遇到环境变量“不生效”的典型现象：应用启动时，${URL} 未被替换，直接报错：
Caused by: java.lang.IllegalArgumentException: URL must start with 'jdbc'
这并非 Spring Boot 本身限制——Spring Boot 默认完全支持环境变量占位符解析（优先级高于 application.yml，详见 Externalized Configuration）。根本原因通常在于运行环境未将变量正确注入 JVM 进程。
? 常见原因与对应方案
-
✅ IDE 启动未继承系统环境变量（最常见）
IntelliJ 默认不会自动同步当前终端的 env。即使你在 Shell 中执行了 export DATABASE_URL=jdbc:mysql://...，IDEA 的 Run Configuration 若未显式配置，JVM 将无法读取。
解决方法：- 在 Run → Edit Configurations → Environment variables 中手动添加（如 DATABASE_URL=jdbc:...）；
- 或勾选 Include system environment variables（IntelliJ 2022.3+ 支持）；
- 临时有效方案：关闭并重启 IntelliJ（正如答案所指出），因重启后 IDE 可能重新读取登录 Shell 的环境。
✅ 变量名大小写/命名规范问题
Spring Boot 会自动将环境变量名（如 DATABASE_URL）映射为 database.url，但反向推导（从 url 推 DATABASE_URL）依赖严格命名约定。建议始终使用 UPPER_SNAKE_CASE 并与配置路径对齐（如 SPRING_DATASOURCE_URL 可直接覆盖 spring.datasource.url）。-
✅ 配置文件未激活对应 profile
确保已启用目标 profile：java -jar app.jar --spring.profiles.active=dev
或在 application.yml 中设置默认 profile：
spring: profiles: active: dev
✅ 最佳实践建议
- *优先使用 `SPRING_前缀变量**：如SPRING_DATASOURCE_URL`，无需修改 YAML，天然兼容；
- 始终提供默认值：避免因变量缺失导致启动失败；
- 生产环境禁用明文密码：结合 Spring Boot Config Server、HashiCorp Vault 或云平台 Secret Manager；
-
验证环境变量是否生效：在启动类中添加调试日志：
@SpringBootApplication public class MyApp { public static void main(String[] args) { System.out.println("Resolved URL: " + System.getenv("DATABASE_URL")); SpringApplication.run(MyApp.class, args); } }
环境变量是 Spring Boot 外部化配置的核心能力之一，只要确保变量成功注入 JVM 进程，YAML 中的 ${...} 占位符即可无缝解析——无需修改代码，也无需重启应用（仅首次启动需注意 IDE 环境加载时机）。
