Tomcat成功部署.war包后立即自动卸载问题求助

我之前帮不少人排查过类似的场景，这种部署后立刻被Tomcat卸载、直到Octopus超时失败的问题，大多和Tomcat的自动部署逻辑、文件权限或者Octopus的步骤配置有关，给你梳理几个针对性的排查和解决方向：

1. 先排查Tomcat自动部署的冲突 #

Tomcat默认的autoDeploy和deployOnStartup机制，有时候会和Octopus的部署操作“打架”。比如Octopus上传war包后，Tomcat检测到文件变化触发自动部署，但过程中因为某种异常（比如权限、文件状态）导致部署失败，进而触发卸载，然后Octopus又重试，形成循环。

• 临时修改Tomcat的conf/server.xml里的Host配置，把自动部署相关参数关掉试试：

  <Host name="localhost"  appBase="webapps"
        unpackWARs="true" autoDeploy="false" deployOnStartup="false">
  

  重启Tomcat后再用Octopus部署，如果问题消失，那就是自动部署机制的锅。之后可以根据需求调整：要么保持关闭自动部署，完全用Octopus管控；要么调整Octopus的部署时机，避免和Tomcat的扫描周期冲突。

2. 检查Linux服务器上的文件权限 #

Linux下Tomcat运行用户如果没有war包或解压后文件的读写权限，会导致Tomcat无法正常加载应用，直接触发卸载。

• 登录目标服务器，查看webapps目录下的相关文件权限：

  ls -l /opt/tomcat/webapps/  # 替换成你的Tomcat实际路径
  

  确保war包和对应的解压文件夹的所有者/组是Tomcat的运行用户（比如tomcat:tomcat），权限至少是rw-r--r--。如果不对，用下面的命令修正：

  chown -R tomcat:tomcat /opt/tomcat/webapps/myWebApp*
  chmod -R 644 /opt/tomcat/webapps/myWebApp.war
  

3. 核对Octopus的Tomcat Manager步骤配置 #

Octopus的部署步骤如果配置不当，也会触发Tomcat的异常卸载：

• 打开Octopus的部署计划，找到Tomcat Manager步骤：
  • 确认Deploy type选择的是Deploy WAR file，而不是Undeploy then deploy——后者可能会和Tomcat的内部操作冲突，导致重复卸载部署。
  • 看看有没有勾选Force redeploy，如果勾了，先取消试试，强制重部署有时候会让Tomcat处理逻辑混乱。
  • 检查Context path是否和Tomcat中已有的应用上下文重复，比如已经有同名的应用在运行，也会导致部署失败卸载。

4. 调高Tomcat日志级别，获取卸载原因 #

默认的catalina.out日志可能没记录卸载的具体原因，调高日志级别就能看到细节：

• 修改Tomcat的conf/logging.properties，把日志级别改成FINE：

  # 修改这两行的级别
  1catalina.org.apache.juli.FileHandler.level = FINE
  java.util.logging.ConsoleHandler.level = FINE
  

  重启Tomcat后重新部署，再看catalina.out，就能找到Tomcat卸载应用的具体原因了——比如依赖缺失、web.xml配置错误、端口占用等等，这些细节是定位问题的关键。

5. 手动验证War包本身是否正常 #

有时候问题出在War包本身，比如打包时损坏、内部配置错误，导致Tomcat加载失败：

• 把Octopus用的那个War包手动上传到Tomcat的webapps目录，然后启动Tomcat，看能不能正常部署。如果手动部署也失败，那就是War包的问题，得回头检查打包过程，比如有没有遗漏依赖、配置文件是否正确。

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