JSP+Servlet+MySQL学生管理系统教学实践指南

简介：这是一套基于JSP+Servlet+MySQL实现的完整学生信息管理系统源码，专为Java Web初学者及高校课程设计、期末大作业需求打造，覆盖用户登录、学生增删改查、教师管理、密码找回等核心功能模块，代码结构清晰、逻辑完整，已通过教师指导并获95分以上高分评价。压缩包共82个文件，含20个Java业务类、21个编译后Class文件、15个JSP页面（如login.jsp、register.jsp、student_manager.sql等）、6个CSS与5个JS前端资源，以及SQL数据库脚本、配置XML、图片素材和项目配置文件，总大小12.04MB，开箱即用，适配主流Tomcat环境。目前已有629人学习下载，资源附带详细资源介绍.txt与规范化的目录结构（含src、WEB-INF、resources等标准Web工程层级），特别适合零基础学员理解MVC分层思想、掌握Servlet请求流转与JDBC数据库操作全流程。

1. 为什么一个“学生信息管理系统”还能拿高分？——JSP+Servlet+MySQL组合在教学场景中的不可替代性

这不是一个过时的复古项目，而是一套被高校实验室、课程设计和毕业实训反复验证过的“最小可行教学闭环”：它用最轻量的技术栈，把Web开发的完整链路——请求响应生命周期、前后端职责分离、数据库事务边界、会话状态管理、表单校验与错误回显——全部压进一个可运行、可调试、可逐行打断点的工程里。很多新手学完Spring Boot一头雾水，不是因为框架难，而是跳过了Servlet容器如何真正接收HTTP请求、JSP如何被编译成Servlet、MySQL连接池怎么在web.xml里声明并被ContextListener初始化这些“黑匣子”背后的执行路径。这个源码包的价值，恰恰在于它不封装、不抽象、不自动配置——每个.java文件对应一个明确职责（StudentServlet只处理增删改查逻辑，DBUtil只管获取连接），每张JSP页面都暴露原始<%= %>表达式和<%-- --%>注释，连web.xml里<servlet-mapping>的URL-pattern写法都保留着Servlet 3.0之前的经典风格。适合两类人：一是刚学完Java基础、正卡在“写了main方法却不知道网页怎么动起来”的大二学生；二是需要快速搭建演示环境、给非技术背景同事讲清MVC分层逻辑的一线讲师。它不追求高并发或微服务架构，但能把“用户点击提交按钮 → 浏览器发POST请求 → Tomcat解析URL → 调用对应Servlet → 查询MySQL → 封装List传给JSP → 渲染HTML返回”这条链路上的27个关键节点，全部摊开给你看。

2. 从解压到启动：本地跑通这个JSP+Servlet项目的最小必要步骤

这个压缩包不是直接双击就能运行的“绿色软件”，它依赖三个外部组件：JDK 8（必须是8，不是11或17）、Tomcat 8.5（不是9或10）、MySQL 5.7（不是8.x）。版本错一个，你就会卡在ClassNotFoundException、UnsupportedClassVersionError或Communications link failure上。下面所有操作，我都以Windows 10 + IntelliJ IDEA 2022.3为基准，Linux/macOS用户只需把路径分隔符\\换成/，命令行用./startup.bat换成./startup.sh即可。

2.1 解压后目录结构解读：哪些文件动不得，哪些必须改

解压后你会看到类似这样的结构：

student-system/ ├── src/ │ ├── dao/ # 数据访问层：StudentDAO.java等 │ ├── entity/ # 实体类：Student.java（含getter/setter） │ ├── servlet/ # 控制层：StudentAddServlet.java、StudentListServlet.java │ └── util/ # 工具类：DBUtil.java（含数据库连接配置） ├── WebContent/ │ ├── WEB-INF/ │ │ ├── web.xml # 核心配置：servlet映射、过滤器、监听器 │ │ └── lib/ # 依赖jar：mysql-connector-java-5.1.47.jar │ ├── index.jsp # 首页入口 │ ├── student/ # JSP页面目录 │ │ ├── list.jsp # 学生列表页（含表格渲染） │ │ ├── add.jsp # 添加表单页（含前端校验提示） │ │ └── edit.jsp # 编辑页（回显原数据） │ └── css/ # 静态资源 └── student_db.sql # 数据库建表与初始数据脚本

注意：src/下的Java文件是业务逻辑核心，WebContent/WEB-INF/web.xml是整个应用的“神经中枢”，这两处绝对不能删减。而WebContent/css/里的样式文件可以替换，但别删index.jsp——它是Tomcat启动后默认访问的首页，删了会导致404。

2.2 数据库准备：用student_db.sql建库建表，但别急着导入

先手动创建数据库（不要用脚本自动建）：

CREATE DATABASE student_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

这一步必须做，因为student_db.sql脚本里通常只有USE student_db;和CREATE TABLE student (...)，没有CREATE DATABASE语句。如果直接执行脚本且数据库不存在，会报错Unknown database 'student_db'。

然后导入数据：

mysql -u root -p student_db < student_db.sql

导入后立刻验证：

SELECT COUNT(*) FROM student; -- 应该返回几条测试数据（如5条） SELECT * FROM student LIMIT 1; -- 检查字段名和中文是否乱码

关键参数说明：utf8mb4是必须的，因为学生姓名可能含emoji或生僻字（如“䶮”、“堃”），utf8在MySQL 5.7中仅支持3字节，会截断。COLLATE utf8mb4_unicode_ci保证排序和比较符合中文习惯，比如“张三”和“张叁”能正确区分。

2.3 Tomcat配置：修改server.xml和context.xml的两个致命细节

打开apache-tomcat-8.5.93/conf/server.xml，找到<Connector>标签，在port="8080"那一行后面追加：

URIEncoding="UTF-8" useBodyEncodingForURI="true"

完整效果：

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" useBodyEncodingForURI="true" />

这是解决中文参数乱码的唯一可靠方式。比如list.jsp?name=张三，不加这俩参数，Servlet里request.getParameter("name")拿到的是å¼ ä¸‰。

再打开conf/context.xml，在<Context>标签内添加：

<Resource name="jdbc/studentDS" auth="Container" type="javax.sql.DataSource" maxTotal="20" maxIdle="10" minIdle="5" initialSize="5" maxWaitMillis="10000" username="root" password="your_mysql_password" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost:3306/student_db?useSSL=false&amp;serverTimezone=Asia/Shanghai&amp;characterEncoding=utf8mb4" />

参数说明：maxTotal=20表示最多20个连接，对教学项目足够；serverTimezone=Asia/Shanghai必须显式指定，否则MySQL 5.7会报The server time zone value '...' is unrecognized；&是XML转义，不能写成&，否则Tomcat启动失败。

2.4 IDEA中部署项目：别选“Add Framework Support”，要手动配Artifact

在IDEA中打开student-system文件夹后：

1. 右键项目根目录 →Add Framework Support...→ 勾选Web Application→ 点OK
2. 但别停在这！接着点File → Project Structure → Artifacts
3. 点+→Web Application: Archive→For 'student-system'
4. 在右侧Output Layout中，展开student-system.war→ 右键WEB-INF/lib→Put into Output Root
5. 最后点Apply→OK

这一步绕不开。因为老式JSP项目依赖WEB-INF/lib下的mysql-connector-java-5.1.47.jar，如果IDEA自动生成的Artifact没把jar包打进war包，部署后必然报java.lang.ClassNotFoundException: com.mysql.jdbc.Driver。

3. 启动报错排查：5个高频翻车点及血泪修复方案

这个项目启动失败率极高，不是代码问题，而是环境细节没对齐。以下是我在某高校实验室带课时，学生当场举手问得最多的5个问题，按发生频率排序：

3.1 现象：Tomcat控制台输出SEVERE: Error filterStart，随后停止启动

原因：web.xml里定义的某个Filter类（如EncodingFilter.java）编译失败，或其init()方法抛出异常。常见于DBUtil.getConnection()里密码写错，导致SQLException被Filter捕获后未处理。
解决：打开src/util/DBUtil.java，检查private static final String PASSWORD = "xxx";是否和MySQL实际密码一致；若用空密码，确保写成""而非null。

3.2 现象：浏览器访问http://localhost:8080/student-system/显示404，但Tomcat日志无报错

原因：IDEA部署时未将项目上下文路径设为/student-system，而是用了默认/或随机字符串。
解决：Run → Edit Configurations → Deployment → Application context，手动输入/student-system（开头必须有/，结尾不能有/）。

3.3 现象：点击“添加学生”提交后，页面空白，控制台无任何日志

原因：add.jsp表单的action属性写错了。常见错误是写成action="servlet/StudentAddServlet"（少/），正确应为action="/student-system/servlet/StudentAddServlet"（绝对路径）。
解决：打开WebContent/student/add.jsp，找到<form action="...">，改为：

<form action="${pageContext.request.contextPath}/servlet/StudentAddServlet" method="post">

${pageContext.request.contextPath}会动态生成/student-system，避免硬编码。

3.4 现象：列表页显示学生姓名全是??或方块

原因：MySQL连接URL里漏了characterEncoding=utf8mb4，或Tomcat的server.xml没加URIEncoding="UTF-8"。
解决：双检查context.xml里的url参数，确认包含characterEncoding=utf8mb4；再确认server.xml的Connector标签有URIEncoding="UTF-8"。

3.5 现象：编辑学生信息时，edit.jsp里<input value="<%=student.getName()%>">渲染为空

原因：StudentListServlet.java里查询学生后，没把student对象存入request.setAttribute("student", student)，导致JSP取不到值。
解决：打开src/servlet/StudentEditServlet.java（或类似名称），在doGet()方法末尾添加：

request.setAttribute("student", student); request.getRequestDispatcher("/student/edit.jsp").forward(request, response);

玄学提醒：forward()前必须调用setAttribute()，顺序不能颠倒，否则JSP里<%=student%>是null。

4. 从“能跑”到“能讲”：用这个项目拆解Servlet生命周期的3个关键断点

光让项目跑起来只是第一步。真正的价值在于，你能指着代码告诉别人：“看，这就是HTTP请求从网卡进来，到HTML返回给浏览器的完整旅程”。我一般会让学生在以下三个位置打上断点，配合浏览器开发者工具的Network面板，一帧一帧看数据流动。

4.1 断点1：StudentListServlet.java的doGet()入口——理解请求如何被路由

在doGet()第一行加断点：

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // ← 在这里打断点 List<Student> students = studentDAO.findAll(); request.setAttribute("students", students); request.getRequestDispatcher("/student/list.jsp").forward(request, response); }

启动Debug模式，浏览器访问http://localhost:8080/student-system/servlet/StudentListServlet。当断点命中时，观察IDEA的Variables窗口：

• request.getRequestURL()→ 显示完整URL：http://localhost:8080/student-system/servlet/StudentListServlet
• request.getServletPath()→ 显示/servlet/StudentListServlet，即web.xml里<url-pattern>匹配的部分
• request.getContextPath()→ 显示/student-system，即应用上下文

教学价值：这里能直观解释web.xml里<servlet-mapping>的作用——它不是把URL重写，而是告诉Tomcat：“当路径匹配这个pattern时，请调用这个Servlet类”。

4.2 断点2：DBUtil.java的getConnection()——追踪数据库连接的创建与复用

在getConnection()方法里return dataSource.getConnection();前打断点：

public static Connection getConnection() throws SQLException { // ← 在这里打断点 return dataSource.getConnection(); }

连续刷新列表页两次，第一次断点会停住（连接池初始化），第二次会直接跳过（复用已有连接）。再打开context.xml里的maxIdle="10"，把值改成1，再刷三次——第三次必卡住，因为连接池已满，getConnection()会阻塞直到超时。这就是连接池“最大空闲数”的真实含义。

4.3 断点3：list.jsp的<c:forEach>循环——看清JSP如何被翻译成Servlet

右键list.jsp→View → Show Compiled JSP（IDEA需安装JSP插件），你会看到一个list_jsp.java文件。搜索_jspx_th_c_forEach_0，定位到类似代码：

org.apache.taglibs.standard.tag.rt.core.ForEachTag _jspx_th_c_forEach_0 = new org.apache.taglibs.standard.tag.rt.core.ForEachTag(); _jspx_th_c_forEach_0.setPageContext(_jspx_page_context); _jspx_th_c_forEach_0.setParent(null); _jspx_th_c_forEach_0.setItems((java.lang.Object) _jspx_page_context.getAttribute("students")); // ← 关键！

这行代码证明：JSP里的<c:forEach items="${students}">，最终被翻译成Java代码去getAttribute("students")。所以StudentListServlet里request.setAttribute("students", students)这行，就是JSP能取到数据的唯一桥梁。

血泪经验：很多学生写request.setAttribute("studentList", students)，但在JSP里写<c:forEach items="${students}">，死活不显示——不是EL表达式错了，是key名根本对不上。记住：setAttribute()的key，就是JSP里${}括号里的名字。

5. 进阶改造：把“高分项目”变成“面试作品”的3个低成本升级点

这个源码包拿90分没问题，但想让它成为简历上的亮点，必须做三处“不增加复杂度，但显著提升专业感”的改造。每处我都给出可直接复制的代码和效果对比。

5.1 升级1：用Bootstrap 4重写list.jsp，告别table border="1"

原list.jsp用<table border="1">，土味十足。替换为Bootstrap卡片式布局，只需两步：
第一步：在list.jsp顶部引入CDN（删掉原有<link rel="stylesheet" href="css/style.css">）：

<link href="https://cdn.jsdelivr.net/npm/bootstrap@4.6.2/dist/css/bootstrap.min.css" rel="stylesheet">

第二步：重写学生列表区域（替换原<table>部分）：

<div class="container mt-4"> <div class="d-flex justify-content-between align-items-center mb-3"> <h4>学生信息列表</h4> <a href="${pageContext.request.contextPath}/student/add.jsp" class="btn btn-primary">新增学生</a> </div> <div class="row"> <c:forEach items="${students}" var="student"> <div class="col-md-4 mb-3"> <div class="card h-100 shadow-sm"> <div class="card-body"> <h5 class="card-title text-primary">${student.name}</h5> <p class="card-text"> <strong>学号：</strong>${student.studentId}<br> <strong>班级：</strong>${student.className}<br> <strong>电话：</strong>${student.phone} </p> <div class="d-flex gap-2"> <a href="${pageContext.request.contextPath}/servlet/StudentEditServlet?id=${student.id}" class="btn btn-sm btn-outline-secondary">编辑</a> <a href="${pageContext.request.contextPath}/servlet/StudentDeleteServlet?id=${student.id}" class="btn btn-sm btn-outline-danger" onclick="return confirm('确定删除？')">删除</a> </div> </div> </div> </div> </c:forEach> </div> </div>

效果：从黑白表格秒变响应式卡片，手机访问自动堆叠，且所有按钮带悬停动画。关键是——不用写一行CSS，全靠Bootstrap类名驱动。

5.2 升级2：在StudentAddServlet中加入手机号正则校验，拒绝脏数据入库

原项目通常只做空值判断。加一行正则，立刻体现工程素养：

// 在StudentAddServlet.java的doPost()方法中，获取参数后立即校验 String phone = request.getParameter("phone"); if (phone == null || !phone.matches("^1[3-9]\\d{9}$")) { request.setAttribute("error", "手机号格式不正确（需11位，以13-19开头）"); request.getRequestDispatcher("/student/add.jsp").forward(request, response); return; // ← 必须return，否则继续执行插入 }

同时在add.jsp的表单下方加错误提示：

<c:if test="${not empty error}"> <div class="alert alert-danger mt-2">${error}</div> </c:if>

价值点：面试官看到这个，会认为你理解“校验前置”原则——数据库层的NOT NULL约束是兜底，业务层的正则才是第一道防线。

5.3 升级3：用Log4j2记录关键操作日志，把“谁在什么时候干了什么”可视化

下载log4j-api-2.17.1.jar和log4j-core-2.17.1.jar，放入WEB-INF/lib/。
在src/util/下新建LoggerUtil.java：

import org.apache.logging.log4j.LogManager; import org.apache.logging.log4j.Logger; public class LoggerUtil { private static final Logger logger = LogManager.getLogger(LoggerUtil.class); public static void logOperation(String operator, String action, String target) { logger.info("{} 执行了 {} 操作：{}", operator, action, target); } }

在StudentAddServlet.java插入成功后加日志：

if (studentDAO.insert(student) > 0) { LoggerUtil.logOperation("管理员", "新增学生", student.getName()); request.setAttribute("msg", "添加成功！"); } else { request.setAttribute("msg", "添加失败！"); }

启动项目后，查看logs/app.log（Log4j2默认生成），你会看到：

2023-10-15 14:22:33,123 INFO [http-nio-8080-exec-1] LoggerUtil: 管理员 执行了 新增学生 操作：张三

为什么值得做：日志不是给机器看的，是给人看的。当老师问“你怎么证明你的系统真的处理了100条数据？”，你打开log文件，截图发过去，比说一百遍“我测试过了”都有力。

最后说一句实在话：我带过三届学生做课程设计，凡是把这三个升级点做完的，答辩时基本不用背稿——因为代码自己会说话。他们不再解释“我用了什么技术”，而是直接点开浏览器，点开IDEA，点开log文件，让证据链自己跑一遍。这种“可演示、可验证、可追溯”的项目，才是真正在教学生怎么写代码，而不是怎么交作业。希望帮到你。

本文还有配套的精品资源，点击获取