案例 1:手把手教程-简易登录界面
做一个能登录的 JSP 页面
目标:浏览器输入账号密码 → 后端校验 → 对了进欢迎页,错了原地提示。
环境:JDK 21+、Maven、Tomcat 10.1.61。下面每一步都有"做完怎么验证",不要跳步。
零、先搞清楚要做几样东西
一个最小的登录功能,一共只有 4 类文件:
login-demo
├── pom.xml ① 告诉 Maven:这是 Web 项目,需要哪些 jar
└── src/main
├── java/com/iooi/login
│ ├── User.java ② 装用户数据的类(用户名、密码、角色)
│ └── LoginServlet.java ③ 后端:收参数、校验、跳转
└── webapp
├── login.jsp ④ 前端:登录表单
├── welcome.jsp ⑤ 登录成功后的页面
└── WEB-INF/web.xml ⑥ 容器配置(声明欢迎页)
分工一句话记住:JSP 只管显示,Servlet 只管判断,配置只管打包。
一、建目录
照着上面的树建文件夹,注意路径层级不能错,src/main/webapp 是 Maven 的硬约定,写错容器就找不到页面。
mkdir -p login-demo/src/main/java/com/iooi/login
mkdir -p login-demo/src/main/webapp/WEB-INF
验证:find login-demo -type d 输出里能看到 src/main/java/com/iooi/login 与 src/main/webapp/WEB-INF。
二、写 pom.xml
这是整个工程最容易被卡住的一步。三条规则:
packaging必须是war,否则打包出来没人能部署。jakarta.servlet-api和jakarta.servlet.jsp-api必须provided——容器自带,打进去会冲突。- JSTL 必须引两个依赖:一个是 API,一个是实现(
org.glassfish.web)。只引 API,页面会报"找不到标签库"。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.iooi</groupId>
<artifactId>login</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>war</packaging>
<name>login-demo</name>
<properties>
<maven.compiler.release>21</maven.compiler.release>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<dependency>
<groupId>jakarta.servlet</groupId>
<artifactId>jakarta.servlet-api</artifactId>
<version>6.0.0</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>jakarta.servlet.jsp</groupId>
<artifactId>jakarta.servlet.jsp-api</artifactId>
<version>3.1.1</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>jakarta.servlet.jsp.jstl</groupId>
<artifactId>jakarta.servlet.jsp.jstl-api</artifactId>
<version>3.0.0</version>
</dependency>
<dependency>
<groupId>org.glassfish.web</groupId>
<artifactId>jakarta.servlet.jsp.jstl</artifactId>
<version>3.0.1</version>
</dependency>
</dependencies>
<build>
<finalName>login-demo</finalName>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.13.0</version>
<configuration>
<release>21</release>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>3.4.0</version>
</plugin>
</plugins>
</build>
</project>
<finalName>login-demo</finalName> 决定 WAR 名字,也决定你访问时的路径前缀 /login-demo。不写就会变成 login-1.0-SNAPSHOT.war,路径跟着变。
验证:
cd login-demo && mvn -q clean package
产物应出现 target/login-demo.war。

三、写 web.xml
只做一件事:把 login.jsp 设为默认欢迎页,这样访问应用根路径就是登录页。
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
https://jakarta.ee/xml/ns/jakartaee/web-app_6_0.xsd"
version="6.0"
metadata-complete="false">
<display-name>login-demo</display-name>
<welcome-file-list>
<welcome-file>login.jsp</welcome-file>
</welcome-file-list>
</web-app>
metadata-complete="false" 必须留着,它允许容器扫描 @WebServlet 注解,否则第四步的 Servlet 根本不会生效。
四、先只写一个静态 login.jsp
先不接后端,只写一个纯 HTML 表单,目的是一次只引入一个变量:先确认"页面能显示"。
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>简易登录</title>
</head>
<body>
<h2>用户登录</h2>
<form action="${pageContext.request.contextPath}/login" method="post">
用户名:<input type="text" name="username"><br>
密 码:<input type="password" name="password"><br>
<input type="submit" value="登录">
</form>
</body>
</html>
这里先认识两个东西:
<%@ page contentType="text/html;charset=UTF-8" %>告诉浏览器用 UTF-8 显示,中文才不会变乱码。method="post"密码走 post 不上地址栏;action里暂时写死,等接后端时再改。
验证:部署这一步(见第九节),浏览器能看到表单。此时点登录会 404,因为 /login 还没有人处理,这是正常的。
五、写 User 类
就三个字段,加上 getter。为什么要 getter?因为 JSP 里 ${user.username} 底层就是调 getUsername(),没有 getter 就取不到值。
package com.iooi.login;
public class User {
private String username;
private String password;
private String role;
public User(String username, String password, String role) {
this.username = username;
this.password = password;
this.role = role;
}
public String getUsername() {
return username;
}
public String getPassword() {
return password;
}
public String getRole() {
return role;
}
}
验证:执行 mvn -q compile,target/classes/com/iooi/login/User.class 出现。
六、写 Login:接手表单
package com.iooi.login;
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 jakarta.servlet.http.HttpSession;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;
@WebServlet("/login")
public class login extends HttpServlet {
private static final List<User> USERS = Arrays.asList(
new User("admin", "123456", "admin"),
new User("bam", "123456", "user")
);
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
req.setCharacterEncoding("utf-8");
// 拿前端表单传过来的数据
String username = req.getParameter("username");
String password = req.getParameter("password");
User matched = null;
for (User user : USERS) {
if (user.getUsername().equals(username) && user.getPassword().equals(password)) {
matched = user;
break;
}
}
if (matched == null) {
// 把数据存到对象域里面,供 JSP 页面使用
req.setAttribute("errMsg", "用户名或密码错误,请重新输入");
req.setAttribute("username", username);
// 请求转发
req.getRequestDispatcher("/login.jsp").forward(req, resp);
return;
}
// 获取当前用户的对象
HttpSession session = req.getSession();
session.setAttribute("user", matched);
session.setAttribute("menus", Arrays.asList("首页", "设置"));
// 重定向
resp.sendRedirect(req.getContextPath()+"/welcome.jsp");
}
}
四个必须理解的细节:
@WebServlet("/login")就是给这个类分配地址。表单 post 到/login,于是走到这里的doPost。- 为什么只写
doPost不写doGet?因为表单是 post。若浏览器直接 GET 访问/login会报 405,这也说明你写对了。 - 失败用
forward,成功用sendRedirect。这是全篇最关键的一句:forward在服务器内部转发,setAttribute存的数据还能被 JSP 读到;sendRedirect让浏览器重新发一次请求,之前的 request 数据全部丢失。 request.setCharacterEncoding("UTF-8")必须在getParameter之前,顺序反了中文参数就是乱码。
七、让 login.jsp 显示错误提示(EL + JSTL)
现在把第四步的页面升级成带提示的版本。核心就三行:
<%@ taglib prefix="c" uri="jakarta.tags.core" %>
<%@ taglib prefix="fn" uri="jakarta.tags.functions" %>
<c:if test="${not empty requestScope.errMsg}">
<p style="color:red">${requestScope.errMsg}</p>
</c:if>
完整页面:
<%--
Created by IntelliJ IDEA.
User: liaoshangshaorouzong
Date: 2026/11/9
Time: 10:18
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix="c" uri="jakarta.tags.core" %>
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>
<html>
<head>
<title>简易登录</title>
</head>
<body>
<h2>用户登录</h2>
<%--
${}:EL 表达式标记,用来在 JSP 里取值
pageContext:JSP 内置对象,代表当前页面上下文
request:请求对象
contextPath:项目上下文路径(也就是你的 web 应用部署根路径)
/login:你后端登录接口的访问路径
--%>
<form action="${pageContext.request.contextPath}/login" method="post">
用户名:<input type="text" name="username" value="${fn:escapeXml(requestScope.username)}">
<br>
密 码:<input type="password" name="password">
<br>
<input type="submit" value="登录">
</form>
<c:if test="${not empty requestScope.errMsg}">
<p style="color: red">${requestScope.errMsg}</p>
</c:if>
</body>
</html>
三个 EL 常识:
${xxx}是 EL 表达式,负责"取值"。${requestScope.xxx}明确去 request 域取,避免和 session 里同名属性打架。empty判断"空不空",因为 EL 取不到值时给的是空字符串而不是 null,用not empty最稳。
为什么要 fn:escapeXml?如果用户在用户名框里输入 <script>,不做转义就会被当成代码执行。凡是把用户输入回显到页面的地方,都套一层。
八、写 welcome.jsp:登录之后去哪
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%--
Created by IntelliJ IDEA.
User: liaoshangshaorouzong
Date: 2026/11/9
Time: 11:01
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>欢迎页</title>
</head>
<body>
<c:choose>
<c:when test="${empty sessionScope.user}">
<p>您尚未登录,即将返回登录页</p>
<c:redirect url="login.jsp"/>
</c:when>
<c:otherwise>
<h2>欢迎你,${sessionScope.user.username}</h2>
<p>当前角色:${sessionScope.user.role}</p>
<c:choose>
<c:when test="${sessionScope.user.role == 'admin'}">
<h3>管理员菜单</h3>
<ul>
<li>用户管理</li>
<li>网站配置</li>
<li>文章审核</li>
</ul>
</c:when>
<c:otherwise>
<h3>用户菜单</h3>
<ul>
<li>我的文章</li>
<li>我的主页</li>
<li>我的收藏</li>
</ul>
</c:otherwise>
</c:choose>
</c:otherwise>
</c:choose>
</body>
</html>
这一段把 JSTL 三个主力标签都用上了:
c:choose / c:when / c:otherwise:就是 if-else if-else,比堆c:if干净。c:forEach:遍历集合。varStatus="st"给出行号工具:st.count是序号,st.first判断是不是第一项。c:redirect:服务端转跳,别人直接访问欢迎页且没登录时,把他踢回登录页。
为什么 sessionScope.user 能取到?因为第六步里 session.setAttribute("user", matched) 把用户放进了 session,session 跨请求存在,换页面也还在。
九、部署运行
mvn -q clean package
cp target/login-demo.war ~/apache-tomcat-10.1.61/webapps/
~/apache-tomcat-10.1.61/bin/startup.sh
浏览器打开:
http://localhost:8080/login-demo/login.jsp
停止 Tomcat:
~/apache-tomcat-10.1.61/bin/shutdown.sh
十、三个必测场景
| 操作 | 应该看到 |
|---|---|
直接访问 welcome.jsp |
提示未登录,自动跳回登录页 |
输 admin123 / x 提交 |
红字"用户名或密码错误",用户名仍留在输入框 |
输 admin / 123456 提交 |
跳到欢迎页,显示"管理菜单"和 4 个菜单项 |
输 iooi / 123456 提交 |
跳到欢迎页,显示"普通用户菜单" |
用户名输 <script>alert(1)</script> |
页面上原样显示这串文字,不弹窗 |
任何一条不符,先看 ~/apache-tomcat-10.1.61/logs/catalina.out。
十一、报错对照表
| 现象 | 原因 | 修法 |
|---|---|---|
| 打不开页面,404 | WAR 没部署上,或路径少了 /login-demo |
看 webapps/ 有没有 login-demo.war,重启 Tomcat |
| 点登录 404 | Servlet 没生效 | 检查类在 src/main/java/com/iooi/login 下,且有 @WebServlet("/login") |
| 点登录 405 | 用浏览器直接访问 /login 了 |
正常现象,必须走表单 post |
报 绝对 uri: jakarta.tags.core 无法找到 |
JSTL 只引了 API 或没打进 WAR | 确认两个 JSTL 依赖都没写 provided,WEB-INF/lib 里有两个 jstl jar |
页面显示 ${...} 原文 |
没加 <%@ taglib %> 或写成了旧 java.sun.com 地址 |
改成 jakarta.tags.core 等三个新地址 |
| 中文乱码 | 编码设置顺序错,或页面没声明 UTF-8 | setCharacterEncoding 放在 getParameter 之前 |
| 错误提示永远不显示 | 失败分支用了 sendRedirect |
改回 forward |
十二、做完之后可以继续加什么
- 加"退出登录":新建
LogoutServlet,session.invalidate()后重定向回登录页。 - 把
USERS换成数据库查询,Service + DAO 分层,JSP 一行都不用改。 - 加验证码、加"记住我"cookie、把密码改成散列存储。

