Spring Boot在Linux服务器无法读取环境变量问题求助

我之前也碰到过一模一样的情况，本地Windows跑起来完全正常，一部署到Linux就死活读不到环境变量，给你几个实际可行的排查和解决方向：

1. 先检查环境变量的命名格式（最常见的坑！） #

Spring Boot对环境变量的映射是有规则的：Linux系统里的环境变量建议用大写字母+下划线的格式，比如SPRING_DATASOURCE_USERNAME，而不是你设置的spring.datasource.username。

原因是：

• Linux环境变量是大小写敏感的，而且点号在环境变量里虽然能设置，但Spring Boot的属性绑定逻辑默认会把大写_下划线格式的变量自动转成小写.点号格式的配置项。
• Windows环境变量不区分大小写，所以你用spring.datasource.username能读到，但Linux里就不行了。

解决方法：
在Linux里重新设置环境变量：

export SPRING_DATASOURCE_USERNAME=your_db_username
export SPRING_DATASOURCE_PASSWORD=your_db_password

之后不管你用env.getProperty("spring.datasource.username")还是直接在applicationcontext.properties里写spring.datasource.username=${SPRING_DATASOURCE_USERNAME}，都能正常读取到。

2. 确认环境变量的生效范围和进程继承 #

你说在环境变量列表里能看到变量，但进程读不到，大概率是变量没被Spring Boot进程继承：

• 如果是用export临时设置的变量，只在当前Shell会话有效。如果你是用nohup后台启动、systemd服务启动，或者新开了一个Shell启动应用，这个临时变量就不会被继承。
• 要让全局生效，可以把变量加到/etc/environment（系统级，所有用户进程都能读到），或者~/.bashrc/~/.profile（当前用户级），加完后执行source /etc/environment（对应文件）让当前会话生效，或者重启服务器。

如果是用systemd管理Spring Boot服务，直接在.service文件里配置环境变量更可靠：

[Service]
# 其他配置...
Environment="SPRING_DATASOURCE_USERNAME=your_db_username"
Environment="SPRING_DATASOURCE_PASSWORD=your_db_password"

然后重新加载systemd配置并重启服务：

sudo systemctl daemon-reload
sudo systemctl restart your-app.service

3. 调试进程实际能拿到的环境变量 #

如果还是不确定问题在哪，可以在应用里加一段调试代码，打印进程实际能获取到的环境变量：

@Component
public class EnvDebugger implements ApplicationListener<ApplicationReadyEvent> {

    @Autowired
    private Environment env;

    @Override
    public void onApplicationEvent(ApplicationReadyEvent event) {
        // 打印目标变量
        System.out.println("=== 调试数据源环境变量 ===");
        System.out.println("spring.datasource.username: " + env.getProperty("spring.datasource.username"));
        System.out.println("SPRING_DATASOURCE_USERNAME: " + System.getenv("SPRING_DATASOURCE_USERNAME"));

        // 打印所有SPRING开头的环境变量
        System.getenv().forEach((key, value) -> {
            if (key.startsWith("SPRING_")) {
                System.out.println(key + ": " + value);
            }
        });
    }
}

启动应用后看日志，就能清楚知道进程到底有没有拿到变量，再针对性排查。

4. 检查applicationcontext.properties的配置方式 #

其实更推荐直接在配置文件里用占位符绑定环境变量，这样代码里不用手动读取Environment，更符合Spring Boot的最佳实践：

# applicationcontext.properties
spring.datasource.url=${SPRING_DATASOURCE_URL}
spring.datasource.username=${SPRING_DATASOURCE_USERNAME}
spring.datasource.password=${SPRING_DATASOURCE_PASSWORD}

这样Spring Boot会自动帮你完成绑定，不用在datasourceset方法里手动读取。

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