Eclipse配置Tomcat加载Spring项目web.xml首页失败如何解决

按以下顺序逐一排查操作：

• 校验项目 facet 配置
  右键项目打开Properties -> Project Facets，确认勾选Dynamic Web Module，版本与本地Tomcat版本匹配（Tomcat9对应4.0，Tomcat10对应5.0）；同时勾选Java，版本与项目编译使用的JDK版本保持一致。

  导入的第三方Maven项目默认不会自动开启Dynamic Web Module，这是Tomcat无法识别web.xml、加载不到首页的最高频原因。

• 修正部署映射配置
  进入项目Properties -> Deployment Assembly，确认存在以下映射规则：
  • /src/main/java 映射到 WEB-INF/classes
  • /src/main/resources 映射到 WEB-INF/classes
  • /src/main/webapp 映射到 /
  • Maven Dependencies 映射到 WEB-INF/lib
    缺失的规则点击Add手动添加，配置错误的规则删除后重建即可。
• 校验web.xml合法性
  确认web.xml存放路径为/src/main/webapp/WEB-INF/web.xml，文件中<welcome-file-list>标签配置的首页文件真实存在于webapp对应目录，无路径拼写错误；同时检查web.xml头部声明的xsd版本与之前配置的Dynamic Web Module版本一致，避免版本不匹配导致解析失败。
• 全量清理缓存后重新部署
  1. 打开Servers视图，右键对应Tomcat实例选择Clean，清空Tomcat工作目录缓存
  2. 右键项目 -> Run As -> Maven clean，执行完成后再执行Maven install，不需要跑测试的话在Goal里加-Dmaven.test.skip=true参数
  3. 将项目从Tomcat部署列表中移除，重新添加后启动Tomcat
• 根据错误日志定位根因
  如果上述操作后仍启动失败，直接看日志最底部的Caused by字段：
  • 报ClassNotFoundException/NoClassDefFoundError：回到第二步检查Maven依赖的部署映射是否配置正确
  • 报web.xml不存在/解析错误：检查web.xml路径、文件头版本配置
  • 报端口被占用：结束占用Tomcat默认端口（8080、8005、8009）的进程后重启服务

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