说句实话,最近几个月我陆续帮好几个新人看过“Tomcat配置不上”“Servlet跑不起来”的问题,发现十有八九不是操作本身有多难,而是IDEA 2024的新界面和老教程对不上号。网上大量教程还是基于IDEA 2021甚至更早的版本写的,菜单路径、选项名称、项目模板的位置都变了不少,照着一步步操作反而越弄越乱。这篇我把从下载Tomcat开始,到IDEA 2024里创建Web项目、配置运行环境、添加Servlet、最终跑通一个页面的完整流程写清楚,适合刚接触Java Web、还没在这条链路上成功跑通过一遍的人。我的目标是:你跟着这篇走完,浏览器里能看到自己写的Servlet输出内容,并且知道中间每一步到底在干嘛。
1. 环境准备:版本组合选对了,后面少踩一半的坑
1.1 JDK、Tomcat、IDEA怎么搭配才不别扭
先说结论:我目前最推荐的新手组合是 JDK 17 + Tomcat 9.0.x + IDEA 2024.x(Ultimate版)。这个组合不是说性能最好,而是“兼容性坑最少、网上资料最多、出错后最好查”。
为什么重点提醒这个?因为Tomcat从10.0版本开始做了一个很重要的调整:Servlet API的包名从 javax.servlet 改成了 jakarta.servlet。也就是说,网上大量使用 import javax.servlet.http.HttpServlet; 的教程代码,在Tomcat 10以上版本里直接编译不过。对新手来说,你很难区分“报错原因是版本不兼容”还是“自己代码写错了”。选择Tomcat 9.0.x就能和绝大多数教程保持一致,先把链路跑通,以后再考虑迁移到新版本。
JDK版本同理。Tomcat 9官方支持JDK 8到JDK 21,JDK 17是目前企业里用得最多的LTS版本,无论是IDEA的兼容性还是各种依赖库的支持都很成熟。如果你的电脑上装的是JDK 21甚至更新的版本,也不是不能用,但既然目标是“用最少的问题跑通”,没必要在第一步给自己增加难度。
有个细节需要确认:你本机的IDEA是否已经配置好了JDK。IDEA 2024新建项目时会自动检测,但如果本机只装了JRE没有装完整JDK,后面编译Servlet会报错。建议在命令行执行 java -version 看一下,确认输出版本号而不是“找不到命令”。同时可以用 javac -version 确认编译器存在。
1.2 Tomcat下载安装与目录结构,一次说透
Tomcat的下载地址是官方站点,选择Tomcat 9.0.x版本,注意下载 Core 分类下的 Windows zip 或者 Linux tar.gz,别下载那些名称里带Windows Service Installer的版本——谁用谁知道,服务版安装完会自动注册Windows服务,对开发来说纯属多余。
下载下来是个压缩包,解压到一个路径就行。这里有一个非常重要的建议:解压路径不要有任何中文,也不要有空格。我见过很多人把Tomcat解压到 C:\Program Files\Apache\Tomcat 9.0,IDEA配置时各种路径解析问题就来了,换成 C:\dev\tomcat9 这类简洁路径,后面能省掉很多麻烦。
解压后你会看到这些目录:
| 目录 | 作用 | 开发时的使用频率 |
|---|---|---|
| bin | 存放启动和关闭脚本(startup.bat、shutdown.bat) | 偶尔手动测试用 |
| conf | 核心配置文件,server.xml、web.xml都在这里 | 改端口、调配置时用 |
| lib | Tomcat运行所需的jar包 | 不需要手动动 |
| logs | 运行日志,崩溃排查的第一现场 | 遇到问题时重点看 |
| temp | 临时文件目录 | 基本不用管 |
| webapps | Web应用部署目录,把war包丢进去就能跑 | 学习阶段偶尔放 |
| work | JSP编译后的临时文件 | 不需要手动动 |
新手最容易忽略的是 conf/server.xml,里面可以改端口。默认端口是8080,如果8080被其他程序占用了,可以搜索 <Connector port="8080",改成比如8090。改完之后重启Tomcat生效。等下配置IDEA时也会涉及到这个文件,所以先知道它的位置。
1.3 环境变量到底配不配?配了有什么用
网上教程对“是否配置CATALINA_HOME环境变量”说法不一,我直接给结论:用IDEA跑Tomcat,不配环境变量完全没问题,因为IDEA是通过指定Tomcat目录来加载它的。但如果你经常需要在命令行手动启动Tomcat,那还是配上比较好。
配置方法之前写过很多次了,这里简单带过:Windows下在系统环境变量里新建 CATALINA_HOME,值填Tomcat的解压路径,然后在 Path 里追加 %CATALINA_HOME%\bin。配置完成后,命令行进入任意目录执行 startup.bat,能启动Tomcat就说明配置生效。我个人的建议是,这条链路值得花两分钟走一遍,因为命令行启动时打印的日志信息更原始,遇到问题反而更容易定位。
还需要检查一下 conf/logging.properties 里的编码配置。Tomcat 9默认情况下控制台日志在Windows上容易出现中文乱码,后面专门说,这里先不展开。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 在IDEA 2024里创建Web项目:别被新版界面带偏
2.1 用Maven骨架生成标准的webapp项目
IDEA 2024的New Project界面相比几年前的版本变化很大,但核心选项还是能一一对上。创建Web项目有两种主流方式:一种是直接用IDEA的“Java Enterprise”向导,另一种是创建Maven工程后使用webapp骨架。我推荐新手用第二种,原因是它生成的目录结构更接近真实项目,而且是Maven组织依赖,以后加jar包不用手动复制粘贴,对后续学习也友好。
操作路径:File → New → Project,左侧选择 Maven(有的版本叫“生成器”)。在项目模板(Archetype)那里,如果IDEA能联网,可以选择 org.apache.maven.archetypes:maven-archetype-webapp,这是一个官方webapp骨架,会生成标准的Maven项目结构和webapp基础目录。如果你用的IDEA 2024版本在模板列表里没找到这个骨架,也可以先创建一个空Maven项目,然后手动补目录——后面会讲到怎么补。
填写项目坐标:
- Name:项目名称,比如
servlet-demo - Location:项目保存路径,同样建议不要有中文
- GroupId:一般写
com.example这类反写域名格式 - ArtifactId:默认跟着项目名走
- Version:保持默认
点击创建后,IDEA会花一些时间下载Maven依赖和骨架插件。第一次创建时会比较慢,不要急。如果IDEA右下角提示“Maven导入需要一些时间”,等它完成。这一步如果网络不好,可以设置Maven镜像为阿里云镜像,方法是在Maven的settings.xml中添加mirror节点,减少从中央仓库拉包的时间。
2.2 补全src/main/java目录并检查web.xml版本
创建的webapp骨架项目默认结构是这样的:
code复制servlet-demo/
├── pom.xml
├── src/
│ └── main/
│ ├── resources/
│ └── webapp/
│ ├── WEB-INF/
│ │ └── web.xml
│ └── index.jsp
注意,这里没有 src/main/java 目录。这是因为webapp骨架默认不创建Java源码目录,需要你自己补上。做法是:在 src/main 目录上右键 → New → Directory,输入 java,IDEA会自动识别为源码根目录(颜色会变成蓝色)。同理,如果 resources 目录颜色不对,也要Mark Directory as Resources Root。
接下来打开 src/main/webapp/WEB-INF/web.xml,你会看到骨架生成的web.xml版本是2.3,头部声明非常古老。IDEA会高亮提示。直接把它替换成Servlet 4.0的声明,这样才匹配Tomcat 9:
xml复制<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
version="4.0">
</web-app>
如果你的web.xml文件没有自动更新成这个版本,有几种可能:一是IDEA未正确识别Web模块,需要检查Project Structure里的Facets;二是骨架生成的版本太老,直接手动粘贴上面的内容替换。这个操作关系到IDEA能否把项目正确识别为Web项目,直接决定后面Deployment配置里能否出现Artifact,所以务必确认。
2.3 为什么推荐用war exploded而不是war
这里先埋个伏笔。IDEA配置Tomcat时,Deployment选项卡里会要求选择“要部署的Artifact”,一般会有两个选项:war 和 war exploded。很多教程一笔带过,但这里其实是新手最容易懵的地方。
简单说,war是最终打包产物,部署时会将整个war包拷贝到Tomcat并解压运行,每次修改代码后需要重新打包才能生效。war exploded则直接把“展开”的项目目录作为部署内容,修改Java代码或静态资源后,IDEA能快速将更新同步到Tomcat的部署位置,配合热部署,开发效率高很多。日常开发阶段,基本都用war exploded,除非是最终交付时才打war包。
记住这个结论,后面配置时会用到。
3. 配置Tomcat运行环境:新手最容易卡住的环节
3.1 找到Tomcat配置入口:新版IDEA的菜单位置
第一次在IDEA 2024里配置Tomcat时,很多人找不到入口。旧版教程会说“Run → Edit Configurations → 左上角+号 → Tomcat Server → Local”,但这个入口有一个前提条件:当前项目必须已经被IDEA识别为Web项目,且模块列表中能看到Tomcat相关的Server选项。如果你打开Edit Configurations窗口,左侧列表里没有Tomcat Server这一项,多半是前面说的问题:项目的Facets中没有勾选Web或没有添加Tomcat库。
正常情况下,配置路径是:
- 打开 Run → Edit Configurations…
- 点击左上角 + 号
- 在列表里找到 Tomcat Server,选择 Local
- 在打开的配置页里设置Tomcat路径和相关参数
如果你的IDEA版本中找不到Tomcat Server选项,先检查是否安装了Ultimate版,因为社区版(Community Edition)默认不支持Tomcat集成。社区版用户有两个选择:下载IDEA Ultimate试用版,或者安装第三方的Smart Tomcat插件。插件方式也成熟,但很多功能(比如断点调试时的热部署同步)不如原生集成顺手。
3.2 Deployment和Application context的正确配置方式
Tomcat Server配置页打开后,最核心的是两个地方:Server选项卡和Deployment选项卡。
Server选项卡里:
- Application server:点击 Configure…,选择Tomcat安装目录(比如
C:\dev\tomcat9) - URL:默认可能是
http://localhost:8080/,先留空或保持默认,启动后会自动调整 - HTTP port:默认8080,如果Tomcat的server.xml里改了端口,这里要保持一致
- 如果勾选了“Open browser”相关选项,IDEA会在启动完成后自动打开浏览器
Deployment选项卡更关键:
- 点击 + → Artifact → 选择
servlet-demo:war exploded - 在Application context处填写访问路径,一般填
/就行。如果填/demo,那么访问地址就变成http://localhost:8080/demo/xxx
Application context这个字段其实很容易理解:它决定了你的Web应用的根路径。填 / 时,访问根路径就是 http://localhost:8080/hello;填 /demo 时,要访问 http://localhost:8080/demo/hello。对于单个项目的学习场景,用 / 最直接。
这里有个常见问题:有些时候Artifact列表里没有war exploded选项。原因一般是项目没有被识别为Web项目。解决方法是:打开 Project Structure(Ctrl+Alt+Shift+S)→ Facets,点击 + 号,选 Web,然后在Module下拉框里选择当前项目名,应用后重新打开Deployment选项卡,Artifact选项就会出现。这一步在IDEA 2024里经常遇到,尤其是用maven-archetype-webapp手动补目录的时候。
3.3 启动前的最后检查:端口、构建方式、JRE
还差最后一步检查就能启动。在Run/Debug配置页面的Server选项卡里,往下拉到 JRE 设置,确认选择的是你本机安装的JDK 17。如果这里显示“No JRE”,说明IDE没正确关联JDK,可以在Project Structure的Project SDK里重新指定。
再检查一下 Build 相关设置。IDEA有“Build before run”和“Build artifacts before run”等选项,建议保持默认勾选,这样每次启动前IDEA会自动编译项目,把最新的class文件同步过去。
端口这块再啰嗦一句:如果本机已经有一个Tomcat在跑(比如你手动用startup.bat启动了),IDEA再启动时会报端口占用或 Address already in use。开发学习阶段,建议关掉手动启动的Tomcat,统一教给IDEA来管理。如果你确实需要手动启动,那IDEA里可以把HTTP端口改成其他值。但我个人不太建议改端口来规避问题,因为这会引入“项目配置和教程不一致”的额外变量,不如一次性搞清楚哪个Tomcat实例在占用端口。
检查完毕后,点击 OK 保存配置。到这里,一个能运行的Web项目容器就搭好了。
4. 动手写第一个Servlet:用注解方式最省事
4.1 Servlet到底是什么:一个处理HTTP请求的Java类
抛开官方文档那些复杂的定义,Servlet本质上就是一个Java类,但它是被Tomcat这类Web容器管理、专门用来处理HTTP请求的Java类。浏览器发来一个GET请求,Tomcat根据URL找到对应的Servlet,调用它的 doGet 方法,然后把Java代码生成的HTML文本返回给浏览器。
理解这个流程对后续所有Web框架都重要。Spring MVC的Controller也好、Struts的Action也好,底层最终都是Servlet,只是外面包了一层又一层的封装。所以别看Servlet写起来原始,它是整个Java Web的地基。
Servlet的生命周期由容器管理:首次访问时创建实例,调用 init 方法做初始化,然后每个请求调用一次 service 方法(service 内部根据请求类型分发到 doGet/doPost),容器关闭时调用 destroy 销毁。理解这个生命周期,你就知道为什么不要在Servlet里随便定义可变的成员变量——因为Servlet是单例多线程使用的,成员变量会带来线程安全问题。这个话题后面细说。
4.2 用@WebServlet注册,比web.xml更推荐的做法
Servlet 3.0之后,完全可以用注解注册Servlet,不需要在web.xml里写 <servlet> 和 <servlet-mapping> 了。对新手来说,用注解至少有两点好处:一是代码和配置在一起,直观;二是少写一半XML,出错概率低。
在 src/main/java 下创建包 com.example.servlet,然后新建一个类 HelloServlet,继承 HttpServlet:
java复制package com.example.servlet;
import jakarta.servlet.ServletException;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
resp.setContentType("text/html;charset=UTF-8");
resp.getWriter().write("<h1>Hello Servlet!</h1>");
resp.getWriter().write("<p>当前时间:" + java.time.LocalDateTime.now() + "</p>");
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
// 简单起见,POST请求也调用GET的处理逻辑
doGet(req, resp);
}
}
再次强调,Tomcat 9对应的是 jakarta.servlet 包,但如果是Tomcat 9.0.x之前的一些版本,或者你手动引入了javax.servlet-api依赖,那包名还是要写javax.servlet。我刚说代码里用jakarta.*是因为Tomcat 9从某个小版本开始已经支持jakarta命名空间?不对,等一下——Tomcat 9实际上仍然是javax.servlet,Tomcat 10才是jakarta.servlet。这点不能搞错。如果用Tomcat 9,代码里必须写 import javax.servlet.*。
我需要修正:Tomcat 9.0.x中使用的是javax.servlet。所以上面的代码应该改成:
java复制package com.example.servlet;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
resp.setContentType("text/html;charset=UTF-8");
resp.getWriter().write("<h1>Hello Servlet!</h1>");
resp.getWriter().write("<p>当前时间:" + java.time.LocalDateTime.now() + "</p>");
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
doGet(req, resp);
}
}
同时,如果项目里还没有Servlet依赖,在pom.xml中需要添加(scope为provided,因为Tomcat自带Servlet API):
xml复制<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
scope=provided 的意思是编译时需要这个包,但运行时由容器提供。这样打出来的war包不会包含Servlet API,避免和Tomcat自带的版本冲突。这是我见过很多新手犯的错:把scope写成compile,最后war包打出来一大坨冗余依赖。
@WebServlet("/hello") 就相当于告诉Tomcat:访问这个Web应用的 /hello 路径时,由 HelloServlet 处理。你可以在这个Servlet里同时写多个映射路径,比如 @WebServlet({"/hello", "/hello2"}),但学习阶段一个就够。
4.3 处理请求和响应时最容易被忽略的编码问题
resp.setContentType("text/html;charset=UTF-8") 这一行不是可加可不加的。它做了两件事:一是告诉浏览器响应内容类型是HTML,二是告诉浏览器用UTF-8解码。如果不设置这行,浏览器会按默认编码去解析,页面上的中文极可能变成乱码。
同样的道理,读取请求参数时也有编码坑。写一个处理表单或GET参数的Servlet时,在 doPost 方法开头建议加一句 req.setCharacterEncoding("UTF-8"),这样才能正确读取POST请求中的中文参数。GET请求的编码问题更麻烦,因为参数在URL里,编码由Tomcat默认的URIEncoding决定。Tomcat 9中 server.xml 的连接器默认已经不容易乱码,但如果你在请求参数里遇到中文乱码,可以检查 <Connector> 是否设置了 URIEncoding="UTF-8"。
这段先不展开太多,后面在实战问题里还会涉及。
5. 启动、访问、验证:从空白页面到看到hello world
5.1 第一次启动:IDEA、Tomcat和浏览器之间发生了什么
配置完成后,点击IDEA工具栏上的绿色三角形运行按钮。IDEA会执行以下操作:
- 编译项目,把最新的class文件放入target目录
- 根据war exploded的配置,把项目的webapp目录和编译后的class文件组装成可部署的目录结构
- 启动Tomcat进程,并把该部署目录发布到Tomcat中
- 建立JMX连接(用于IDEA控制Tomcat的启停)
- 根据配置打开浏览器访问URL
这一整套过程对我们是透明的。看IDEA底部的Run窗口,日志中出现类似这样的内容就表示启动成功:
code复制Connected to server
[2024-xx-xx xx:xx:xx,xxx] Artifact servlet-demo:war exploded: Artifact is deployed successfully
[2024-xx-xx xx:xx:xx,xxx] Artifact servlet-demo:war exploded: Deploy took N milliseconds
如果配置过Application context为 /,浏览器会打开 http://localhost:8080/,这时候你会看到 index.jsp 里的内容(骨架生成的页面显示 Hello World! 或者类似的内容)。
然后我们把URL改成 http://localhost:8080/hello,回车后页面显示 Hello Servlet! 和当前时间,这就是你的Servlet跑通了。第一次走到这一步时的那种成就感,是教程没法替代的。
5.2 常见404:两类原因,一个排查公式
启动后跑网站,最常见的就是404。我总结了一个排查公式:先看Tomcat是否启动成功,再看URL是否匹配Servlet映射,最后看部署的上下文路径对不对。
如果Tomcat启动失败,Run窗口会直接报错,比如端口被占用、部署目录不可写等。这类问题很好定位,看日志里的红色报错信息即可。
如果Tomcat启动成功,但访问 http://localhost:8080/ 本身就已经404,那问题大概率是没有部署任何东西。打开Edit Configurations里的Deployment选项卡,确认Artifact已经添加,Application context不是空的。此外检查 src/main/webapp 下是否存在 index.jsp,Tomcat的默认欢迎页面是 index.jsp 或 index.html,如果webapp目录是空的,根路径自然会404。
如果根路径能出页面,但访问 /hello 时报404,那问题在Servlet映射上。检查类上是否写了 @WebServlet("/hello"),注意路径别少了斜杠;检查Servlet类是否编译进了部署目录。如果前面都确认了,试着在Tomcat的work目录下删掉缓存重启,避免陈旧缓存干扰。
还有一类典型的404是:访问的是 http://localhost:8080/servlet-demo/hello,多了一段项目名。这是因为很多人第一个项目习惯用Project Name做application context,IDEA默认的URL可能是 http://localhost:8080/servlet-demo_war_exploded/。此时要么把URL改回 /,要么按URL里的上下文路径拼接访问。我倾向于教新手从根路径 http://localhost:8080/hello 开始,因为这样URL最简单,操作起来最不容易懵。
5.3 控制台乱码、页面乱码、端口被占用的处理方案
Tomcat乱码是高频问题,而且有不止一个层面。
控制台乱码:IDEA Run窗口里的Tomcat日志出现乱码,尤其是中文日志。Tomcat在Windows下默认用系统字符集输出日志,常见解决方案是修改 conf/logging.properties,找到 java.util.logging.ConsoleHandler.encoding 这一行,把原来的UTF-8改成GBK,或者注释掉让系统自动匹配。但这里有个细节:改了Tomcat配置会影响所有项目,而且IDEA里的控制台编码还和IDEA自身的 Help → Edit Custom VM Options 里的 -Dfile.encoding=UTF-8 有关。我的建议是,先把IDEA的file.encoding统一成UTF-8,再把Tomcat的ConsoleHandler.encoding改成UTF-8,并保证IDEA的Run窗口编码是UTF-8。如果弄来弄去还是乱,先不纠结日志里的中文,优先保证Servlet输出到页面的中文不乱。
页面乱码:这个通常就是 resp.setContentType("text/html;charset=UTF-8") 没写。如果加了还是乱,检查浏览器页面的字符编码是否被强制覆盖成其他格式(浏览器右键可以手动选编码,但一般不需要)。另外,如果JSP页面本身没声明 <%@ page contentType="text/html;charset=UTF-8" %>,前端页面也会乱码。虽然这篇主要在讲Servlet,但你的项目里还有个index.jsp,顺手看一眼它的编码声明。
端口被占用:Tomcat启动报 Port 8080 was already in use,用命令行执行 netstat -ano | findstr 8080 找出占用8080的进程PID,再根据PID在任务管理器中结束对应进程。注意:这个进程可能是另一个Java进程,也可能是别的程序。先看清楚再结束,不要盲目杀进程。如果经常发生,干脆把Tomcat的端口改掉,或者确认没有手动启动过Tomcat。
6. 最后再分享几个实战中的小经验
6.1 war exploded + 热更新的组合为什么香
开发阶段我一直用war exploded,配合IDEA的“Build project automatically”和“Hot swap”功能,修改Java方法体内的代码、修改JSP、修改静态资源,很多场景下不需要手动重启Tomcat,改完了直接刷新浏览器就能看到效果。IDEA检测到代码变化后,会用JVM的热替换能力把新代码推进去。
但是,如果新增了方法、修改了类结构、新增了字段,热替换就不一定生效了,这时候IDEA会提示需要重启。遇到这种情况直接重启Tomcat,花不了几秒钟。你如果发现明明改了代码,刷新页面没反应,先看IDEA下方有没有“编译完成”的提示,再确认是否触发了重启。
另外一个实用技巧:开启IDEA设置里的 Build project automatically(Settings → Build, Execution, Deployment → Compiler),这样保存代码后IDEA会自动编译。但要注意,自动编译并不等于自动部署,Tomcat的部署还是要靠IDEA的Artifact同步机制。真正开发Java Web应用时,很多人会换成JRebel这类工具做热部署,但新手阶段完全没必要,先把IDEA自带的热替换用明白。
6.2 Servlet的request、response为什么不建议保存到成员变量
这个知识点特别容易踩坑,值得多说几句。
Servlet在容器中是单实例的,多个请求会并发进入同一个Servlet实例。如果你写了成员变量 private HttpServletRequest request;,在 doGet 里把它赋值给成员变量,那么同时来100个请求时,这些请求就会相互覆盖,A请求刚读一半的参数,可能就被B请求覆盖了。
正确做法是只在方法内部使用 req、resp 参数,不要把它们赋值给成员变量。如果确实需要在多个方法之间共享请求数据,优先考虑 request.setAttribute/getAttribute,或者显式传入方法参数。这是并发编程里的经典问题:Servlet有实例变量时不是线程安全的,而局部变量是线程安全的。
我当年实习时写过这种“成员变量存request”的代码,刚开始单线程测试一切正常,并发一上就好几个请求串数据,排查半天才发现是这个原因。现在先给你提个醒,省得走弯路。
6.3 学习Servlet时值得做的几个小练习
跑通了HelloServlet,下一步不要急着去学Spring Boot,先把Servlet的基础功打牢。我建议做这几个练习:
- 写一个登录表单:页面提交用户名和密码,Servlet接收后用
req.getParameter读取,再根据条件跳转到不同的页面(用resp.sendRedirect或req.getRequestDispatcher().forward)。这个练习能让你搞清楚GET和POST的区别、重定向和转发的区别。 - 做一个简单的注册信息展示:提交多条数据(比如姓名、性别、爱好),在Servlet里把这些数据用HTML列表展示出来。涉及中文参数乱码的完整处理。
- 做一个计数器:用ServletContext保存访问次数,每次访问自动加1。这个练习让你理解ServletContext和应用全局状态的关系。
做完这些,你对HTTP请求、Servlet生命周期、请求响应模型的理解就会比较扎实,再去学Spring MVC,很多概念都能对上号。
我在带新人的过程中反复说一句话:Servlet是Java Web的根,理解Servlet的运行机制,后面学什么Web框架都不慌。这篇教程的目标是让你“跑通”,但跑通只是第一步,把每一步背后的原理搞清楚,才是真正属于自己的东西。碰到问题别急着复制粘贴搜索引擎里的代码,先看看Tomcat的日志、看看IDEA的控制台输出,大多数答案都在里面。
