这种情况我之前也碰到过好几次——明明配置和之前一模一样，重拉代码后却卡在上部署这一步，大概率是缓存、包完整性这类容易忽略的小细节出了问题，试试下面这些排查步骤：

• 清理Tomcat缓存与临时文件
  先停掉Tomcat服务，找到Tomcat安装目录下的work和temp文件夹，把里面的所有内容全部删除，之后重启Tomcat再尝试部署。旧缓存文件和新代码的冲突是这类问题的高发原因。

• 校验WAR包的完整性
  重新下载的代码打包出来的WAR可能存在损坏：你可以手动解压WAR包，检查WEB-INF/lib下的依赖jar是否齐全、WEB-INF/web.xml是否存在且格式正确；也可以重新执行打包命令（比如Maven的mvn clean package），确保打包过程没有报错信息。

• 再次核对Tomcat配置细节
  虽然你说配置和之前一致，但还是可以再确认几个关键项：

  • 检查Tomcatserver.xml里的端口（如8080、8005）是否被其他程序占用，Windows用netstat -ano、Linux/Mac用lsof -i :8080就能查看。
  • 确认conf/tomcat-users.xml里配置了拥有manager-gui或manager-script角色的用户，没有权限也会导致部署失败。
  • 如果是用IDE（IDEA/Eclipse）部署，检查IDE内的Tomcat配置：有没有选错Tomcat版本？部署路径是否指向正确的Tomcatwebapps目录？是否勾选了对应的部署选项（比如“Deploy exploded artifact”或“Deploy WAR file”）。

• 查看Tomcat日志定位具体错误
  “failed to deploy WAR artifact”只是个笼统提示，去Tomcat的logs目录找localhost.log、catalina.out这类日志文件，里面会有详细的报错信息——比如依赖冲突、类找不到、配置文件格式错误等，根据日志才能精准解决问题。

• 尝试手动部署WAR包
  把打包好的WAR文件直接复制到Tomcat的webapps目录下，启动Tomcat看是否能自动解压部署。如果手动部署成功，那问题大概率出在IDE的部署配置上；如果手动也失败，就聚焦在WAR包本身或Tomcat环境的问题上。

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