Spring Boot 应用中 YAML 配置文件无法解析 ${VAR} 形式的环境变量，通常并非配置本身错误，而是开发环境（如 IntelliJ IDEA）未正确加载系统环境变量所致；重启 IDE 或显式配置运行环境可彻底解决。
spring boot 应用中 yaml 配置文件无法解析 `${var}` 形式的环境变量，通常并非配置本身错误，而是开发环境（如 intellij idea）未正确加载系统环境变量所致；重启 ide 或显式配置运行环境可彻底解决。
在 Spring Boot 中，通过 application.yml 引用环境变量（如 ${URL}、${USERNAME}）是完全支持的标准用法，前提是这些变量在应用启动时已对 JVM 可见。你配置的以下片段本身语法正确：
spring:
datasource:
url: ${URL}
username: ${USERNAME}
password: ${PASSWORD}但若启动后仍看到原始占位符（如 url: ${URL}）并抛出 IllegalArgumentException: URL must start with 'jdbc'，说明 Spring Boot 未能成功替换占位符——根本原因往往不是 Spring Boot 机制失效，而是运行环境未将操作系统级环境变量传递给 JVM 进程。
? 常见原因与验证方法
IDE 运行配置未继承系统环境变量
IntelliJ IDEA 默认不会自动同步终端中 export URL=jdbc:h2:mem:test 所设置的变量。即使你在 Shell 中设置了变量，直接点击 IDE 的 ▶️ 运行按钮，JVM 很可能“看不见”它们。-
验证是否生效的快捷方式
在启动类中添加临时日志，确认变量是否被读取：@SpringBootApplication public class DemoApplication { public static void main(String[] args) { System.out.println("URL from env: " + System.getenv("URL")); // ✅ 检查原生环境变量 System.out.println("URL from props: " + System.getProperty("URL")); // ❌ 通常为空 SpringApplication.run(DemoApplication.class, args); } }若 System.getenv("URL") 输出为空，则证明环境变量未注入 JVM。
✅ 正确解决方案（按推荐顺序）
✅ 方案一：在 IntelliJ 中显式配置运行环境变量
- 打开 Run → Edit Configurations…
- 选中你的 Spring Boot 启动配置 → 展开 Environment variables
- 点击右侧 ... 按钮，添加键值对（如 URL=jdbc:h2:mem:test, USERNAME=sa, PASSWORD=）
- ✅ 勾选 "Include system environment variables"（确保继承系统变量）
- 应用并重启应用
? 提示：也可在该界面勾选 "Pass environment variables to child processes"，避免子进程丢失变量。
✅ 方案二：重启 IntelliJ（临时有效）
正如社区反馈：IntelliJ 有时在长时间运行后缓存旧环境上下文。完全退出 IDE（非关闭窗口），重新启动后首次运行项目，常能自动加载当前 Shell 的环境变量。这是快速验证是否为 IDE 缓存问题的低成本方式。
✅ 方案三：命令行启动（终极验证）
脱离 IDE，在终端中执行，确保环境变量生效：
export URL="jdbc:h2:mem:test" export USERNAME="sa" export PASSWORD="" ./gradlew bootRun # 或 Maven： mvn spring-boot:run
若此时正常启动，即可 100% 定位为 IDE 配置问题。
⚠️ 注意事项与最佳实践
- 变量命名规范：Spring Boot 自动将 MY_VAR 映射为 my-var（下划线转连字符），但建议在 YAML 中保持与环境变量名称一致（如 ${MY_VAR}），避免大小写或分隔符混淆。
-
默认值防错：为提升健壮性，推荐为环境变量提供默认值：
spring: datasource: url: ${URL:jdbc:h2:mem:devdb} # 无 URL 时使用默认值 username: ${USERNAME:sa} - Profile 分离更安全：结合 spring.profiles.active=dev 使用 application-dev.yml，避免敏感变量泄露到主配置中。
- Docker/K8s 场景：容器化部署时，务必通过 env: 或 envFrom: 显式注入变量，YAML 占位符才能被解析。
✅ 总结
${VAR} 在 Spring Boot YAML 中无法解析，90% 以上案例源于 IDE 运行环境未正确加载系统变量，而非配置错误或框架缺陷。优先检查并配置 IntelliJ 的 Run Configuration，辅以命令行验证，即可快速定位并解决。记住：Spring Boot 的属性解析机制高度可靠，真正需要调试的是“变量如何抵达 JVM”。
