学生信息管理系统Java Web实战：从Servlet到JSP的完整开发指南

简介：一份基于Java Web的学生信息管理系统课程设计完整方案，包含可运行源码、数据库脚本和详细设计说明文档。系统提供管理员登录、学生信息添加、维护、按学号精确查找、更新、删除，以及修改管理员密码和退出等操作，覆盖了Java Web课程设计常见功能需求，同样适合作为毕业设计或入门实践参考。压缩包共78个文件，包括16个Java源文件、12个JSP页面、6个JavaScript脚本、4个CSS样式、5个Jar依赖包、2个SQL建库脚本和1个Word说明文档，整体大小仅2.53MB，目录结构清晰便于按模块查阅。设计说明文档对功能结构、项目架构、包及Java类说明、数据库设计均有介绍，可辅助读者理解从页面请求到数据持久化的完整流程，并可直接将数据库脚本导入MySQL等环境运行。目前已有922人学习下载，非常适合需要快速搭建同类项目或撰写课程设计报告的在校学生。

1. 学生信息管理系统：为什么这个Java web老题目依然是练手首选

每年课程设计季，都会有一批人对着“学生信息管理系统”这个题目发愁。Java web、源码、数据库、说明文档，这四个词组合起来，意味着评委要看到的不只是能跑通的页面，还要有完整的后端逻辑、清晰的数据表设计，以及答辩时能讲清楚的设计思路。选题的同学中，有人是想认真做一个拿得出手的项目，有人只是为了凑一个能及格的作品，但无论哪种，这套系统的核心价值都一样：它覆盖了Java web开发里最常用、最容易被追问的技术点——Servlet生命周期、JSP页面渲染、数据库连接池的使用、增删改查的完整闭环。

和我聊这个话题的人，大部分是计算机相关专业的学生，也有刚入行的开发者想拿它当简历项目。他们的共同诉求不是看懂原理，而是想知道：用最少的精力把它做出来，中间有哪些坑是白走的，以及答辩时老师会问什么。我给的答案通常很直接：这个题目能做，也非常值得做，因为它正好卡在“会写代码”和“能讲清设计”的交界处。下面这套方案，是我做过的、也是推荐给多数人的落地路径，从数据库到页面，从部署到答辩，全部走一遍。

2. 选型与工程骨架：用Maven+Servlet+JSP搭出的最小可行方案

2.1 技术栈选型：为什么不选Spring Boot，而是沿用经典JDBC+Servlet

面对这个题目，最常见的疑惑是：现在都用Spring Boot了，课程设计还用Servlet+JSP，是不是太旧了？这个问题有两面性。从“演示新技术”的角度，Spring Boot当然更吸引眼球；但从“课程设计答辩”的角度，Servlet+JSP反而是更稳妥的选择。理由很简单：绝大多数课程设计的评分点，是看你有没有掌握Java web的基础链路，而不是看你用了多少注解和自动配置。评委手里通常有一套标准——前端页面、后端分层、数据库操作、事务处理、部署运行，这些在Servlet时代就能完整覆盖。

技术层面我建议这样组合：JDK 8或11、Tomcat 8.5或9.0、MySQL 5.7或8.0、Maven作为构建工具。核心依赖只有两个——MySQL驱动和JSTL标签库。如果老师允许用连接池，可以加一个DBCP或C3P0；如果不允许，就用DriverManager手写连接工具类。用Maven的意义在于：即便你的开发机器上没装Tomcat，war包也能源源不断地构建出来，然后丢到任意一台装了Tomcat的机器上运行。这对课程设计验收来说非常方便——因为验收现场经常要临时换电脑。不要纠结版本新旧，跑得稳比跑得新更重要。

2.2 工程目录结构与依赖配置：一个连项目结构都规范的工程，答辩加分是实打实的

Maven工程的东西就那些，但结构一定要按规范来。我见过太多人把源码包和jsp页面混在一起，听的人第一反应就是“条理不清楚”，这不是会不会代码的问题，而是工程素养的问题。规范的项目结构长这样：

src/main/java cn.edu.sims.dao # 数据访问层 cn.edu.sims.service # 业务逻辑层 cn.edu.sims.servlet # 控制器层 cn.edu.sims.entity # 实体类 cn.edu.sims.util # 工具类（DBUtil） src/main/resources db.properties # 数据库连接配置 sims.sql # 初始化脚本 src/main/webapp WEB-INF/web.xml # Servlet映射配置 static/css static/js views/ # JSP页面 pom.xml

这种分层不是做做样子。DAO层只管SQL执行，Service层处理业务判断，Servlet接收请求并转发到JSP，JSP只负责展示。课上强调的分层思想和单一职责，在答辩时一定会被问到。比如“为什么把数据库连接放工具类里？”——“因为不同模块都要获取连接，抽出来避免重复创建”“为什么没在JSP里直接写JDBC代码？”——“为了解耦，修改SQL时不需要改页面”。这些回答都在工程结构里体现出来了。

构建配置只有三个关键点。第一，打包方式是war包，因为要部署到Tomcat；第二，JDK编译版本设为1.8，避免本地环境过高导致线上版本不匹配；第三，不要用Maven的Tomcat插件，直接用本地Tomcat运行，因为课程设计强调“看得见、摸得着”的部署过程。pom.xml的核心依赖这样写：

<dependencies> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.49</version> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>4.0.1</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> </dependencies>

这段配置中，servlet-api的scope设为provided很重要。因为Tomcat自带Servlet容器实现，如果打成war包时把servlet-api也打包进去，部署到Tomcat后会因为重复加载而产生ClassCastException。很多人第一次部署时遇到“HTTP 500 java.lang.ClassCastException”，就是这个原因。MySQL驱动版本选择5.1.49，兼容MySQL 5.7和8.0，避免新版驱动的一些地性能差异。JSTL库是给JSP里用c:forEach这类标签用的，没有它，页面循环输出会很痛苦。

2.3 web.xml与数据库连接工具：先跑通“连接数据库”这一步

Servlet 4.0之前，web.xml是必须存在的；即便现在支持注解，课程设计还是建议保留，因为Tomcat启动时按web.xml加载Servlet映射，这个过程评委可能会看。新手写web.xml容易忘记一个关键配置：启动时加载顺序。比如把数据源初始化放在load-on-startup=1的位置，这样启动时就完成连接池预热，避免第一个请求进来时初始化太慢被误判为卡死。一个典型的web.xml配置片段：

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" version="4.0"> <display-name>StudentInfoSystem</display-name> <welcome-file-list> <welcome-file>views/login.jsp</welcome-file> </welcome-file-list> <servlet> <servlet-name>LoginServlet</servlet-name> <servlet-class>cn.edu.sims.servlet.LoginServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>LoginServlet</servlet-name> <url-pattern>/login</url-pattern> </servlet-mapping> </web-app>

注意这里url-pattern的写法。如果写成 /*，那么JSP页面也会被拦截，页面里的css、js全都会404；如果写成 /，则会拦截所有非静态资源，需要配合静态资源放行配置。实际项目中我建议对每个业务Servlet声明具体的path，比如/login、/student/list，避免通配符带来的一堆麻烦。

接下来是最核心的数据库连接工具类。这个类的质量，直接决定了后面所有DAO能不能安稳运行。需要用db.properties来避免硬编码连接地址：

public class DBUtil { private static String url; private static String user; private static String password; private static Connection conn; static { try (InputStream in = DBUtil.class.getClassLoader() .getResourceAsStream("db.properties")) { Properties props = new Properties(); props.load(in); url = props.getProperty("jdbc.url"); user = props.getProperty("jdbc.username"); password = props.getProperty("jdbc.password"); Class.forName("com.mysql.jdbc.Driver"); } catch (Exception e) { throw new ExceptionInInitializerError(e); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(url, user, password); } public static void close(ResultSet rs, Statement stmt, Connection conn) { if (rs != null) try { rs.close(); } catch (SQLException ignored) {} if (stmt != null) try { stmt.close(); } catch (SQLException ignored) {} if (conn != null) try { conn.close(); } catch (SQLException ignored) {} } }

这里的close方法用了重载close(ResultSet, Statement, Connection)，核心原因是：查询操作的结果集、语句、连接都必须依次关闭，顺序反了会导致连接泄漏。物理关闭数据库连接是最保底的做法。有一点必须强调：不要在静态块里直接建立连接并持有它，因为连接长时间不操作会被MySQL服务器主动断开，到时候整个应用就瘫痪了。拿到连接的时机应该是每一次请求进来时。很多人的“系统跑着跑着就报CommunicationsException”，十有八九就是这里写错了。

3. 学生信息管理系统的数据库设计：表结构、初始化SQL与三个必调参数

3.1 三张表的设计思路：admin、student、加上一个class表避免范式问题

做学生信息管理，核心表是学生表student，配套的管理员登录表admin，另外还建议做一张班级表classes。为什么不要直接把班级名称这个字段写死在student表里？一个班有几十个学生，如果写死字符串，后续要改班级名称就要批量UPDATE；如果把它单独做成一张表，通过外键关联，班级名称只保存一处。这既是第三范式的体现，也是答辩时“数据库设计”评分点中的必讲项。缺少这张表，设计上是有硬伤的。

三张表的字段设计要控制好粒度，字段数量大概在8到12个，太多页面写不出，太少显得没有完整性。一个完整的建表SQL如下：

CREATE DATABASE IF NOT EXISTS sims; USE sims; CREATE TABLE admin ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT '管理员ID', username VARCHAR(32) NOT NULL UNIQUE COMMENT '登录账号', password VARCHAR(64) NOT NULL COMMENT '密码（建议SHA-256存储）', create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE classes ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT '班级ID', class_name VARCHAR(50) NOT NULL UNIQUE COMMENT '班级名称', grade_year INT NOT NULL COMMENT '入学年份' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT '学生ID', student_no VARCHAR(20) NOT NULL UNIQUE COMMENT '学号', name VARCHAR(50) NOT NULL COMMENT '姓名', gender TINYINT DEFAULT 0 COMMENT '0男 1女', birth_date DATE COMMENT '出生日期', class_id INT COMMENT '关联班级ID', phone VARCHAR(20) COMMENT '联系电话', address VARCHAR(255) COMMENT '家庭住址', status TINYINT DEFAULT 1 COMMENT '1在读 0离校', create_time DATETIME DEFAULT CURRENT_TIMESTAMP, CONSTRAINT fk_student_class FOREIGN KEY (class_id) REFERENCES classes(id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; INSERT INTO admin (username, password) VALUES ('admin', SHA2('123456', 256)); INSERT INTO classes (class_name, grade_year) VALUES ('计算机2201', 2022), ('计算机2202', 2022);

这份SQL里有几个值得深挖的细节。表引擎必须写InnoDB，因为它是支持外键约束和事务的引擎；如果用了MyISAM，外键直接静默忽略，到时候查不到关系会很费解。字符集选择utf8mb4而不是utf8，是因为utf8在MySQL里最多存3个字节，遇到emoji表情或生僻字就会报错“Incorrect string value”。password字段建议用SHA2函数存储，不要存明文，这是答辩时能加分的小亮点。student_no设置UNIQUE，是防止同一学号被重复插入，这条约束比代码层校验可靠得多，因为数据库层是无法绕过的最后一道锁。

3.2 必调参数与连接配置：连接池超时、字符集与批量插入

课程设计项目里不需要拿着参数列表逐个去调，但有几个参数如果忽略了，运行期就会出现“人还在，数据库却断了”的诡异问题。配置文件db.properties我通常会这样写：

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/sims?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai jdbc.username=root jdbc.password=123456

URL里拼接的参数，会直接决定中文是否乱码、连不连得上。useUnicode=true与characterEncoding=utf8这两个是绑定一起用的，缺一个，插入的中文可能全变成问号。useSSL=false，是因为本机开发环境没有部署SSL证书，MySQL 8.0默认会用SSL协商，失败了会报“Communications link failure”，关掉就不会。serverTimezone=Asia/Shanghai，解决MySQL 8.0驱动与本地时区的8小时漂移问题——很多人的系统显示时间比真实时间早8小时，就是漏了这个参数。

数据库连接池如果不引入常用工具，那么只能依赖DriverManager，在并发请求高时每次都要创建连接。虽然课程设计规模通常不太需要连接池，但建议提前知道：如果后续使用DBCP连接池，会多两个必配参数。一个是maxTotal，决定了连接池最多有多少条连接；一个是maxWaitMillis，超过这个时间拿不到连接就直接抛异常，而不是无限阻塞。特别说明：在Windows长时间运行的开发环境里，如果写完代码后忘记关连接导致连接池满了，则所有后续请求都会卡在等待连接上。症状是页面白屏不报错，重启Tomcat后又正常了。排查方向就在这里。

3.3 初始化数据与测试连接：用MySQL命令行快速验证表结构

建好表之后不要急着去写Java代码，先在MySQL命令行里验证一下。用下面的命令检查当前使用的数据库和表结构：

mysql -uroot -p123456 USE sims; SHOW TABLES; DESC student; SELECT * FROM admin;

这三个操作分别对应表清单、表字段、初始数据。看到admin表里已经有SHA2加密的密码值，说明建表脚本执行成功；如果输出报错“Unknown database”，说明SQL脚本里的CREATE DATABASE没有执行到当前实例上。用命令行验证的好处是，能先排查掉数据库环节的故障，等Java代码报错时就能聚焦在代码层。很多人一上来就用IDE里的可视化工具执行脚本，出了问题就堆在Java层排查，绕了大弯。

判断表结构是否满足课程设计要求的核心标准是：student表里有多少字段能讲出存在的必要性。比如status字段，表示学生在读状态；grade_year字段，表示年级。如果表里全是name、age这类毫无扩展性的字段，即便系统跑通了，数据库设计得分也不会高。扩展性是评委真正看的东西，几张表之间能连起来回答问题，就够用了。

4. 从DAO到JSP：把增删改查跑通的最短代码路径

4.1 实体类与DAO层：用PreparedStatement防SQL注入，不给自己留“翻车点”

实体类的写法比较固定，student表的每个字段对应一个私有属性，加getter/setter。实体类能直接讲清楚“Java对象和数据库表行”之间的映射关系，答辩时老师常用一句“为什么用对象而不是Map来传数据”来检查基础是否扎实。回答要点是：对象有类型约束，编译期就能发现拼写错误；Map虽然灵活但取值时要强转，运行期容易挂。用代码对比更好说。

DAO层的核心是按业务动作拆分方法：insertStudent、updateStudent、deleteStudent、selectAllStudents、selectStudentByKeyword。其中keyword查询是加分项，支持按学号和姓名模糊搜索，实现“读”的扩展功能。所有增删改查操作，一律使用PreparedStatement代替Statement，这是血泪经验——Statement拼接SQL，字符串里如果含有单引号，不是报错就是被注入，PreparedStatement预编译则可以规避掉这个风险。代码路径如下：

public class StudentDAO { public int insertStudent(Student stu) throws SQLException { String sql = "INSERT INTO student(student_no, name, gender, birth_date, class_id, phone, address) " + "VALUES(?, ?, ?, ?, ?, ?, ?)"; try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, stu.getStudentNo()); ps.setString(2, stu.getName()); ps.setInt(3, stu.getGender()); ps.setDate(4, stu.getBirthDate() != null ? new java.sql.Date(stu.getBirthDate().getTime()) : null); ps.setInt(5, stu.getClassId()); ps.setString(6, stu.getPhone()); ps.setString(7, stu.getAddress()); return ps.executeUpdate(); } } }

这段代码里的try-with-resources是Java 7引入的语法，重点在于：连接和语句使用完毕后自动关闭，不需要手动调用close。DAO里的细节在于setInt和setDate等参数类型的匹配。比如birth_date字段是DATE类型，在代码里存的是java.util.Date，就必须用new java.sql.Date()包装，日期格式不转换直接写进去，查出来时永远是“00:00:00”或直接报日期格式异常。空值也要特判：birthDate是null时，直接setDate(4, null)，否则遇到空指针很无辜。

另外要强调的是，PreparedStatement的executeUpdate()返回的是受影响行数。不要忽略这个返回值，插入成功时它是1，失败时是0。许多人的代码不发异常但数据没插进去，就是因为连接在另一个库上，SQL执行成功但影响的不是当前表。同时把selectAllStudents和selectById写成一个通用模板：查固定字段、循环while(rs.next())封装为Student对象。封装过程就是把数据库列名和实体属性一一对应，最容易犯的错是列名对不上——比如数据库里写student_no，实体属性名写studentno，结果null满天飞。这个阶段的调试经验，非常锻炼人。

4.2 Servlet控制层：编码处理、路径映射与视图转发的三个硬性要求

Servlet这一层，至少三个点位必须做对，缺一个系统就“看起来能用、用起来翻车”。第一个是请求编码处理。Tomcat 8及以上版本默认UTF-8不需要额外设置，但表单如果提交的是GET请求，Tomcat处理URI编码的方式依赖server.xml配置。一个保守做法是，在Servlet里加request.setCharacterEncoding("UTF-8")，以及response.setContentType("text/html;charset=UTF-8")。这两个设置会确保请求体中的中文不被乱码。前端如果用了POST请求，设置这一行就够了；GET请求需要改Tomcat的useBodyEncodingForURI参数，但后续并不推荐在GET里传中文参数，建议直接用POST。

第二个是doGet和doPost的转发方式。处理完业务后，需要通过RequestDispatcher转发到JSP页面。一个常见的错误是用了response.sendRedirect()重定向，导致页面上想用的request.setAttribute("studentList", list)在目标页面里全部取不到——因为重定向是新的一次请求，原请求里的数据都被丢弃了。转发能保留Request域属性。一个正确的Servlet代码段：

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding("UTF-8"); String action = request.getParameter("action"); StudentService service = new StudentService(); if ("add".equals(action)) { Student stu = new Student(); stu.setName(request.getParameter("name")); // ... 剩余字段赋值 service.addStudent(stu); response.sendRedirect("student/list"); } else if ("delete".equals(action)) { int id = Integer.parseInt(request.getParameter("id")); service.deleteStudent(id); response.sendRedirect("student/list"); } else { request.setAttribute("studentList", service.getAllStudents()); request.getRequestDispatcher("/views/student_list.jsp").forward(request, response); } }

第三个是action分流模式的约定。上面这段代码把add、delete、list放在同一个Servlet中，用action参数区分多个操作，这是最省代码的写法，也便于答辩时讲清楚请求是怎么路由的。URL通常这样设计：/student/add、/student/list、/student/delete。如果一步一发请求后直接返回JSP，而不是重定向到list，然后刷新页面时会重复提交上一次的表单。这个坑来自浏览器的机制，血泪经验最多的地方就是这里。解决做法：写操作完成后总是sendRedirect到listURL，读操作才使用forward。凡是“往数据库写了数据的请求”，一律传302跳转。这个设计也能在答辩中体现你对PRG模式（Post/Redirect/Get）的理解。

4.3 Service层与事务处理：为什么删除学生要连班级信息一起考虑

写Service层的主要动机，是要承载一些在DAO层写不下的业务判断和原子性逻辑。比如，删除学生这个动作的前置条件，可以先判断该学生是否有未结清的图书借阅记录（如果有这个模块的话）；如果项目功能只包括基本信息管理，最简单的业务闭环是：新增学生时校验学号不能和现有学生重复。这个校验写在Service里，而不应该在Servlet里单独做。因为Servlet的职责是分发请求，业务规则应该集中在Service层，保证其他入口调用业务方法时都能被统一拦截。

事务处理是Service层的另一个核心价值。比如场景：创建一个学生账号，同时将这个学生分配到某个班级并更新班级人数。两步操作需要放到同一个事务里，任何一个失败都要回滚。DAO层不写事务，Connection在DAO内部创建并关闭；而事务要求同一个连接上执行多条SQL。常见做法是：Service层用ThreadLocal保存一个连接，确保同一个线程内多次获取的是同一条连接，然后手动提交或回滚。

对于课程设计评分而言，能在答辩时说清楚“这里为什么需要事务”比真正写完整套代码更重要。你可以只做一个最简事务示例——批量删除学生，一条SQL成功、一条SQL失败时回滚，就能说明你已经理解事务的意义。注意MySQL的DDL语句（CREATE TABLE/ALTER等）不支持事务回滚，事务只针对DML语句，如INSERT/UPDATE/DELETE。

4.4 JSP页面与JSTL渲染：表格展示、分页条与前端校验的取舍

页面部分以列表页为复杂度上限。一个标准的student_list.jsp中包含：搜索栏、新增按钮、数据表格、删除操作的确认弹窗。表格循环用JSTL的c:forEach替代掉Scriptlet里的while(rs.next())，让前端代码有更好的可读性，也避免在JSP里进行数据库操作被评委扣分。核心片段如下：

<table> <thead> <tr><th>学号</th><th>姓名</th><th>班级</th><th>操作</th></tr> </thead> <tbody> <c:forEach items="${studentList}" var="s"> <tr> <td>${s.studentNo}</td> <td>${s.name}</td> <td>${s.className}</td> <td> <a href="student?action=edit&id=${s.id}">编辑</a> <a href="student?action=delete&id=${s.id}" onclick="return confirm('确认删除？')">删除</a> </td> </tr> </c:forEach> </tbody> </table>

${s.studentNo}这里使用的EL表达式，指调用的是Student对象里的getStudentNo()方法。EL表达式无法直接访问私有属性，它实际上是走的getter方法，这就是必须写getter/setter的原因。delete链接上的onclick有一个confirm确认，这是一个前端防误删的兜底；真正能防误删的核心逻辑还在后端。只做前端校验是不合格的，因为请求完全可以绕过页面直接构造URL发到后端。但是，这里有个简化处理：如果课程设计只有基础CRUD要求，不用把分页做得太复杂，用到LIMIT offset, size即可，多花时间在整体稳定性上更划算。

5. 部署与运行实战：Tomcat里的生命周期、映射冲突和几个常见报错的排查

5.1 用IDEA本地部署Tomcat的最小步骤与运行验证

推荐使用IntelliJ IDEA社区版，它本身带Servlet代码补全和Tomcat集成。配置Tomcat的路径是Setting -> Build, Execution, Deployment -> Application Servers，添加你的Tomcat安装目录之后，IDEA会自动识别版本。接下来创建一个本地运行配置，Deployment选项卡里选择exploded war包。这里有一个新手最容易搞错的地方：如果你选择了war包模式，IDEA每次构建都不会自动解压到Tomcat的webapps目录，而exploded war会把整个目录部署上去，这样改JSP刷新就能生效，不用每次重启。除非你是做绝杀演示，否则狠狠推荐exploded模式。

启动Tomcat时，最好通过控制台日志确认“Deployment of web application archive has finished”，再打开浏览器访问。如果起步第一件事就是旧的JSP缓存，会不会导致改了页面但不生效？会的。所以设置里把“Build project automatically”打开，JSP改动会自动即时编译；否则你改完页面刷新看不到效果，还以为JDK编译有问题，浪费半小时很常见。

5.2 端口冲突、ClassNotFound和JSP编译错误的排查清单

这个章节专门收集常见报错，按照现象、原因、解决逐条列出，更真实：

现象：Tomcat启动时报“Port 8080 was already in use”。原因：之前的不正常退出的Java进程还占用着端口。解决：找到占用进程并杀掉。Windows下用netstat -ano | findstr 8080查看PID，然后taskkill /F /PID xxx。这里额外提一个大家很少意识到的情况：如果你装了多个版本的Tomcat，某个版本的server.xml里改过端口，另一个还是默认8080，两个一起启动必然冲突。检查IDEA的配置里Actual port是不是8080，再看Tomcat目录conf/server.xml是否同步改过。

现象：启动一瞬间报ClassNotFoundException: com.mysql.jdbc.Driver。原因：MySQL驱动jar包没有打进war包，或者依赖scope设置成provided导致没有包含在WEB-INF/lib下。解决：打开Project Structure的Artifacts选项卡，检查WEB-INF/lib下是否有mysql-connector.jar文件，没有就直接从本地Maven仓库手动拷贝进去。每次手动拷贝是比较低效的，但课程设计的场景下打开Artifacts配置确认比反复clean干净得多。

现象：访问JSP页面报The type java.io.ObjectInputStream cannot be resolved。原因：Tomcat运行环境和编译环境使用了不同版本的JDK。比如JSP页面的javac版本是17，而Tomcat使用的是JDK8启动，这个不兼容会产生莫名其妙的编译错误。解决：把整个项目的语言级别设为与Tomcat所在JDK相同的版本，拒绝使用高版本编译输出低版本运行。最稳妥的组合是JDK8+Tomcat8.5+MySQL5.7，全链路都是老搭档，极少出错。

现象：JSP页面直接用println输出表格，内容出现乱码。原因：JSP页面声明pageEncoding，与Tomcat处理响应时的内容编码不一致。解决：在JSP页面开头写上<@page contentType="text/html;charset=UTF-8" language="java" %>，确保pageEncoding和contentType同时指定，这是两个独立参数，不是写一个就完了的。

现象：删除一条记录后，页面提示成功，但刷新后记录又回来了。原因：删除操作可能在事务中被回滚。比如Service层声明了事务，这条删除SQL执行出错但异常被你catch掉，于是事务没有回滚，也没有提交。解决：在事务代码块中设置一个flag，只要一条SQL失败就直接抛出异常，不要做吞掉异常的操作。

5.3 说明文档的写作顺序：哪些内容必须截图，哪些用表格呈现

按这个项目名称注定要交付说明文档。所谓“说明文档”，在答辩语境里不是几百字的项目介绍，而是一份能够让人照着部署成功的操作手册。我建议的结构是：编写目的、环境要求、部署步骤、系统功能说明、数据库设计说明、测试用例。其中部署步骤是核心，数据库设计说明里的ER图是整个文档中最有价值的部分，建议用工具画一张实体关系图，用文字描述三张表和它们之间的关系。

环境要求部分建议用表格列出，比大段文字看着有逻辑：

文档里至少要包括一个典型的登录时序说明：用户输入账号密码，LoginServlet执行查询，比对成功后把用户名放入Session，转发到主页面。整个交互用文字即可描述，但建议把浏览器地址栏变化路径写清楚，否则评委不知道你请求从哪里来、到哪里去。说明文档不需要写成软件工程教材，但要在显著位置写明“如何从零部署”，这是评委最关心的事——他拿到你的代码后，要能在一个半小时内跑起来。

6. 从“能跑”到“答辩高分”：三个必做的验证技巧与一个加分的登录优化

到这一步，系统基本完成了。课程设计的终点不是写完，而是“能演示、能讲清、能扛问”。“能扛问”的关键在于做几个边缘测试，提前找出自己会心虚的地方并修掉。

第一个验证是重复数据测试。在系统中新增一个学号与现有学生相同的记录，看看是否有报错提示。如果这个时候抛出的是500错误页面，说明缺少异常处理，评委一定会挑刺。正确处理：Controller层捕获DuplicateKeyException，回传到新增页面并显示“学号已存在”的友好提示。这个动作既展示了异常处理能力，也展示了你的数据库约束意识。

第二个验证是空数据查询。清空student表后再进入列表页，表格应当显示为空而不是一大片空白。建议在JSP里用c:if配合empty判断，显示一个“暂无数据”的提示行。这个小细节并不多费事，但在答辩演示时，能制造一个“这学生考虑得很全面”的现场印象。

第三个验证是权限控制。系统虽然声明了登录功能，但如果未登录时直接访问list页面，系统应该拦截并跳转到登录页。建议实现一个简单的Filter，检查Session中是否存在用户对象；没有就转发到login.jsp。这是“登录功能”的完整闭环，也是课程设计里容易被忽略的评审点。

登录模块还要做一个真实可用的优化：用Session保存登录状态，退出时调用session.invalidate()，修改密码成功后强制重新登录。密码存储从SHA2升级到加盐的BCrypt，可以多讲两句，因为近年来的数据泄露事件在教学案例中被反复讨论，讲出来会让评委觉得你关注安全，而不只是会CRUD。

最后是演示时的习惯：启动Tomcat前，先确认MySQL服务已启动，再刷新浏览器。我见过太多人演示当天全栽在MySQL服务没启动上，然后临时去调服务，十分钟过去场面一度尴尬。你现在不如提前把启动顺序做成一个checklist贴在自己的开发机上，同时顺手在说明文档里也写进去，这也是“好的项目文档应该告诉别人会踩到哪些坑”的体现。希望帮到你。

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