第一步：准备工作（下载必要软件）
在开始之前,请确保你已经下载并安装了以下软件：
（图片来源网络，侵删）
-
JDK (Java Development Kit):
- Tomcat 是一个 Java 应用，所以必须安装 JDK。
- 下载地址：Oracle JDK 官网 或 OpenJDK 官网。
- 安装并配置好环境变量
JAVA_HOME。
-
Apache Tomcat:
- 下载 Tomcat 的二进制发行版 (zip 或 tar.gz 格式)。
- 下载地址：Tomcat 官网 (推荐下载 Tomcat 9 或 10)。
- 下载后,解压到你喜欢的目录，
D:\apache-tomcat-9.0.82，这个目录我们称之为CATALINA_HOME。
-
Eclipse IDE:
- 下载并安装 Eclipse IDE for Enterprise Java and Web Developers (俗称 EE 版本)，因为它内置了 Web 开发功能。
- 下载地址：Eclipse 官网。
第二步：在 Eclipse 中配置 Tomcat 服务器
这一步是核心,将你下载的 Tomcat 服务器“告诉”给 Eclipse。
（图片来源网络，侵删）
-
打开 Eclipse，进入菜单栏，选择 Window -> Preferences... (在 macOS 上是 Eclipse -> Preferences...)。
-
在弹出的偏好设置窗口中,展开左侧的 Server -> Runtime Environments，然后点击右侧的 Add... 按钮。
-
选择服务器类型：
- 在弹出的窗口中,选择你下载的 Tomcat 版本，如果你下载的是 Tomcat 9，就选择 Apache Tomcat v9.0。
- 点击 Next。
-
指定 Tomcat 安装目录：
（图片来源网络，侵删）- 在 Apache Tomcat directory 字段中，点击 Browse... 按钮，然后选择你第一步中解压的 Tomcat 目录（即
CATALINA_HOME）。 - Eclipse 会自动检测并填写 JRE 字段，如果检测不到，你可以点击 Installed JREs... 按钮手动添加你安装的 JDK。
- 点击 Finish。
- 在 Apache Tomcat directory 字段中，点击 Browse... 按钮，然后选择你第一步中解压的 Tomcat 目录（即
-
验证配置：
- 点击 Finish 后，你会返回到 Preferences 窗口，并且新添加的 Tomcat 版本会出现在列表中。
- 点击 Apply and Close 保存设置。
第三步：创建一个动态 Web 项目
为了测试服务器是否配置成功,我们需要创建一个 Web 项目。
-
在 Eclipse 菜单栏中，选择 File -> New -> Dynamic Web Project。
-
配置项目信息：
- Project name: 输入你的项目名称，
HelloTomcat。 - Target runtime: 这是最关键的一步！ 点击旁边的 New Runtime... 按钮。
- 在弹出的窗口中,选择你刚刚在 Eclipse 中配置好的 Tomcat 版本（
Apache Tomcat v9.0），然后点击 Next。 - 确保 Apache Tomcat directory 指向的是正确的路径，然后点击 Finish。
- 回到新建项目窗口,你会发现 Target runtime 字段已经被自动选中了。
- Configuration: 你可以选择一个特定的配置，
Java EE 8 Web Profile，保持默认即可。 - 点击 Finish。
- Project name: 输入你的项目名称，
第四步：部署并运行项目
你的项目已经创建好了,并且与 Tomcat 关联，我们将它部署到 Tomcat 服务器上并运行。
-
打开服务器视图：
- 在 Eclipse 窗口的右下角，找到并点击 Servers 标签页，打开 Servers 视图，如果找不到，可以通过菜单栏 Window -> Show View -> Servers 来打开。
-
添加项目到服务器：
- 在 Servers 视图中，你会看到一个名为 "Tomcat v9.0 Server at localhost" 的服务器实例，但它可能是空的（没有项目）。
- 方法一（推荐）: 直接从 Project Explorer (项目资源管理器) 或 Package Explorer (包资源管理器) 中，将你刚刚创建的
HelloTomcat项目 拖拽 到 Servers 视图的服务器上。 - 方法二: 双击 Servers 视图中的服务器实例，在弹出的窗口中，点击右侧的 Add... 按钮，然后选择你的 Web 项目并点击 Finish。
-
启动服务器：
- 在 Servers 视图中，右键点击你的 Tomcat 服务器实例。
- 在弹出的菜单中选择 Start。
-
观察运行状态：
- Eclipse 会开始编译项目，并启动 Tomcat 服务器，你会看到 Console 视图中打印出 Tomcat 的启动日志。
- 当日志中出现
INFO: Server startup in ... ms时，表示服务器启动成功。
第五步：验证结果
服务器启动后,最直接的验证方式就是通过浏览器访问。
-
获取访问地址：
- Tomcat 默认运行在 8080 端口。
- 你的项目
HelloTomcat是部署在 Tomcat 的根路径下的，所以访问地址是：http://localhost:8080/HelloTomcat/
-
创建一个测试页面：
- 如果项目是空的,可能访问会 404，让我们创建一个简单的
index.jsp来测试。 - 在
HelloTomcat项目中，找到WebContent(或webapp) 文件夹。 - 右键点击
WebContent-> New -> JSP File。 - 文件名输入
index.jsp，然后点击 Finish。 - 在打开的
index.jsp文件中，输入以下代码：<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Tomcat Test Page</title> </head> <body> <h1>Hello, Tomcat! from Eclipse!</h1> <p>当前时间: <%= new java.util.Date() %></p> </body> </html> - 保存文件。
- 如果项目是空的,可能访问会 404，让我们创建一个简单的
-
访问页面：
- 打开你的浏览器,访问
http://localhost:8080/HelloTomcat/。 - 如果一切顺利,你应该能看到你刚才创建的 "Hello, Tomcat!" 页面，并且会显示当前服务器时间。
- 打开你的浏览器,访问
总结与常见问题
总结流程：
- 下载 JDK、Tomcat、Eclipse。
- 配置：在 Eclipse 的
Preferences中配置 Tomcat 的运行环境。 - 创建：创建一个
Dynamic Web Project，并在创建时关联上一步配置的 Tomcat。 - 部署：将项目添加到 Eclipse 的
Servers视图中。 - 运行：在
Servers视图中启动 Tomcat。 - 验证：通过浏览器访问项目地址。
常见问题及解决方案：
-
问题1：启动服务器时报错 "Port 8080 required by Tomcat v9.0 Server is already in use."
- 原因：端口 8080 被其他程序占用（可能是另一个正在运行的 Tomcat 实例，或者其他软件如 Skype、微信等）。
- 解决：
- 关闭所有可能占用 8080 端口的程序。
- 或者修改 Tomcat 的端口，在 Tomcat 的
conf/server.xml文件中，找到<Connector port="8088" ... />这一行，将8088改成其他未被占用的端口（如 8081），然后重启服务器。
-
问题2：项目发布后访问 404 (Not Found)
- 原因：
- 访问的 URL 路径不正确，确保路径是
http://localhost:8080/你的项目名/。 - 项目没有正确部署到
webapps目录下，检查CATALINA_HOME/webapps目录下是否有你的项目文件夹。 index.jsp
- 访问的 URL 路径不正确，确保路径是
- 原因：
