Eclipse JSP/Servlet 环境搭建：从零开始构建你的 Java Web 开发起点

如果你正在学习 Java Web 开发，那么 Eclipse JSP/Servlet 环境搭建 是你迈出的第一步。它就像盖房子前的地基，虽然不显眼，但决定着整个项目的稳定性和可扩展性。对于初学者来说，可能一听到“配置环境”就头疼，担心命令行出错、依赖冲突、路径不对……其实，只要按照清晰的步骤走，这个过程完全可以变得简单而顺畅。

本文将带你一步步完成 Eclipse JSP/Servlet 环境搭建，涵盖 JDK 安装、Eclipse 配置、Tomcat 集成、项目创建与运行测试。每一步都有详细说明和代码注释，确保你能真正理解背后的原理，而不是盲目复制粘贴。

准备工作：环境依赖与工具下载

在动手搭建之前，我们需要确认几个核心组件都已就位。这就像准备烹饪前检查食材是否齐全一样。

JDK 安装与环境变量配置

首先，你需要安装 JDK（Java Development Kit），它是编写和运行 Java 程序的基础。推荐使用 Java 8 或 Java 11，这两个版本在企业级项目中依然广泛使用。

前往 Oracle 官方下载页 或 OpenJDK 官网 下载对应系统的 JDK 版本。

安装完成后，打开终端（Windows 用 CMD 或 PowerShell，Mac/Linux 用 Terminal）输入以下命令检查版本：

java -version

如果输出类似 java version "1.8.0_362"，说明安装成功。

接着配置环境变量（以 Windows 为例）：

右键“此电脑” → “属性” → “高级系统设置” → “环境变量”

在“系统变量”中新建：

变量名：JAVA_HOME

变量值：C:\Program Files\Java\jdk1.8.0_362（请根据你的实际安装路径修改）

编辑 Path 变量，添加 %JAVA_HOME%\bin

✅ 小贴士：JAVA_HOME 是一个“指向 JDK 安装目录的快捷方式”，Eclipse 和 Tomcat 都会读取它来定位 Java 运行环境。

安装与配置 Eclipse IDE

Eclipse 是一个开源的集成开发环境（IDE），特别适合 Java 开发。它能帮你自动管理项目结构、语法提示、调试等功能，极大提升开发效率。

下载与安装 Eclipse

访问 Eclipse 官网 ，选择 Eclipse IDE for Enterprise Java and Web Developers（这是包含 JSP/Servlet 支持的版本）。

下载对应操作系统的安装包（Windows 64-bit、Mac、Linux 等）。

解压后运行 eclipse.exe（Windows）或 eclipse（Mac/Linux）即可启动。

⚠️ 注意：不要将 Eclipse 安装在包含中文或空格的路径下，比如 D:\我的文档\eclipse，容易导致项目路径出错。

集成 Apache Tomcat 服务器

Tomcat 是一个开源的 Servlet 容器，负责运行你编写的 JSP 和 Servlet。你可以把它想象成“Web 应用的运行车间”——没有它，你的网页代码无法在浏览器中打开。

下载并配置 Tomcat

访问 Apache Tomcat 官网 下载 Tomcat 10.x（推荐）或 Tomcat 9.x。

解压到一个固定目录，例如：D:\apache-tomcat-10.1.10

在 Eclipse 中，进入菜单栏：Window → Preferences → Server → Runtime Environments

点击 Add...，选择 Apache Tomcat v10.1（根据你下载的版本选择）

设置 Tomcat installation directory 为你的解压路径，如 D:\apache-tomcat-10.1.10

点击 Finish 完成配置

📌 重要提示：确保 Tomcat 的 bin 目录下有 catalina.bat（Windows）或 catalina.sh（Linux/Mac），这是启动服务器的关键文件。

创建第一个 JSP/Servlet 项目

现在环境已经准备就绪，我们来创建一个最基础的 Web 项目，验证一切是否正常工作。

新建 Dynamic Web Project

在 Eclipse 中，点击 File → New → Dynamic Web Project

输入项目名称，如 HelloWeb

选择 Target runtime 为之前配置的 Tomcat 10.1

确保 Dynamic web module version 为 5.0（对应 Servlet 5.0，JSP 3.1）

点击 Finish

Eclipse 会自动生成以下目录结构：

WebContent/：存放 JSP 页面、HTML、CSS、JS 等前端资源

src/：存放 Java 源代码（Servlet 类）

WEB-INF/：存放配置文件，如 web.xml、lib/（第三方库）

编写第一个 Servlet

在 src/ 目录下右键 → New → Class，创建一个名为 HelloServlet.java 的类。

// HelloServlet.java：一个简单的 Servlet 示例

// 它继承自 HttpServlet，是处理 HTTP 请求的核心类

// @WebServlet 注解用于声明该 Servlet 的访问路径

// 通过 doGet 方法响应 GET 请求，输出“Hello, World!”

import javax.servlet.annotation.WebServlet;

import javax.servlet.http.HttpServlet;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

import java.io.IOException;

import java.io.PrintWriter;

@WebServlet("/hello") // 访问路径：http://localhost:8080/HelloWeb/hello

public class HelloServlet extends HttpServlet {

// 处理 GET 请求的方法

@Override

protected void doGet(HttpServletRequest request, HttpServletResponse response)

throws IOException {

// 设置响应内容类型为 HTML，避免乱码

response.setContentType("text/html; charset=UTF-8");

// 获取输出流，用于向浏览器发送响应内容

PrintWriter out = response.getWriter();

// 输出 HTML 页面内容

out.println("");

out.println("");

out.println("");

out.println("");

out.println("

欢迎访问 Servlet 页面！

");

out.println("

当前时间是：" + new java.util.Date() + "

");

out.println("");

out.println("");

// 关闭输出流，释放资源

out.close();

}

}

✅ 代码说明：

@WebServlet("/hello")：告诉 Tomcat 当用户访问 /hello 时，调用这个类。

response.setContentType()：设置浏览器正确解析内容。

PrintWriter：向客户端发送文本数据，相当于“写信”。

创建第一个 JSP 页面

在 WebContent/ 目录下右键 → New → JSP File，命名为 index.jsp。

<%-- index.jsp：JSP 页面示例 --%>

<%-- JSP 是 Java Server Pages 的缩写，可以在 HTML 中嵌入 Java 代码 --%>

你好，这是 JSP 页面！

<%-- 使用 JSP 表达式输出当前时间 --%>

服务器时间： <%= new java.util.Date() %>

<%-- 使用 JSP 脚本片段输出循环 --%>

<%

for (int i = 1; i <= 5; i++) {

%>

• 这是第 <%= i %> 个列表项

<%

}

%>

点击访问 Servlet

💡 小知识：JSP 会在服务器端被编译成 Servlet，然后执行。所以你可以在 HTML 中写 Java 代码，非常方便。

启动服务器并测试功能

在 Eclipse 的 Servers 视图中，右键点击你配置的 Tomcat 服务器，选择 Start

启动成功后，浏览器访问：http://localhost:8080/HelloWeb/

你会看到 index.jsp 页面显示内容

点击“点击访问 Servlet”链接，跳转到 HelloServlet，显示动态时间信息

如果一切正常，说明你的 Eclipse JSP/Servlet 环境搭建成功！

常见问题与解决方案

问题

可能原因

解决方法

服务器启动失败，提示“端口被占用”

8080 端口被其他程序占用

修改 Tomcat 配置：conf/server.xml 中的

页面显示乱码

编码未设置

在 JSP 页面顶部添加 ，并在 Servlet 中设置 response.setContentType("text/html; charset=UTF-8")

Servlet 无法访问

路径错误或类未编译

检查 @WebServlet("/hello") 路径是否正确，右键项目 → Refresh，确保类已生成

Eclipse 无法识别 Tomcat

Runtime 环境未正确配置

重新添加 Tomcat 运行时环境，确认路径无误

总结与下一步建议

通过本文，你已经完成了 Eclipse JSP/Servlet 环境搭建的完整流程。从 JDK 安装到项目运行，每一步都为你打下了坚实的基础。

记住，一个能跑通的“Hello World”项目，比一百个理论更重要。接下来你可以尝试：

使用 JSP + Servlet 实现用户登录表单

集成 MySQL 数据库进行数据存储

使用 JSTL 标签库简化 JSP 代码

学习 Maven 管理项目依赖

这些进阶内容，都是建立在你已掌握的环境之上。坚持动手实践，你会发现 Java Web 开发并没有想象中那么难。

如果你在搭建过程中遇到任何问题，欢迎在评论区留言交流。祝你开发顺利，代码无 bug！