Eclipse是Java开发中使用最广泛的IDE之一，而Tomcat则是学习和开发Java Web项目时最常见的Servlet容器。想要在Eclipse里跑起一个JSP或者Servlet项目，第一步就是把Tomcat正确地配置到Eclipse中。虽然Tomcat7版本已经不算新，但在很多教学环境和企业遗留项目中仍在大量使用，掌握它的配置方法依然很有必要。整个配置过程可以分为环境准备、Tomcat安装、Eclipse集成、项目发布四个阶段，下面逐步展开讲解。
一、准备工作：JDK与Tomcat7的下载安装
配置Tomcat之前，必须先确保机器上装好了JDK。Tomcat7需要JDK6或以上版本，建议直接使用JDK8，兼容性最好。安装完JDK后需要配置环境变量，包括JAVA_HOME、PATH和CLASSPATH三个。JAVA_HOME指向JDK的安装目录，例如C:\Program Files\Java\jdk1.8.0_202，注意是JDK目录而不是JRE目录。配置完成后打开命令行，输入java -version和javac -version，能正常打印版本号说明JDK环境就绪。
接下来下载Tomcat7。到Apache Tomcat官网的archives归档页面可以找到7.x系列的压缩包，建议下载64-bit Windows zip版本，解压即可使用，无需安装。解压到一个不带中文和空格的路径下，例如D:\apache-tomcat-7.0.109，这一点非常重要，路径含中文或空格经常导致各种莫名其妙的启动失败。验证Tomcat本身是否可用，可以进入bin目录双击startup.bat，然后在浏览器访问http://127.0.0.1:8080，看到Tomcat欢迎页面即表示安装成功。
如果双击startup.bat出现闪退，多数情况是JAVA_HOME没有配置或者指向的路径不对，Tomcat启动脚本依赖这个变量去定位java命令。另外可以检查bin目录下的setclasspath.bat，脚本开头会读取JAVA_HOME和JRE_HOME，确认变量存在即可。
二、Eclipse中添加Tomcat7服务器
如果使用的是Eclipse IDE for Java EE Developers版本，自带Server插件，可以直接配置。如果用的是纯Java SE版本，则找不到Server菜单，需要通过Help菜单的Install New Software安装Web和Server相关组件，或者直接换装Java EE版本的Eclipse，后者更省事。
添加服务器的步骤如下：依次点击Window菜单下的Show View，选择Other，在弹出的对话框中搜索Server并打开Servers视图。在Servers视图的空白处右键，选择New，然后点击Server，在弹出的窗口中展开Apache文件夹，选中Tomcat v7.0 Server。这里的name可以保持默认，Server runtime environment一开始是空的，点击Add按钮进入下一步。
在runtime配置界面，选择Tomcat7的安装目录，也就是前面解压的D:\apache-tomcat-7.0.109，JRE选项保持默认的Java SE版本即可。有个常见问题值得注意：如果Apache列表里根本没有Tomcat v7.0这个选项，通常是Eclipse版本太新（比如最新版的Eclipse IDE for Enterprise Java Developers已经不再内置Tomcat7适配），解决办法是安装老一点的Java EE版本，例如Oxygen或Neon系列，它们对Tomcat7的支持最完整。
还有一种情况是Add and Remove按钮灰色不可点，说明创建的不是动态Web项目，项目Facet里需要勾选Dynamic Web Module，这样项目才具备被发布到服务器的资格。配置完成后，Servers视图中会出现Tomcat v7.0条目，双击它可以打开配置界面，在这里可以修改HTTP/1.1端口号、设置超时时间，还可以切换Server Locations的发布模式。建议选中Use Tomcat installation选项，这样项目会直接部署到Tomcat的webapps目录下，更接近真实生产环境的行为。
三、创建并发布Web项目到Tomcat
服务器配好之后，创建一个动态Web项目验证一下。点击File菜单，选择New，再选Dynamic Web Project，填写项目名，Target Runtime选择刚才配置的Tomcat v7.0，Dynamic web module version选3.0。记得勾选底部的生成web.xml选项，这样项目会自动生成部署描述文件，方便后续配置Servlet映射。
项目创建后，在WebContent目录下新建一个index.jsp文件，写入简单的内容测试：
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>测试页面</title>
</head>
<body>
<h1>Tomcat7配置成功！</h1>
<%
out.println("当前时间：" + new java.util.Date());
%>
</body>
</html>发布项目时，在Servers视图的Tomcat条目上右键，选择Add and Remove，把项目从左侧移动到右侧的Configured列表，点击Finish。然后点击绿色的启动按钮，控制台出现Server startup in xxx ms字样说明启动成功。浏览器访问http://127.0.0.1:8080/项目名/index.jsp，看到页面内容输出即完成整个流程。
需要理解的一点是，Eclipse默认并不会把项目复制到Tomcat的webapps目录，而是发布到工作空间metadata目录下的一个临时目录，通过wtpwebapps文件夹来运行。这就是为什么有时候你打开Tomcat安装目录的webapps找不到自己的项目。想要真实发布到webapps，可以在服务器配置页面的Server Locations区域切换选项，但只有在删除服务器上所有已发布项目之后这个区域才可编辑。
四、常见报错与解决办法
端口占用是最常见的启动失败原因，报错信息通常是Port 8080 was already in use。原因是Tomcat已经在Eclipse外部启动过，或者别的程序占用了8080。解决办法有两个：先关掉外部启动的Tomcat进程，或者修改服务器配置中的端口号，改成8081之类的空闲端口。查端口占用可以在命令行执行netstat -ano | findstr 8080，再结合任务管理器结束对应进程。
控制台中文乱码也困扰很多人，日志里的中文显示成问号。这是因为Eclipse默认编码和Tomcat日志编码不一致，可以打开Windows偏好设置，找到General下的Workspace，把Text file encoding改成UTF-8。如果JSP页面本身乱码，则要确认page指令中的pageEncoding属性是UTF-8，同时项目属性里的资源编码也设置为UTF-8。
启动时报Several ports (8005, 8080, 8009) required by Tomcat v7.0 Server are already in use，说明Eclipse里启动了一个Tomcat实例，外部又启动了一个，两个实例抢端口。Eclipse中的Tomcat和命令行的startup.bat本质是同一个Tomcat，不能同时运行。还有一种情况是启动后访问项目报404，需要检查项目是否真正部署成功，在Servers视图双击Tomcat打开配置页，查看Modules页签里有没有项目对应的Web Module条目，没有的话重新Add and Remove一遍即可。
另外要提醒的是JDK版本匹配问题。如果用很高版本的JDK（比如JDK17）去跑Tomcat7，可能会出现模块化相关的异常，因为Tomcat7诞生时还没有JPMS机制。稳妥的组合是JDK8加Tomcat7，这也是教学环境中最常见的搭配。配置过程中遇到问题优先看控制台的完整报错堆栈，绝大多数失败原因都能从日志里找到线索。
Eclipse配置TomcatTomcat7Eclipse Tomcat服务器修改时间：2026-09-08 18:46:59