如何将Eclipse中的Maven项目部署到Tomcat服务器并显示欢迎页？

我来给你梳理几个大概率能解决问题的方向，都是处理这类场景的常用排查路径：

1. 先确认访问路径是否正确 #

嵌入式Tomcat默认会把你的项目部署成ROOT应用，所以直接访问http://localhost:8080/就能命中。但独立Tomcat不一样：

• 如果你的war包名字不是ROOT.war，那部署后访问路径应该是http://localhost:8080/你的项目名/，比如war包叫myapp.war，就得访问http://localhost:8080/myapp/；
• 你可以去Tomcat的webapps目录看看，你的项目是不是在ROOT文件夹下，如果不是，要么把war包重命名为ROOT.war，要么在conf/server.xml里配置<Context>标签将你的项目映射为ROOT。

2. 检查web.xml的欢迎页配置 #

你提到有web.xml，先确认里面的欢迎页配置是否符合规范：

标准的欢迎页配置示例：

<welcome-file-list>
    <welcome-file>index.html</welcome-file>
    <welcome-file>index.jsp</welcome-file>
    <!-- 如果用了Spring MVC等框架，可能需要添加框架入口页面，比如index.action -->
</welcome-file-list>

• 注意：欢迎页不能放在WEB-INF目录下，Tomcat无法直接访问该目录下的资源，必须把页面放在webapp根目录或指定的静态资源目录；
• 如果用了Spring MVC这类框架，还要确认有没有配置根路径的请求映射，比如Controller里的@RequestMapping("/")，嵌入式Tomcat可能自动帮你做了适配，但独立Tomcat需要明确配置。

3. 从Tomcat日志里找线索 #

去Tomcat的logs目录，重点看这几个日志文件：

• localhost.log：记录项目启动和请求处理的报错信息；
• localhost_access_log.*.txt：查看访问http://localhost:8080/时的状态码，比如是不是404，有没有请求转发异常；
• catalina.out：全局日志，能看到项目启动时的依赖缺失、web.xml解析错误等问题。

4. 验证项目打包结构是否合规 #

Maven打包后的war包必须符合Java Web规范，嵌入式Tomcat可能对结构要求宽松，但独立Tomcat很严格：

• 根目录必须有WEB-INF文件夹，里面包含web.xml、classes（编译后的class文件）和lib（依赖jar包）；
• 欢迎页、静态资源要放在war包根目录，不能嵌套在其他子文件夹里。
  你可以用解压工具打开war包，检查结构是否符合要求。

5. 确认Tomcat版本与项目的兼容性 #

项目的Servlet版本必须和Tomcat版本匹配：

• 查看web.xml根标签里的版本，比如version="3.1"对应Servlet 3.1；
• Tomcat版本对应关系：Tomcat7→Servlet3.0，Tomcat8→Servlet3.1，Tomcat9→Servlet4.0，Tomcat10→Servlet5.0。如果版本不兼容，会导致启动异常或资源无法访问。

6. 检查静态资源访问限制 #

有时候Tomcat的默认配置或你自己的web.xml配置会限制静态资源访问：

• 尝试直接访问欢迎页的完整路径，比如http://localhost:8080/index.html，如果能打开，说明是默认欢迎页的配置问题；如果不能，说明静态资源的访问被限制了，检查web.xml里的<security-constraint>或Tomcat的conf/web.xml配置。

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