Docker部署Spring Boot应用时application.properties配置路径为何变化

问题核心原因 #

该问题由Docker环境下Spring配置被覆盖导致，你配置的application.base-folder值在容器运行时被优先级更高的配置替换成了/home/folder，所以拼接出来的最终路径多了一层folder目录。
Spring Boot配置优先级从高到低为：容器环境变量 > jar包外部配置文件 > jar包内部配置文件，Docker部署场景下绝大多数都是前两种配置覆盖了本地打包的配置值。

排查步骤 #

• 进入运行中的容器执行env | grep APPLICATION_BASE_FOLDER，检查是否存在该环境变量，Spring会自动将application.base-folder转换为全大写下划线分隔的环境变量名匹配，如果返回值为/home/folder就是环境变量覆盖了配置。
• 检查容器内是否挂载了外部的application.yml/application.properties文件，查看该文件中application.base-folder的配置值是否为/home/folder，如果是外部挂载配置覆盖了jar包内的配置。
• 临时在deleteFolder方法中添加日志打印applicationBaseFolder的实际值，调用接口验证该变量的值是否和你配置的/home一致，确认配置是否生效。
• 如果用到了Spring Cloud配置中心/Nacos等配置管理组件，检查对应环境的配置中心中application.base-folder的配置值，Docker环境通常会连接测试/生产配置中心，而Windows本地开发时默认走本地配置，也会出现两边配置不一致的情况。

修复方案 #

根据排查结果对应处理即可：

• 如果是环境变量覆盖：修改Docker启动命令或者docker-compose.yaml中的环境变量配置，删除多余的APPLICATION_BASE_FOLDER配置，或者将值改为你需要的/home。
• 如果是外部配置文件覆盖：修改挂载的配置文件中的base-folder值即可。
• 如果是配置中心配置错误：修改对应环境配置中心的配置值后重启应用。

内容的提问来源于stack exchange，提问作者Dolphy the Reaper