如何在Spring框架中正确访问环境变量？多环境配置下环境变量读取失败问题排查

嗨，我来帮你一步步排查这个问题～ 从你描述的情况来看，核心问题是Spring Boot在prod环境下没有正确解析环境变量，导致数据源URL还是原始的${SPRING_DATASOURCE_URL}字符串，进而引发驱动报错。咱们从几个常见的方向来检查：

1. 确认Heroku平台的环境变量是否正确配置 #

你提到本地CMD能正常读取环境变量，但Heroku的运行环境和你的本地系统是完全独立的——本地设置的环境变量不会自动同步到Heroku。你需要在Heroku上单独配置这些变量：

• 方式一：登录Heroku Dashboard，找到你的应用，进入「Settings」→「Config Vars」，手动添加SPRING_DATASOURCE_URL、SPRING_DATASOURCE_USERNAME、SPRING_DATASOURCE_PASSWORD、SPRING_JPA_DATABASE_PLATFORM这些变量。
• 方式二：用Heroku CLI命令行设置，比如：

  heroku config:set SPRING_DATASOURCE_URL=your_postgres_url
  heroku config:set SPRING_DATASOURCE_USERNAME=your_db_username
  heroku config:set SPRING_DATASOURCE_PASSWORD=your_db_password
  heroku config:set SPRING_JPA_DATABASE_PLATFORM=org.hibernate.dialect.PostgreSQLDialect
  

设置完成后，可以用heroku config命令确认所有变量都已正确添加。

2. 检查环境变量名的拼写（尤其是特殊字符） #

注意到你在application-prod.properties里写的是${SPRING_JPA_DATABASE-PLATFORM}，但操作系统的环境变量通常不允许包含破折号，大部分环境会把破折号识别为分隔符。正确的变量名应该用下划线代替破折号：SPRING_JPA_DATABASE_PLATFORM。

• 把配置文件里的对应行改成：

  spring.jpa.database-platform=${SPRING_JPA_DATABASE_PLATFORM}
  

• 同时在Heroku上配置的变量名也要统一用下划线版本，避免因为命名不匹配导致Spring读不到值。

3. 清理配置文件里的多余空格 #

你的配置行里等号后面有个空格，比如spring.datasource.url= ${SPRING_DATASOURCE_URL}，虽然Spring Boot通常能容忍这种格式，但偶尔会因为空格导致变量解析异常。建议改成无空格的标准格式：

spring.datasource.url=${SPRING_DATASOURCE_URL}
spring.datasource.username=${SPRING_DATASOURCE_USERNAME}
spring.datasource.password=${SPRING_DATASOURCE_PASSWORD}
spring.jpa.database-platform=${SPRING_JPA_DATABASE_PLATFORM}
spring.datasource.driver-class-name=org.postgresql.Driver

4. 本地模拟prod环境测试 #

为了排除Heroku平台的问题，你可以在本地模拟prod环境启动应用，验证环境变量是否能被正确读取：

• 方法一：设置本地环境变量SPRING_PROFILES_ACTIVE=prod，然后启动应用。
• 方法二：用命令行参数强制指定prod profile启动：

  java -jar your-app.jar --spring.profiles.active=prod
  

如果本地启动prod环境也出现同样的错误，说明是本地环境变量的问题（比如变量名拼写错误）；如果本地正常，那问题大概率出在Heroku的配置上。

5. 查看Heroku的启动日志 #

用Heroku CLI查看实时日志，确认应用启动时是否加载了prod profile，以及环境变量是否被正确注入：

heroku logs --tail

如果日志里显示The following profiles are active: prod，说明profile加载正常；如果没看到环境变量相关的输出，或者提示变量不存在，就回到第一步检查Heroku的Config Vars配置。

按照上面的步骤排查下来，应该能找到问题所在～ 毕竟是第一个Spring项目，遇到配置问题很正常，慢慢调就好啦！

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