如何让Docker部署的Tomcat应用将文件保存到指定挂载目录？

问题排查与解决方法 #

1. 优先排查应用路径配置（90%概率是这个原因） #

官方Tomcat镜像的默认进程工作目录为/usr/local/tomcat，如果你的应用代码里使用相对路径（比如直接写uploads/documents/xxx.pdf）存储文件，默认就会基于工作目录拼接路径，最终文件存在/usr/local/tomcat目录下，和你预期的路径不符。
解决方法：

• 在你的application-prod.yml中显式配置绝对路径的上传目录：

file:
  upload-path: /usr/local/tomcat/webapps/app/uploads/documents

• 应用代码中读取该配置项拼接文件名，不要硬编码相对路径。

2. 排查挂载目录写入权限 #

如果手动进入容器往目标路径写文件失败，说明Tomcat运行用户没有挂载目录的写入权限，应用写入失败后可能 fallback 到工作目录存储文件。
解决方法：

• 方案1：在docker-compose.yml的app服务配置中新增user: root，指定容器以root身份运行，跳过权限限制
• 方案2：修改宿主机挂载目录的所属用户，匹配容器内默认tomcat用户的UID：

sudo chown -R 1000:1000 ./data/uploads/documents

3. 确认应用解压目录名是否匹配 #

如果你的war包命名为ROOT.war，Tomcat默认会解压到/usr/local/tomcat/webapps/ROOT目录，而非你配置的app目录，会导致目标路径不存在，写入失败。
排查方法：执行以下命令查看容器内webapps下的实际目录名：

docker exec -it app ls /usr/local/tomcat/webapps/

如果目录名和你配置的不一致，同步修改docker-compose.yml中的挂载路径和应用内的存储路径即可。

快速验证挂载是否正常 #

执行以下命令手动在容器目标路径创建文件，检查宿主机是否能同步到：

docker exec -it app touch /usr/local/tomcat/webapps/app/uploads/documents/test.txt

如果宿主机./data/uploads/documents下能看到test.txt，说明挂载配置完全正常，问题仅出在应用本身的路径配置。

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