第一步:准备工作(环境与软件)
在开始之前,请确保你已经安装了以下软件:

(图片来源网络,侵删)
- JDK (Java Development Kit): Tomcat 是一个 Java 应用,必须依赖 JDK,请确保你的系统已正确安装 JDK,并配置好
JAVA_HOME环境变量。 - Eclipse IDE: 任何版本的 Eclipse IDE for Java EE Developers 或 Eclipse IDE for Enterprise Java and Web Developers 都可以,它们自带了服务器管理功能。
- Apache Tomcat: 从 Apache Tomcat 官网 下载你需要的版本,对于初学者,推荐 Tomcat 9 或 10,下载后解压到一个不含空格和中文的路径,
D:\dev\apache-tomcat-9.0.85。
第二步:在 Eclipse 中配置 Tomcat 服务器
这是整个配置过程的核心。
通过 Eclipse 的 Server 视图(推荐)
这是最标准、最推荐的方法。
-
打开 Server 视图
- 在 Eclipse 菜单栏中,选择
Window->Show View->Server。 - 如果已经打开,可以在 Eclipse 底部的标签页中找到 "Server" 视图。
- 在 Eclipse 菜单栏中,选择
-
创建新服务器
(图片来源网络,侵删)- 在 "Server" 视图中,右键点击空白处,选择
New->Server。 - 或者,点击视图中的
No servers available. Click this link to create a new server链接。
- 在 "Server" 视图中,右键点击空白处,选择
-
选择服务器类型和版本
- 在弹出的 "New Server" 窗口中,展开左侧的
Apache文件夹。 - 选择
Tomcat v9.0 Server(或你下载的对应版本)。 - 在右侧的 "Server runtime environments" 区域,点击
Browse...按钮。
- 在弹出的 "New Server" 窗口中,展开左侧的
-
指定 Tomcat 安装目录
- 在弹出的窗口中,点击
Add...按钮。 - 在 "Apache Tomcat Installation" 窗口中,点击
Directory...按钮,然后选择你之前解压的 Tomcat 根目录(D:\dev\apache-tomcat-9.0.85)。 - Eclipse 会自动检测 Tomcat 的版本,并显示在 "Name" 和 "Tomcat installation directory" 字段中,确认无误后,点击
Finish。
- 在弹出的窗口中,点击
-
完成服务器创建
- 返回到 "New Server" 窗口,"Server runtime environments" 区域已经显示了你刚刚添加的 Tomcat 环境。
- 在 "Server name" 字段中,可以保留默认名称,也可以自定义一个你喜欢的名字。
- 在 "Server path" 字段中,会自动生成一个工作目录(用于存放临时文件、部署的项目等),通常保持默认即可。
- 点击
Finish。
-
验证配置
(图片来源网络,侵删)- 你的 "Server" 视图中应该已经出现了你创建的 Tomcat 服务器。
- 选中它,右键点击,选择
Add and Remove...。 - 在弹出的窗口中,左侧是 "Available"(你项目中可部署的内容),右侧是 "Configured"(已配置到服务器上的内容),此时两边都是空的,因为我们还没有任何项目。
- 点击
Close,然后右键点击服务器,选择Start。 - 如果一切正常,控制台会打印出 Tomcat 启动的信息,并显示 "Server Apache Tomcat v9.0 ... started successfully"。
- 打开浏览器,访问
http://localhost:8080,如果能看到 Tomcat 的欢迎页面,说明配置成功!
第三步:将 Web 项目部署到 Tomcat
有几种方法可以将你的项目部署到已配置的 Tomcat 服务器上。
通过 Server 视图部署(最常用)
- 在 "Server" 视图中,右键点击你的 Tomcat 服务器。
- 选择
Add and Remove...。 - 在弹出的窗口中,从左侧 "Available" 列表中选择你的 Web 项目(确保项目的 Deployment 配置是正确的,见下面的“注意事项”),然后点击
Add >将其移动到右侧 "Configured" 列表。 - 点击
Finish或OK。
Eclipse 会自动将项目部署到 Tomcat 的 webapps 目录下,并重新启动服务器。
通过项目属性部署
- 在 "Project Explorer" 或 "Package Explorer" 中,右键点击你的 Web 项目。
- 选择
Properties(属性)。 - 在左侧导航栏中,选择
Project Facets(项目方面)。 - 确保
Dynamic Web Module已被勾选,如果未勾选,请勾选它,然后点击Further configuration available...链接。 - 在弹出的窗口中,设置
Content directory(通常是src/main/webapp或WebContent),然后点击OK。 - 回到 "Properties" 窗口,点击左侧的
Deployment Assembly(部署装配)。 - 在右侧列表中,确保你的 Web 内容目录(如
src/main/webapp)已经存在,如果没有,点击Add...->Folder->Next,选择你的 Web 内容目录,点击Finish。 - 点击
Apply and Close。
完成这些配置后,你的项目就可以通过方法一部署到服务器了。
手动部署(热部署)
- 在 Eclipse 中,右键点击你的 Tomcat 服务器,选择
Publish(发布)。 - Eclipse 会将服务器的工作目录(在第二步第5步中设置)下的内容同步到 Tomcat 的
webapps目录,你可以手动将项目的 WAR 包或文件夹复制到 Tomcat 的webapps目录下。 - 复制完成后,重启 Tomcat 服务器即可。
第四步:运行和调试
-
运行:
- 在 "Server" 视图中,右键点击你的 Tomcat 服务器,选择
Start。 - 服务器启动后,在浏览器中访问
http://localhost:8080/你的项目名即可。
- 在 "Server" 视图中,右键点击你的 Tomcat 服务器,选择
-
调试:
- 在 "Server" 视图中,右键点击你的 Tomcat 服务器,选择
Debug As->Debug on Server。 - Eclipse 会切换到 "Debug" 透视图,并在服务器启动后自动在浏览器中打开你的项目。
- 你可以在你的 Java 代码中设置断点,服务器在执行到断点时会暂停,让你可以检查变量、调用栈等信息。
- 在 "Server" 视图中,右键点击你的 Tomcat 服务器,选择
常见问题与注意事项
- 端口冲突: 8080 端口被其他程序占用,Tomcat 将无法启动,你可以在
Server视图中双击你的服务器,在 "Overview" 页面中修改HTTP port(如改为 8081)。 - Server runtime environments 为空: 如果在创建服务器时,
Browse...按钮后的列表为空,说明 Eclipse 没有检测到你系统中安装的 Tomcat,请确保你按照第二步的第4步操作,正确地 "Add" 了 Tomcat 的安装目录。 - 项目无法添加到服务器: 这通常是因为项目的 "Project Facets" 或 "Deployment Assembly" 配置不正确,请参考第三步的方法二进行配置。
- 修改 server.xml 后不生效: Eclipse 默认会忽略你直接修改 Tomcat 安装目录下的
conf/server.xml文件,如果你需要修改配置(如添加连接器),最好在 Eclipse 的 "Server" 视图中双击服务器,在 "Overview" -> "HTTP" 或 "SSL" 等标签页中进行修改,这样配置会保存在 Eclipse 的工作目录中,而不是覆盖 Tomcat 原始文件。 - JDK 版本不匹配: 确保你配置的 Tomcat 版本与你安装的 JDK 版本兼容,Tomcat 9/10 推荐使用 JDK 8/11/17。
希望这份详细的指南能帮助你成功在 Eclipse 中配置 Tomcat 服务器!
