Eclipse部署Tomcat REST应用报404错误求助（手动部署正常）

我之前也碰到过一模一样的情况，手动部署好好的，一用Eclipse就报404，给你几个具体的排查和解决步骤，应该能搞定：

• 检查Eclipse的部署资源映射
  右键你的项目 → Properties → Deployment Assembly，这里要确保所有关键资源都正确映射到部署路径：比如src/main/java编译后的class文件要映射到WEB-INF/classes，src/main/webapp的静态资源和配置文件要映射到根路径/，还有依赖的jar包也要对应到WEB-INF/lib。有时候Eclipse会自动漏掉某些目录，导致部署的war包不完整，这肯定会触发404。

• 确认Tomcat服务器的部署路径设置
  打开Eclipse的Servers视图，右键你的Tomcat服务器 → Open，在Server Locations区域，除了选Use Tomcat Installation，还要确认Deploy path是不是webapps（和你手动部署的目录一致）。如果之前改过这个设置，建议先把服务器上的项目全部移除（右键服务器 → Add and Remove...），然后清理服务器（右键 → Clean...），再重新添加部署项目。

• 彻底清理缓存文件
  缓存是这类问题的重灾区：

  1. 先清理项目：顶部菜单栏 Project → Clean...，选中你的项目，清理编译生成的旧class文件；
  2. 清理Tomcat服务器：右键服务器 → Clean...，这会删除Eclipse管理的部署目录（比如wtpwebapps）里的旧文件；
  3. 手动去Tomcat安装目录，删除work和temp文件夹，这两个文件夹存的是缓存的类和临时文件，有时候会导致类加载异常。

• 核对项目的上下文根配置
  右键项目 → Properties → Web Project Settings，检查Context Root是不是和你手动部署时的访问路径一致。比如你手动部署后访问的是http://localhost:8080/，那Context Root必须设为/；如果是http://localhost:8080/my-rest-app，那Context Root就要改成my-rest-app。Eclipse部署时会用这个配置生成Tomcat的上下文，路径不对肯定会404。

• 验证部署后的文件结构
  部署完成后，去Tomcat的webapps（你设置的Deploy path）目录下找到你的项目文件夹，对比手动部署的文件结构：看看有没有WEB-INF/classes（里面要有你的REST接口类）、WEB-INF/lib（依赖的jax-rs相关jar包必须在这）、还有web.xml或者你的JAX-RS Application子类配置文件。如果这些关键文件缺失，说明Eclipse部署时没把它们打包进去。

• 查看Tomcat日志找线索
  最后去Tomcat的logs目录，打开catalina.out或者localhost.log，看看部署过程中有没有报错信息——比如类找不到、配置文件解析失败、REST端点注册异常。有时候服务器看起来启动成功，但实际上应用初始化失败，端点根本没注册，自然就会返回404。

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