如何将Heroku配置变量传入Spring Boot的application.properties并正常注入？

数据老陈

2026-5-21

排查Heroku环境变量无法注入Spring Boot配置的问题

我来帮你梳理下这个问题的可能原因和解决办法，结合你的Maven多模块结构和Heroku部署场景，大概率是这几个环节出了问题：

1. 确认Spring Boot启动模块的配置正确性

首先要确保你的backend模块是Spring Boot的启动模块——也就是带@SpringBootApplication的启动类在backend/src/main/java/com/jakubeeee/app目录下。只有启动模块的resources/application.properties才会被Spring Boot默认加载，如果启动类不在backend里，这个配置文件根本不会生效。

另外，检查backend模块的pom.xml里有没有配置spring-boot-maven-plugin插件，这个插件负责构建可执行的Spring Boot JAR包，没有它的话，JAR包可能无法正确加载配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <!-- 建议指定和Spring Boot版本匹配的插件版本 -->
            <version>${spring-boot.version}</version>
        </plugin>
    </plugins>
</build>

2. 验证JAR包中的配置文件是否正确

本地构建backend的JAR包后，解压看看里面的BOOT-INF/classes/application.properties内容是否正确，有没有spring.mail.username=${SPRING_MAIL_SENDER_USERNAME}这一行。如果配置文件没被打包进去，或者内容不对，那Spring肯定读不到。

3. 排查Spring对环境变量的读取逻辑

你能通过System.getenv()拿到值，说明Heroku的环境变量是正常的，问题出在Spring没有把环境变量绑定到配置属性上。可以在启动类里加一段日志代码，直接打印Spring环境中的属性值，看看差异：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.core.env.Environment;
import org.springframework.stereotype.Component;

import javax.annotation.PostConstruct;

@Component
public class ConfigChecker {

    @Autowired
    private Environment env;

    @PostConstruct
    public void logProperties() {
        String springMailUser = env.getProperty("spring.mail.username");
        String envMailUser = System.getenv("SPRING_MAIL_SENDER_USERNAME");
        System.out.println("Spring读取的spring.mail.username: " + springMailUser);
        System.out.println("系统环境变量SPRING_MAIL_SENDER_USERNAME: " + envMailUser);
    }
}

部署到Heroku后，用heroku logs --tail查看日志，如果Spring读取的值为空，那说明Spring没有正确识别这个环境变量。

4. 检查是否有其他配置源覆盖了属性值

Spring Boot的配置加载有优先级，比如系统属性（启动命令中的-D参数）> 环境变量 > application.properties。如果你的Procfile启动命令里不小心加了-Dspring.mail.username=这样的参数，或者有其他application-{profile}.properties文件覆盖了这个值，都会导致注入为空。

另外，如果你用了Spring Cloud或者其他配置中心，也要检查是否有远程配置覆盖了本地属性。

5. 尝试调整Spring Boot的配置加载方式

如果以上都没问题，可以试试在application.properties里显式指定环境变量的绑定，或者在启动命令里强制让Spring加载环境变量：

比如在application.properties里改成：spring.mail.username=${SPRING_MAIL_SENDER_USERNAME:default-value}（加上默认值，测试是否能读到默认值）
或者修改Procfile的启动命令，添加--spring.config.use-env-vars=true（不过新版本Spring Boot默认是开启的）：
```
web: java -Dserver.port=$PORT -jar $PATH_TO_JAR --spring.config.use-env-vars=true
```

最后一步：验证Heroku配置变量的正确性

在本地终端执行heroku config:get SPRING_MAIL_SENDER_USERNAME，确认返回的值是正确的，避免变量名拼写错误或者值为空的情况。

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

如何将Heroku配置变量传入Spring Boot的application.properties并正常注入？

1. 确认Spring Boot启动模块的配置正确性 #

2. 验证JAR包中的配置文件是否正确 #

3. 排查Spring对环境变量的读取逻辑 #

4. 检查是否有其他配置源覆盖了属性值 #

5. 尝试调整Spring Boot的配置加载方式 #