Eclipse 配置 Tomcat 服务器详细教程
本教程将引导你完成在 Eclipse IDE 中配置和使用 Apache Tomcat 服务器的所有步骤。
第一步：准备工作
在开始之前,请确保你已经准备好以下两样东西：
-
Java Development Kit (JDK):
- Tomcat 是一个 Java 应用，因此你需要安装 JDK。
- 确保你的系统环境变量
JAVA_HOME已正确设置，指向你的 JDK 安装目录。
-
Apache Tomcat 服务器:
- 访问 Apache Tomcat 官网 下载最新稳定版。
- 根据你的操作系统选择对应的版本（Windows 下的
zip或64-bit Windows zip）。 - 重要提示：下载 Core 部分的
zip压缩包即可，不需要下载exe安装包，因为 Eclipse 会自己管理 Tomcat。
-
Eclipse IDE:
（图片来源网络，侵删）- 确保你安装的是 Eclipse IDE for Enterprise Java and Web Developers (或包含 Web 和 EE 开发功能的版本)，因为它们自带了 Tomcat 插件。
第二步：将 Tomcat 添加到 Eclipse
这是配置的核心步骤，目的是让 Eclipse 识别并管理你的 Tomcat 服务器。
-
打开 Eclipse，切换到 Java EE 或 Spring 透视图（通常在右上角可以切换）。
-
打开服务器配置窗口:
- 点击顶部菜单栏的 Window -> Show View -> Servers。
- 如果已经打开了 Servers 视图，可以在 Eclipse 窗口底部的标签栏中找到它。
-
创建新服务器:
（图片来源网络，侵删）- 在打开的 Servers 视图中，你会看到一个链接 "No servers available. Click this link to create a new server."（没有可用服务器，点击此链接创建新服务器）。
- 点击这个链接，或者直接点击 Servers 视图右上角的 "No servers" 文本旁的 向下小箭头，然后选择 New -> Server。
-
选择服务器类型和版本:
- 在弹出的 New Server 窗口中，展开左侧的 Apache 文件夹。
- 选择 Tomcat v9.0 Server (或你下载的对应版本)。
- 点击 Next >。
-
指定 Tomcat 安装目录:
- 这是最关键的一步，Eclipse 需要知道你的 Tomcat 解压后放在哪里。
- 在 "Tomcat installation directory" 字段旁边，点击 Browse... 按钮。
- 选择你之前下载并解压的 Tomcat 文件夹（
D:\apache-tomcat-9.0.65）。 - 注意：确保选择的是包含
bin,conf,webapps等文件夹的根目录。 - 当你选择好目录后，Eclipse 会自动检测并填充 "Configuration directory"，通常它和安装目录是同一个,保持默认即可。
-
完成配置:
- 点击 Finish。
- 你的 Servers 视图中就会出现你刚刚创建的 Tomcat 服务器实例。
第三步：配置服务器运行时环境 (Runtime)
这一步是为了确保你的 Web 项目能够使用正确的 JDK 版本编译和运行。
-
在 Servers 视图中，右键单击你刚刚创建的 Tomcat 服务器（
Tomcat v9.0 Server at localhost）。 -
选择 Open。
-
在打开的配置页面中，你会看到 "Server Options" 和 "Runtime Environments"。
-
在 "Runtime Environments" 部分，点击 "Add..." 按钮。
-
在弹出的窗口中，不要 选择 "Add JARs..."，而是点击 "Alternate JRE" 旁边的 "Installed JREs..."。
-
在 "Installed JREs" 窗口中，确保你已勾选了正确的 JDK，如果没有，点击 "Add..." 添加你的 JDK 路径。
-
返回到 "Add Server Runtime Environment" 窗口，从下拉菜单中选择你刚刚确认的 JDK。
-
点击 Finish，然后再次点击 OK 保存服务器配置。
现在你的服务器已经配置完成，并且指向了正确的 JDK。
第四步：部署 Web 项目到 Tomcat
将你的动态 Web 项目部署到配置好的服务器上。
-
确保项目是 Dynamic Web Project:
- 如果你的项目不是，右键单击项目 -> Configure -> Convert to a Dynamic Web Project。
- 在项目属性中（右键项目 -> Properties），确保 "Project Facets" 中勾选了 "Dynamic Web Module"，并且版本与你的 Tomcat 版本兼容（Tomcat 9 对应 3.0）。
-
部署项目:
-
拖拽部署 (最简单)
- 在 Project Explorer 或 Package Explorer 视图中，直接将你的 Web 项目文件夹拖拽到 Servers 视图中的 Tomcat 服务器上。
- 在弹出的窗口中，选择 "Copy project into the server's configuration" (推荐，这样项目文件和服务器配置分离)，然后点击 Finish。
-
通过服务器配置部署
- 在 Servers 视图中，双击打开你的 Tomcat 服务器配置页面。
- 在 "Available" (可用) 列表中，找到你的 Web 项目，点击它，然后点击中间的 "Add >" 按钮，将其移动到 "Configured" (已配置) 列表中。
- 点击右下角的 Apply and Close。
-
第五步：启动服务器并运行项目
-
启动 Tomcat:
- 在 Servers 视图中，右键单击你的 Tomcat 服务器。
- 选择 Start。
-
查看控制台输出:
- Tomcat 启动时，你会看到一系列日志信息输出在 Eclipse 的 Console 视图中。
- 当你看到
INFO: Server startup in XXX ms这样的信息时,表示服务器已成功启动。
-
访问你的应用:
- 打开你的 Web 浏览器，访问
http://localhost:8080/你的项目名/。 - 如果你的项目名叫
MyWebApp，那么访问地址就是http://localhost:8080/MyWebApp/。 - 如果看到你的项目首页，恭喜你,配置完全成功！
- 打开你的 Web 浏览器，访问
常见问题与解决方案
问题 1: Failed to configure a connector
- 现象: 启动服务器时，Console 提示
Failed to configure a connector或Port 8080 is already in use。 - 原因: 8080 端口被其他程序占用了，最常见的情况是你已经启动了一个 Tomcat 实例，或者有其他软件（如 Skype、微信、迅雷等）占用了这个端口。
- 解决方案:
- 关闭其他 Tomcat: 确保没有其他命令行或后台的 Tomcat 实例在运行。
- 修改端口:
- 在 Servers 视图中，双击你的 Tomcat 服务器打开配置。
- 在 "HTTP port" 字段中，将
8080修改为其他未被占用的端口，8081。 - 点击 Apply and Close,然后重新启动服务器。
问题 2: 部署后访问 404 Not Found
- 现象: 服务器启动成功，但访问
http://localhost:8080/MyWebApp/时出现 404 错误。 - 原因:
- 项目部署路径不正确。
- 项目的
web.xml文件配置有误。 - 项目的上下文路径 设置错误。
- 解决方案:
- 检查部署路径:
- 双击服务器打开配置，在 "Overview" 页面，点击 "Hyperlink to server configuration"。
- 这会打开服务器的配置目录（通常是
workspace\.metadata\.plugins\org.eclipse.wst.server.core\tmp0\conf）。 - 用记事本打开
server.xml文件，找到<Context>标签，检查docBase属性是否指向了你的项目在服务器
- 检查部署路径:
