Eclipse + Tomcat 搭建 Java Web（JSP/Servlet）开发环境教程

本文基于已安装 JDK 的前提（若未安装，需先完成 Java 开发环境配置），详细说明 Windows 11 下环境搭建、项目创建及运行步骤，适合 Java Web 初学者。

一、软件下载

软件	下载地址（建议选择稳定版）	说明
Eclipse J2EE	eclipse.org/downloads	解压即可使用，无需安装
Tomcat	tomcat.apache.org	选择与系统匹配的压缩包（如 Windows 64-bit）

二、Tomcat 安装与验证

（一）解压配置

将 Tomcat 压缩包解压到无中文、无空格的目录（如 D:\apache-tomcat-9.0.xx），核心目录说明如下：

bin：启动 / 关闭脚本（startup.bat 启动，shutdown.bat 关闭）。
conf：配置文件（server.xml 可修改默认端口 8080）。
webapps：存放 Web 项目，浏览器可直接访问此目录下的资源。

（二）启动与验证

双击 bin/startup.bat，弹出命令行窗口（不要关闭）。
打开浏览器，输入 http://localhost:8080，若显示 Tomcat 欢迎页，说明启动成功。

（三）测试 JSP

在 webapps/ROOT 目录下新建 test.jsp，代码如下：jsp <%@ page contentType="text/html;charset=UTF-8" %>
<% out.print("测试成功：http://localhost:8080/test.jsp"); %>
浏览器访问 http://localhost:8080/test.jsp，若正常显示内容，验证完成。

三、Eclipse 关联 Tomcat

打开 Eclipse，点击菜单栏 Window → Preferences（Windows 系统） 或 Eclipse → 偏好设置（Mac 系统）。
在弹窗中依次展开 Server → Runtime Environments，点击 Add。
选择对应 Tomcat 版本（如 Apache Tomcat v9.0），点击 Next。
点击 Browse 选择 Tomcat 解压目录，JRE 选择已安装的 JDK，点击 Finish 完成关联。

四、创建 JSP 项目并运行

（一）新建 Dynamic Web Project

点击菜单栏 File → New → Dynamic Web Project，项目名设为 TomcatTest，点击 Next。
确认 Target Runtime 为已关联的 Tomcat，JDK 正确，点击 Finish。

（二）创建并修改 JSP 文件

在项目的 WebContent 目录下右键 → New → JSP File，文件名设为 test.jsp。
修改 test.jsp 代码如下：jsp <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head><title>JSP 测试</title></head>
<body>
<% out.println("Hello World! 这是 Eclipse 创建的 JSP 项目"); %>
</body>
</html>

（三）运行项目

右键项目 → Run As → Run on Server，选择已关联的 Tomcat，点击 Finish。
若弹出 “端口被占用” 错误，需先关闭手动启动的 Tomcat（双击 bin/shutdown.bat），再重新运行。
浏览器自动打开 http://localhost:8080/TomcatTest/test.jsp，正常显示内容即运行成功。

五、创建 Servlet 实例

（一）新建 Servlet 类

右键项目 src 目录 → New → Servlet，包名设为 com.runoob.test，类名设为 HelloServlet，点击 Finish。

（二）修改 Servlet 代码

java

运行

 package com.runoob.test;
 import java.io.IOException;
 import javax.servlet.ServletException;
 import javax.servlet.annotation.WebServlet;
 import javax.servlet.http.HttpServlet;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
 @WebServlet("/HelloServlet")
 public class HelloServlet extends HttpServlet {
     private static final long serialVersionUID = 1L;
 
     protected void doGet(HttpServletRequest request, HttpServletResponse response) 
             throws ServletException, IOException {
         response.setCharacterEncoding("GBK"); // 解决中文乱码
         response.getWriter().write("Servlet 测试成功：菜鸟教程");
     }
 
     protected void doPost(HttpServletRequest request, HttpServletResponse response) 
             throws ServletException, IOException {
         doGet(request, response); // Post 请求复用 Get 逻辑
     }
 }

（三）配置 web.xml（可选，若用 @WebServlet 注解可跳过）

在 WebContent/WEB-INF 下新建 web.xml，代码如下：

xml

 <?xml version="1.0" encoding="UTF-8"?>
 <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee">
     <servlet>
         <servlet-name>HelloServlet</servlet-name>
         <servlet-class>com.runoob.test.HelloServlet</servlet-class>
     </servlet>
     <servlet-mapping>
         <servlet-name>HelloServlet</servlet-name>
         <url-pattern>/HelloServlet</url-pattern> <!-- 访问的网址 -->
     </servlet-mapping>
 </web-app>

（四）运行 Servlet

重启 Tomcat（Eclipse 中右键 Server → Restart）。
浏览器访问 http://localhost:8080/TomcatTest/HelloServlet，正常显示内容即成功。

常见问题解决

问题：启动 Tomcat 时提示 “端口被占用”

原因：默认端口 8080 被其他程序占用（如其他 Tomcat 实例、MySQL 等）。
解决：修改 Tomcat 端口：
1. 打开 conf/server.xml，找到 <Connector port="8080" ... />。
2. 将 port 改为未被占用的端口（如 8081），保存后重启 Tomcat。
3. 访问时使用新端口，如 http://localhost:8081。

通过以上步骤，即可在 Windows 11 下完成 Eclipse + Tomcat 的 Java Web 开发环境搭建，并成功运行 JSP 和 Servlet 程序。