Spring Boot 3.x升级至4.x后环境变量读取异常问题

Spring Boot 4.x确实调整了属性优先级规则，这是你遇到问题的核心原因，具体细节和解决办法如下：

核心变化 #

在Spring Boot 3.x中，SPRING_DATA_MONGODB_URI环境变量的优先级高于application.properties中单独配置的spring.data.mongodb.username/password等属性——只要设置了URI环境变量，应用会自动用URI里的连接信息覆盖配置文件中的单独属性。

但升级到4.x后，规则发生了变化：如果application.properties中存在单独的username/password等属性，它们的优先级会高于从URI中解析出来的对应值。所以你部署时虽然设置了URI环境变量，但应用还是会读取配置文件里的本地用户名，导致连接失败。

解决办法 #

• 删除application.properties中单独的spring.data.mongodb.username、spring.data.mongodb.password、spring.data.mongodb.host等配置项，只保留URI相关配置（或者完全不配置MongoDB的单独属性），让环境变量中的URI完全接管连接配置。
• 启动应用时添加--debug参数，查看控制台输出的属性源加载顺序和最终生效的属性值，能直观确认哪个配置被应用选中，方便排查其他潜在问题。
• 如果需要保留本地开发的单独属性，可以通过spring.profiles.active区分环境：本地用dev profile配置单独属性，部署时切换到prod profile，让prod环境只读取URI配置。

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