Spring Boot配置加载异常：指定Profile下密码变量读取错误且跨环境表现不一致

这种跨环境配置不一致的问题确实挺闹心的，尤其是出现123456这种完全没在代码里出现过的值。结合你的情况，我整理了几个最可能的原因和对应的排查/解决步骤：

1. 环境变量优先级覆盖 #

Spring Boot会优先读取系统环境变量，而且会自动把下划线分隔的大写变量映射成点分隔的配置项（比如MAIL_PASSWORD对应mail.password）。

排查方式： #

在Linux服务器上执行以下命令，检查是否存在相关环境变量：

printenv | grep -i mail

如果输出里有MAIL_PASSWORD=123456，那就是它在搞鬼。

解决方案： #

• 临时验证：启动项目前执行unset MAIL_PASSWORD清除环境变量，再重启项目测试。
• 永久解决：找到设置该环境变量的地方（比如/etc/profile、~/.bashrc或者项目的启动脚本），删除对应的配置。

2. 启动时传入了JVM/命令行参数 #

有可能在Linux环境的启动脚本里，通过JVM参数或者命令行参数强制设置了mail.password。

排查方式： #

查看项目的启动命令，比如：

ps aux | grep java

检查是否有-Dmail.password=123456或者--mail.password=123456这类参数。

解决方案： #

修改启动脚本，移除这些强制设置的参数，重新启动项目。

3. 外部配置源（配置中心/远程配置） #

如果你的项目使用了Spring Cloud Config、Nacos或者其他外部配置服务，远程配置中心里的qualif环境可能设置了mail.password=123456，而远程配置的优先级高于本地yml文件。

排查方式： #

• 登录配置中心，查看对应qualif环境的配置项，确认是否存在mail.password。
• 查看项目启动日志，是否有加载远程配置的相关日志。

解决方案： #

在配置中心的qualif环境下修正mail.password的值，或者调整配置源的优先级（不推荐，除非特殊需求）。

4. 构建缓存/打包问题 #

有可能Linux环境部署的包是旧的，或者打包时没有正确包含最新的application.yml。

排查方式： #

• 在Linux服务器上解压部署的jar包，查看BOOT-INF/classes/application.yml里的mail.password是否是myRealPassword。
• 本地重新执行mvn clean package（或gradle的clean build），确保打包过程清理了旧缓存。

解决方案： #

重新打包并替换Linux服务器上的旧包，重启项目。

进阶调试：定位配置来源 #

如果以上步骤都没找到问题，可以在你的SmtpConfiguration里添加一段代码，直接打印mail.password的加载来源：

@Configuration
@Getter
public class SmtpConfiguration {
    @Value("${mail.login}")
    private String login;
    @Value("${mail.address}")
    private String address;
    @Value("${mail.password}")
    private String password;

    @Autowired
    private Environment env;

    @PostConstruct
    public void debugConfigSource() {
        ConfigurableEnvironment configurableEnv = (ConfigurableEnvironment) env;
        String configSource = configurableEnv.getPropertySources().stream()
                .filter(source -> source.containsProperty("mail.password"))
                .findFirst()
                .map(PropertySource::getName)
                .orElse("Unknown source");
        System.out.printf("DEBUG: mail.password loaded from [%s] with value: %s%n", configSource, password);
    }
}

重启项目后，查看控制台的DEBUG日志，就能明确知道这个配置是从哪个来源加载的，精准定位问题。

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