Docker启动Tomcat时自定义server.xml首次不生效问题求助

我之前也碰到过一模一样的坑！这问题本质是Tomcat启动时的部署顺序和自动部署机制在搞鬼，给你拆解一下原因和解决办法：

问题根源 #

你通过Dockerfile把app.war放到webapps目录，同时替换了server.xml配置根路径映射到myapp。但Tomcat首次启动时的流程是：

1. 先扫描webapps目录，自动部署所有WAR包（你的app.war会被解压成app目录，默认映射到/app路径）
2. 之后才会读取server.xml里的<Context>配置

这时候就出现两个冲突点：

• 你的<Context>里写的docBase="myapp"，但首次启动时myapp目录还不存在（WAR包刚解压成app）
• 就算你把WAR包改成myapp.war，Tomcat已经自动部署了/myapp路径，这时候根路径的映射配置会被自动生成的Context覆盖，导致首次启动不生效

而重启容器时，WAR包已经被解压成目录，Tomcat不会重复自动部署，这时候才会优先读取server.xml里的配置，所以映射就生效了。

几种靠谱的解决办法 #

方法1：直接把WAR包重命名为ROOT.war（最简单） #

Tomcat默认会把webapps/ROOT.war部署到根路径/，完全不需要修改server.xml，改一下Dockerfile就行：

FROM tomcat:8.5.27-jre8-alpine
ADD server.xml /usr/local/tomcat/conf/server.xml
ADD app.war /usr/local/tomcat/webapps/ROOT.war
CMD ["catalina.sh", "run"]

这样启动后直接访问根路径就能到你的应用，还省了配置Context的步骤。

方法2：让Tomcat忽略自动部署目标WAR包 #

在server.xml的<Host>元素里添加deployIgnore属性，阻止Tomcat自动部署你的app.war，强制它用你配置的Context加载：

<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true" deployOnStartup="true" deployIgnore="app.war">
    <!-- 其他Valve配置保持不变 -->
    <Context path="" docBase="app" reloadable="true"></Context>
</Host>

注意这里docBase要写成app（因为你的WAR包是app.war，解压后是app目录），如果你想叫myapp，就把Dockerfile里的app.war改成myapp.war，同时docBase对应改成myapp。

方法3：构建镜像时提前解压WAR包 #

在Dockerfile里先把WAR包解压成对应目录，确保Tomcat启动时docBase指向的目录已经存在，这样首次启动就能读取到Context配置：

FROM tomcat:8.5.27-jre8-alpine
ADD server.xml /usr/local/tomcat/conf/server.xml
ADD app.war /usr/local/tomcat/webapps/myapp.war
# 解压WAR包到myapp目录，然后删除原WAR包
RUN unzip /usr/local/tomcat/webapps/myapp.war -d /usr/local/tomcat/webapps/myapp && rm /usr/local/tomcat/webapps/myapp.war
CMD ["catalina.sh", "run"]

这样构建镜像时就生成了myapp目录，Tomcat启动时直接读取server.xml的映射配置，首次启动就能生效。

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