手动生成并部署WAR包至Tomcat终端操作出错排查

听起来你遇到的问题挺典型的——Eclipse里部署运行一切正常，手动打包WAR就出状况了，核心原因几乎肯定是手动打包的WAR目录结构和Eclipse自动部署的结构不一致，导致访问路径多了一层WebContent，顺带也搞乱了REST服务的路径映射。我给你一步步拆解解决：

一、先搞懂问题根源 #

Eclipse部署Web项目时，会自动把WebContent文件夹里的内容作为WAR的根目录（也就是部署到Tomcat后，forum应用的根路径对应的就是WebContent里的文件）。但你手动打包时，大概率是直接把整个项目目录打包了，导致WAR里多了一层WebContent文件夹——所以访问时必须加上这个前缀才能找到文件，REST服务的路径自然也跟着错了。

二、手动打包WAR的正确姿势 #

步骤1：整理项目文件 #

先确保你的项目里：

• Java类已经编译完成，编译后的.class文件都放在WebContent/WEB-INF/classes目录下（如果没编译，先在Eclipse里执行一次Clean Build，或者用javac命令手动编译）
• WebContent目录下包含所有前端静态文件（html/css/js）、WEB-INF（里面有web.xml、lib包等）这些核心内容

步骤2：用jar命令正确打包 #

别在项目根目录直接打包！要进入WebContent目录再执行打包命令：

# 先cd到你的WebContent目录
cd /path/to/your/project/WebContent
# 打包生成WAR到上级目录（项目根目录）
jar -cvf ../forum.war .

这里的.表示把当前目录（WebContent）下的所有内容都打进WAR包，这样生成的forum.war根目录就是WebContent里的内容，和Eclipse部署的结构完全一致。

步骤3：验证WAR结构 #

把生成的forum.war解压，检查根目录里是不是直接有homepage.html、WEB-INF这些文件，而不是嵌套在WebContent文件夹里——这一步很关键，确认结构对了再部署到Tomcat。

三、REST服务问题的修复 #

当WAR结构正确后，REST服务的路径应该和Eclipse里一致了。如果还是有问题，检查这几点：

• 确认web.xml里的Servlet映射路径（比如REST的入口servlet）有没有硬编码错误，比如是不是写成了/WebContent/rest/*这种错误路径
• 如果你用了Spring MVC/JAX-RS这类框架，检查@RequestMapping或者@Path注解里的路径有没有多余的层级，确保是基于应用根路径（/forum）的相对路径
• 查看Tomcat的日志（logs/catalina.out），看有没有类找不到或者路径映射错误的异常信息，根据日志定位问题

四、额外注意事项 #

• 如果你的项目用了Maven/Gradle这类构建工具，建议直接用插件打包（比如Maven的war:war命令），配置好webappDirectory指向WebContent，这样能避免手动打包的错误
• 每次打包前最好先清理旧的WAR包和编译文件，避免缓存干扰

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