Spring Boot应用部署Tomcat后无法读取环境变量问题排查

从你描述的报错用户'${DB_USERNAME}'@'localhost'访问被拒绝可以明确：Spring Boot没有正确解析到环境变量，而是把占位符直接当作用户名使用了。结合你的配置，以下是几个容易遗漏的排查点：

1. 环境变量名称不匹配（最可能的原因） #

你的application.yml中使用的是${DB_USERNAME}，但在/etc/environment和setenv.sh里配置的变量名是DB_USER——变量名完全不一致！Spring找不到DB_USERNAME这个环境变量，就会把占位符原样保留，这直接导致了数据库连接失败。

你需要把配置里的变量名统一：

• 要么把application.yml里的${DB_USERNAME}改成${DB_USER}
• 要么把环境变量和setenv.sh里的DB_USER改成DB_USERNAME

2. setenv.sh的权限与执行问题 #

Tomcat启动时会自动加载bin/setenv.sh，但前提是这个脚本满足两个条件：

• 拥有可执行权限：执行chmod +x /opt/tomcat/bin/setenv.sh给脚本添加执行权限
• Tomcat的启动用户（比如默认的tomcat用户）能读取并执行这个脚本：检查文件的所有者和组，确保tomcat用户有访问权限

你可以手动执行/opt/tomcat/bin/setenv.sh，然后用echo $DB_USER验证变量是否生效，来排除脚本本身的语法问题。

3. /etc/environment的生效范围限制 #

/etc/environment里的变量只有登录shell才会加载，而如果Tomcat是通过systemd服务启动的（这是Ubuntu服务器的常见方式），默认不会读取这个文件的内容。

如果想让systemd管理的Tomcat加载/etc/environment，需要修改Tomcat的systemd服务配置文件（比如/etc/systemd/system/tomcat.service），在[Service]块中添加：

EnvironmentFile=/etc/environment

修改后执行systemctl daemon-reload和systemctl restart tomcat生效。

4. Tomcat启动用户的环境变量验证 #

如果Tomcat是用特定用户（比如tomcat）运行的，要确认这个用户能读取到你的环境变量。执行以下命令测试：

su - tomcat -c 'echo $DB_USER'

如果输出为空，说明tomcat用户的环境中没有这个变量，需要确保变量对该用户生效（比如通过/home/tomcat/.bashrc配置，或者在systemd服务中直接定义）。

5. Spring Boot War包的配置优先级 #

当Spring Boot以War包形式部署到Tomcat时，配置加载顺序可能和Jar包模式略有不同：

• 检查项目中是否存在其他配置文件（比如application-prod.yml）覆盖了数据源配置
• 确认没有通过@PropertySource注解限制了配置源的加载，导致环境变量没有被纳入解析范围

6. 检查Tomcat启动日志 #

查看Tomcat的catalina.out或localhost.log日志，看看启动时有没有加载setenv.sh的相关提示，或者有没有脚本执行错误的信息——这些日志能帮你快速定位问题所在。

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