Java Web学生成绩管理系统：JSP+Servlet+JDBC部署全解析

简介：一份基于Java Web的学生成绩管理系统完整项目压缩包，面向正在学习Servlet、JSP、JDBC和MVC开发的初学者，也可作为课程设计或毕业设计参考。包内共36个文件，以10个Java源文件、9个JSP页面为主体，搭配XML、MF、MD等配置与说明文件，另含10张运行界面截图和3张图片素材，直观展示成绩录入、修改、查询、筛选和统计等页面效果；整体约2.94MB，目录结构清晰，便于导入阅读。项目覆盖从数据库设计、JDBC操作到Servlet/JSP前后端交互的完整开发链路，并涉及基础安全控制，适合希望通过实际案例串联Java Web知识点的读者。已有34人学习下载。

1. 基于 Java 的 Web 学生成绩管理系统：从源码包到页面验收只差一步

最近有读者发来一个基于 Java 的 Web 学生成绩管理系统源码包，说是课程设计作业，解压后发现目录有点乱，不知道从哪下手。我拆了一遍，这份资源是典型的 JSP + Servlet + JDBC 传统 Java Web 项目，不是 Spring Boot 全家桶，反而能帮你看清浏览器请求到 Servlet、再到 JDBC 和数据库的完整链路。它能解决的是从零跑通成绩录入、修改、查询、筛选排序、统计这一整套功能，并理解背后的 MVC 分层。适合正在做课程设计、准备 java 基础面试、或者想拿现成项目改一改当作品集的 java 新人。文末我会给出下载方式。

2. 项目结构拆解：从 src 到 WebRoot，先看清数据库与页面模块

2.1 解压后的目录说明了哪些功能模块

拿到项目包先别急着启动，把目录摊开看一遍。这次解压出来主要有 src、WebRoot、运行界面截图三块，src/stuPackage 里放 Java 后端，WebRoot 下是 JSP、WEB-INF、图片等 Web 资源。我按长期拆项目的习惯，把关键路径和对应的功能判断整理成一张表：

截图里反复出现“数据表设计.jpg、查询页面.jpg、数据表内容.jpg、录入或修改页面.jpg、录入或修改结果（可在页面中修改成绩，点击提交保存）.jpg、成绩筛选页面.jpg、成绩筛选结果（按查询成绩降序排列）.jpg、成绩统计页面.jpg、系统首页.jpg、查询结果.jpg”。从这些命名可以看出项目至少包含五个模块：

第一个是查询模块，查询页面配合查询结果展示，学生或教师输入条件后看到成绩列表。第二个是录入或修改模块，页面里能直接改分数，点提交保存后把数据写回数据库，这个动作在截图名里专门标了出来，说明作者把“页面内修改 + 提交持久化”当作核心演示点。第三个是成绩筛选模块，筛选结果按查询成绩降序排列，排序逻辑是在 SQL 层实现的。第四个是成绩统计模块，对已录入成绩做统计展示。最后是系统首页，作为所有功能的入口。这几个模块加起来，正好覆盖了学生成绩管理系统最常用的场景：录入、修改、查询、排序、统计。

为什么要先看截图？因为截图是作者跑通后留下的现场证据。如果你部署完发现页面长得不一样，或者排序顺序不对，就能对照截图找出是自己 SQL 写错还是项目版本差异。我在拆这类资源时，第一件事就是把所有 jpg 按名字排好序，再打开 web.xml 看 Servlet 映射，基本不会错。

2.2 为什么是 JSP + Servlet + JDBC，而不是直接上 Spring Boot

看到这里你可能会问：现在公司里都用 Spring Boot，为什么课程设计资源还是这种老组合？答案很简单：这门课的考核点就是让你说清楚 Servlet 生命周期、JSP 内置对象、JDBC 事务这些底层概念，Spring Boot 把太多东西封装成了黑匣子，不适合用来验证“你是不是真懂”。这套项目的分工是严格按 MVC 来的：

• Model 层：stuPackage 里的实体类和 DAO，负责封装学生、成绩数据结构，并用 JDBC 完成增删改查。
• View 层：WebRoot 下的 JSP 页面，通过 JSP 标签和表达式把结果集渲染成表格。
• Controller 层：Servlet 接收前端请求，调用 DAO 拿到数据，再转发给 JSP 展示。

浏览器访问时的完整数据流是这样的：index.jsp 发出请求，web.xml 根据 URL 找到对应 Servlet，Servlet 把 request 里的参数拆出来，调用 stuPackage 下的 DAO 方法，DAO 通过 DBUtil 拿到 Connection 执行 SQL，结果集返回给 Servlet，Servlet 把结果放进 request 或 session 作用域，最后 RequestDispatcher 转发到 JSP 页面。这个链路里，只要有一环名称不匹配，页面就会 404 或 500。

用 JDBC 直接操作数据库，比 MyBatis 或 Hibernate 更直观的地方在于，你能看到 SQL 在哪里执行、ResultSet 是怎么被逐行读出来的。这对 java 基础不牢的读者来说是最合适的补习材料。很多人在面试时被问“JDBC 连接数据库的七步”，如果平时只写过 Spring Boot 的 JPA，大概率答不全；而这个项目里的 DBUtil 类就是把那七步写给你看：加载驱动、获取连接、创建 Statement、执行 SQL、处理 ResultSet、关闭资源、处理异常。

另外要提醒一句：这个项目不是 Maven 工程，没有 pom.xml，所以 jar 包都在 WebRoot/WEB-INF/lib 里。这也就意味着，如果你平时习惯 IDEA 的 Maven 依赖自动下载，在这里要手动确认 lib 下有没有 mysql 驱动，没有的话要放进去。后面部署章节我会专门讲这个。

2.3 从 web.xml 反推 Servlet 映射：先看 URL 再看页面

打开 WebRoot/WEB-INF/web.xml，一般能看到类似下面的配置节选：

<servlet> <servlet-name>ScoreServlet</servlet-name> <servlet-class>stuPackage.servlet.ScoreServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>ScoreServlet</servlet-name> <url-pattern>/score</url-pattern> </servlet-mapping>

这个配置的意思是：浏览器访问 /score 时，Tomcat 会把请求交给 stuPackage.servlet.ScoreServlet 处理。如果 JSP 里 form 的 action 写的是 /score 而 web.xml 里映射成了 /scoreServlet，那提交后必然 404。我拿到这种项目时，会先把所有 url-pattern 抄下来，再打开 JSP 对着看 action 和超链接，这样能很快定位页面跳转问题。web.xml 里的 welcome-file 也很关键，它决定访问项目根路径时默认加载哪个页面，通常是 index.jsp。这个习惯对后面排错非常有用。

3. 环境准备与数据库初始化：用数据表设计图还原建表 SQL

3.1 JDK、Tomcat、MySQL 的版本搭配与安装验证

先谈版本选择。项目是传统 Java Web，源码里用的应该是 javax.servlet 规范，所以 Tomcat 不能用 10 或 11，否则 Servlet 包名全变了，ClassNotFoundException 很快就来。我的建议搭配是：JDK 1.8 + Tomcat 8.5 或 9.0 + MySQL 5.7。如果本机装了 MySQL 8.0 也没关系，只要把驱动换成 mysql-connector-java 8.x，URL 里加 serverTimezone，一样能跑。

安装完先验证三个环境变量。Windows 下可以这样检查：

java -version echo %JAVA_HOME% echo %CATALINA_HOME% mysql --version

这里“echo %JAVA_HOME%”是 Windows 的写法，Linux/macOS 下对应 echo $JAVA_HOME。java -version 能打印版本说明 JDK 可用；CATALINA_HOME 是 Tomcat 的安装根目录，启动脚本会依赖它；mysql --version 确认 MySQL 客户端在 PATH 里。如果 JAVA_HOME 没配，Tomcat 启动会直接报错“Neither the JAVA_HOME nor the JRE_HOME environment variable is defined”。这是一个典型的起步坑，值得先排掉。

3.2 根据数据表设计图落库：学生表、成绩表、用户表

解压目录里有“数据表设计.jpg”，我建议你打开它对照着建表。项目包没有 sql 文件时，设计图就是字段依据。下面给一个通用的结构，字段名可能和你的包里有差异，但建表思路一致。我把三张表写在一起：学生表、成绩表、系统用户表。库名、表名我按通用风格起名，实际以你的设计图为准。

CREATE DATABASE IF NOT EXISTS student_score DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE student_score; CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT '学生ID', stu_no VARCHAR(20) UNIQUE COMMENT '学号', name VARCHAR(50) NOT NULL COMMENT '姓名', class_name VARCHAR(50) COMMENT '班级', major VARCHAR(50) COMMENT '专业' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE score ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT '成绩ID', student_id INT NOT NULL COMMENT '关联学生ID', course VARCHAR(50) NOT NULL COMMENT '课程名', score DECIMAL(5,2) NOT NULL COMMENT '成绩分数', exam_date DATE COMMENT '考试时间', FOREIGN KEY (student_id) REFERENCES student(id) ON DELETE CASCADE ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE sys_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(30) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; INSERT INTO sys_user (username, password) VALUES ('admin', '123456');

这段 SQL 里有几个点要说明。成绩表的 score 字段用 DECIMAL(5,2)，是因为成绩需要保留两位小数，比如 88.50；如果用 FLOAT，浮点误差会让排序结果出现莫名其妙的偏差。外键 ON DELETE CASCADE 表示删除学生时自动删除其成绩，这符合成绩系统的主从关系。学号字段加了 UNIQUE，避免同一个学生被重复插入。sys_user 表的 password 我用明文，因为课程设计项目里一般不做加密展示；如果要交作业，建议改成 MD5 后再比对。

建完表之后再执行几条 INSERT，方便后面页面有数据可查：

INSERT INTO student (stu_no, name, class_name, major) VALUES ('2021001', '张三', '计科2101', '计算机科学与技术'), ('2021002', '李四', '计科2101', '计算机科学与技术'); INSERT INTO score (student_id, course, score, exam_date) VALUES (1, 'Java程序设计', 88.50, '2024-06-30'), (1, '数据库原理', 92.00, '2024-06-30'), (2, 'Java程序设计', 76.00, '2024-06-30');

插数据的时候要注意 student_id 必须和 student 表里的 id 对应，否则外键约束会直接报错。验证是否成功，可以用这条 SQL 看列表：

SELECT s.name, s.stu_no, sc.course, sc.score FROM student s JOIN score sc ON s.id = sc.student_id ORDER BY sc.score DESC;

这一条就对应截图里的“成绩筛选结果（按查询成绩降序排列）”。ORDER BY sc.score DESC 是降序的关键，ASC 才是升序。有些新手在这里容易写成 ORDER BY sc.score，默认是升序，页面表现正好和截图相反。

3.3 数据表内容截图里暗藏的测试数据

运行界面截图里有一张“数据表内容.jpg”，这张图能告诉你系统初始数据长什么样，也能反向验证你的 SQL 是否正确。比如截图里显示张三、李四、Java程序设计、88.50 这些行，那你就应该在本地也插入相同的数据，等页面查询出来后再逐行比对。我的做法是：在 SQL 里把截图出现过的数据完整录一遍，包括中文姓名和分数，这样页面查询结果和截图一致，说明代码和数据库连接都没问题。

如果数据表内容里没有截图里的数据，那说明项目作者提交的是空库，初始数据由页面录入。你可以先不加 INSERT，直接通过页面录入两条，再刷新数据库看是否落库，同样能验证。顺带说一句，做这个验证的时候最好打开 MySQL 日志或者控制台 SQL 输出，能直观地看到页面操作映射成了哪种 SQL，这对理解 JSP + Servlet + JDBC 的协作关系很有帮助。

4. 部署到 Tomcat：连接参数、启动顺序与三个验收入口

4.1 把传统 Web 工程导入 IDEA 2024 或 Eclipse

这个资源是 Eclipse 结构的 Web 工程，没有 pom.xml，所以导入方式和 Spring Boot 完全不一样。我平时用的 IDEA 2024 也支持，但要做几步配置。先把 src 目录标记为源码根目录，把 WebRoot 标记为 Web 资源目录：

在 IDEA 里打开项目后，右键项目名，选 Open Module Settings，进入 Project Structure。在 Modules 标签页里，把 src 设为 Sources，把 WebRoot 设为 Web Resources Directory，并指定 Web 描述符 web.xml 的路径。如果没有现成的 Artifact，在 Artifacts 标签里新建一个 Web Application: Exploded，把项目模块加进去。这一步不做好，点运行时会提示“Web facet not configured”，或者找不到 web.xml。

如果你实在不习惯 IDEA 的 Web 工程配置，直接用 Eclipse 也可以。导入方法更简单：File > Import > Existing Projects into Workspace，选中项目根目录，Eclipse 会自动识别 src 和 WebRoot。很多课程设计环境就是 Eclipse + Tomcat 插件，项目作者大概率也是这样运行并截图保存的。

4.2 找到 DBUtil 类，改掉 JDBC 连接参数

启动前必须改的是数据库连接。项目里连接数据库的类一般叫 DBUtil.java 或 DBConnection.java，在 src/stuPackage 下。如果 web.xml 里配了 context-param，也可能写在 web.xml 里。我用最常见的 DBUtil 写法说明，包名和类名以你解压后的实际位置为准：

package stuPackage.util; import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; public class DBUtil { private static final String URL = "jdbc:mysql://localhost:3306/student_score?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai"; private static final String USER = "root"; private static final String PASSWORD = "root"; static { try { Class.forName("com.mysql.jdbc.Driver"); } catch (ClassNotFoundException e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }

代码里 URL 末尾的 serverTimezone=Asia/Shanghai 不是可有可无的。在高版本驱动下不指定时区，连接时大概率报“The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized”。useSSL=false 是关闭 SSL 握手，减少警告；如果不开，控制台刷一堆 SSL 提示。USER 和 PASSWORD 要改成你自己 MySQL 的用户名密码，这里最容易出现 Access denied。

另外注意驱动包名。如果 WEB-INF/lib 里放的是 mysql-connector-java-5.1.x，驱动类就是 com.mysql.jdbc.Driver；如果是 8.x 版本，要改成 com.mysql.cj.jdbc.Driver，否则 Class.forName 会抛 ClassNotFoundException。我接手别人的项目时，第一件事就是打开 lib 目录看驱动 jar 的版本，再决定写哪个类名，这一步能省一次重启 Tomcat 的时间。

4.3 启动 Tomcat，按截图逐页验收

配置完成后，在 IDEA 或 Eclipse 里把项目部署到 Tomcat，运行后访问 http://localhost:8080/项目名/index.jsp。项目名要和 IDEA 里 Artifact 名一致，比如解压后叫 student_manager，那 URL 就是 /student_manager。如果首页不是 index.jsp，web.xml 里配置了 welcome-file，访问项目根路径也会自动跳转。

验收时我习惯按三条线走。第一条线是查询：进入查询页面，输入学号或姓名，看能否返回结果，返回结果是不是和数据表内容一致。第二条线是录入/修改：在录入或修改页面改一个成绩，点提交保存，然后打开数据库执行 select，看这个值有没有真的写进去。第三条线是筛选和统计：在成绩筛选页面确认排序是降序，在统计页面看平均数、人数等数据对不对。三条线全过，这个资源就算在你本机真正跑通了。

启动过程中如果看到页面报 500，优先看 Tomcat 的 localhost 日志，或 IDEA 控制台里的异常堆栈。大部分问题会集中在连接数据库和 SQL 语法两处，这也是最常见的原因。

提示：改完 DBUtil 一定要重启 Tomcat，很多“改了没生效”是因为只执行了热部署，没真正重启。

4.4 非 Maven 项目的 jar 包管理：lib 目录别乱动

这个项目没有 pom.xml，所以所有依赖都在 WebRoot/WEB-INF/lib 下。常见依赖有 jstl.jar、standard.jar、mysql-connector-java-xxx.jar。如果你发现页面里 JSP 用了 JSTL 标签却报错，第一反应应该是 lib 下的 jstl.jar 缺失或版本不匹配。复制别人项目时，lib 目录要单独保留，不要只复制 src 和 WebRoot 页面。

还有一点是 jar 包冲突：Tomcat 安装目录的 lib 下有 servlet-api.jar，项目里如果再放一份旧版，可能导致重复类。建议项目 lib 里不要放 servlet-api.jar，依赖 Tomcat 自带的即可。如果你的项目在别人机器上正常，到你这就报 NoClassDefFoundError，多半是 lib 没拷全，或者两个 lib 目录混了。

5. 避坑与常见问题排查：五个反复出现的翻车点

5.1 数据库连接失败：Communications link failure

现象：打开页面后直接抛 java.sql.SQLException: Communications link failure，或者报 Cannot connect to MySQL server on localhost:3306。

原因：MySQL 服务没启动，或端口不对，或 URL 里的库名不存在。课程设计的机器经常装过 MySQL 但忘记启动，3306 端口没监听，驱动连不上。

解决：先在命令行执行 mysql -uroot -p 确认能正常登录；再执行 SHOW DATABASES; 确认 student_score 库存在；接着检查 URL 里的 host、端口和库名是否和实际一致。如果改了 MySQL 端口，记得同步改 URL 里的 3306。

5.2 中文乱码：JSP、请求、数据库三处要统一

现象：页面上中文标题正常，但查询出的学生姓名变成 ???，或者保存后再读出来是乱码。

原因：JSP 页面编码、Servlet 接收请求时的编码、JDBC URL 中的 characterEncoding、表结构字符集四处只要有一处不一致，就会乱码。典型配置是页面用 UTF-8，数据库却用了 latin1。

解决：JSP 顶部加 <%@ page contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>；Servlet 中处理 POST 请求时先执行 request.setCharacterEncoding("UTF-8")；JDBC URL 里带 characterEncoding=utf8；已经建好的表可执行 ALTER TABLE student CONVERT TO CHARACTER SET utf8mb4;。改完重启，再重新录入一条中文数据测试，不要在旧乱码数据上反复看。

5.3 Tomcat 10 导致的 javax.servlet 找不到

现象：启动时抛 java.lang.ClassNotFoundException: javax.servlet.ServletException，或者页面 500 提示 Servlet 类加载失败。

原因：Tomcat 10 开始把 Java EE 的 javax.servlet 迁移成了 jakarta.servlet，老项目引用的包名全是 javax，直接失去对应类。很多新手从官网下载了最新的 Tomcat 10，却不知道这个变更。

解决：换回 Tomcat 8.5 或 9.0。这是成本最低的方案。如果你必须用 Tomcat 10，就要把源码和 JSP 里所有 javax.servlet 替换为 jakarta.servlet，项目里 servlet-api.jar 也要同步替换，改动量不小，课程设计没必要。

5.4 修改数据库后页面数据不更新

现象：直接在 MySQL 里改了成绩，回到页面刷新还是旧数据。

原因：页面调用了 Servlet，而查询语句每次新建 Connection，看起来不该有缓存。但一些项目会在 DAO 里把查询结果放到 session 作用域，第一次查询后 session 里存了旧快照，重新查询没有强制覆盖。

解决：检查 Servlet 转发时用的是 request.setAttribute 还是 session.setAttribute。request 作用域每次请求都新建，不会保留旧值；session 作用域则会跨请求。如果发现是 session 的问题，改成 request 即可。还有一个隐蔽点是没有执行提交事务，MySQL 的 InnoDB 默认自动提交，但如果代码里手动开启了事务且没 commit，页面读不到数据。这时候看控制台有没有“Transaction not successfully committed”。

5.5 端口被占用导致 Tomcat 启动失败

现象：Tomcat 启动几秒后自动停止，控制台报 Port 8080 required by Tomcat v9.0 Server at localhost is already in use。

原因：本机已有其他服务占用 8080，或前一个 Tomcat 实例没关干净。

解决：改成其他端口，在 server.xml 的 Connector 节点把 port="8080" 改为 8081，然后重启，访问 http://localhost:8081/项目名/index.jsp。或者找到占用进程杀掉；Windows 用 netstat -ano | findstr 8080，Linux 用 lsof -i:8080。改端口是最省事的方案，但注意 README 里的截图是 8080，改完后别搞混。

6. 进阶：两个 SQL 把成绩筛选和统计做进现有 DAO

这个资源本身已经能跑，但如果你想把它写到简历里，或者课程设计想加亮点，不需要大改，先把筛选和统计这两个现有模块的 SQL 换成可复用写法。第一个是按成绩降序筛选某个班的成绩及排名，第二个是统计课程的平均分、最高最低分和及格率。

-- 降序筛选，并附加排名 SELECT s.stu_no, s.name, sc.course, sc.score, RANK() OVER (PARTITION BY sc.course ORDER BY sc.score DESC) AS course_rank FROM score sc JOIN student s ON s.id = sc.student_id WHERE s.class_name = '计科2101' ORDER BY sc.course, course_rank;

-- 课程统计 SELECT sc.course, COUNT(*) AS total_count, ROUND(AVG(sc.score), 2) AS avg_score, MAX(sc.score) AS max_score, MIN(sc.score) AS min_score, ROUND(SUM(CASE WHEN sc.score >= 60 THEN 1 ELSE 0 END) / COUNT(*) * 100, 2) AS pass_rate FROM score sc GROUP BY sc.course;

RANK() OVER 是 MySQL 8.0 的窗口函数，如果你的环境是 5.7，就改成在 Java 里用循环计算排名，否则 SQL 会直接报语法错误。统计 SQL 里的 CASE WHEN 可以用在及格率计算上，比单独查两次再除更利索。

把这个 SQL 嵌入现有 DAO 的思路是：在 stuPackage 下新建一个 StatisticsDao.java，写按课程统计的方法，返回 List<Map<String,Object>>，Servlet 拿到后直接转给 JSP 表格展示。注意 ResultSet 读完后要 close，连接要归还给 DBUtil，这两步写在 finally 里，防止连接被耗尽。

我自己的习惯是拿到任何传统 Java Web 资源，都强制按“看截图 → 看 web.xml → 改 DBUtil → 建表 → 启动”的顺序走一遍，顺序错一次就可能白调半天。这个项目的好处是结构简单、截图齐全，照着这个顺序基本二十分钟能跑起来。希望帮到你，下载后有问题可以对照着本文排查。

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