SpringBoot YML配置文件无法解析环境变量问题咨询

以下是导致${URL}这类占位符未被替换的常见原因及解决办法：

1. 环境变量未正确配置或未被读取 #

• 首先确认系统/IDE中已设置对应环境变量，变量名大小写要完全匹配（Linux/macOS严格区分大小写，Windows建议统一）：
  • Linux/macOS终端执行echo $URL，检查是否输出正确的JDBC地址（格式应为jdbc:mysql://localhost:3306/dev_db这类）
  • Windows命令行执行echo %URL%，确认返回有效值
• 若在IDE中启动，需检查Run Configuration的「Environment variables」配置，部分IDE不会自动加载系统全局环境变量，需手动添加。

2. 变量命名易引发冲突 #

直接使用URL、USERNAME这类通用变量名，可能和Spring Boot内置变量或其他组件的变量冲突，导致解析失败。建议改用更具辨识度的命名，比如：

spring:
  datasource:
    url: ${DEV_DB_URL}
    username: ${DEV_DB_USER}
    password: ${DEV_DB_PASS}

同时对应设置DEV_DB_URL、DEV_DB_USER、DEV_DB_PASS这三个环境变量。

3. Dev Profile未激活 #

如果你的配置是针对dev Profile的，必须确保该Profile已被激活，否则Spring Boot会加载默认配置，忽略这段内容：

• 启动时添加参数：java -jar your-app.jar --spring.profiles.active=dev
• 在主application.yml中配置默认激活：

  spring:
    profiles:
      active: dev
  

• 或通过环境变量激活：SPRING_PROFILES_ACTIVE=dev

4. 配置文件格式或位置错误 #

• 若dev配置单独写在application-dev.yml中，需确保文件名严格遵循application-{profile}.yml格式，Spring Boot才会自动识别加载。
• 若在主application.yml中用多Profile分段配置，需正确标记Profile块：

  spring:
    profiles:
      active: dev
  ---
  spring:
    profiles: dev
    datasource:
      url: ${DEV_DB_URL}
      username: ${DEV_DB_USER}
      password: ${DEV_DB_PASS}
  

5. 环境变量含特殊字符未转义 #

如果环境变量值包含&、空格等特殊字符，需用引号包裹配置项，避免解析异常：

spring:
  datasource:
    url: "${DEV_DB_URL}"

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