简介：一套面向初学JavaWeb开发者的学生成绩管理系统实战项目，旨在帮助读者把Servlet、JSP、模型-视图-控制器设计模式与动态代理等知识串联起来，落实到登录认证、学生管理、课程管理、成绩录入等完整业务流程中。压缩包内有271个文件，约23.41MB，以源代码、数据库脚本和说明文档为核心。其中Java程序与Java服务器页面分别负责业务逻辑和界面展示，配置文件用于设置数据源与运行参数，依赖包提供功能支撑，SQL脚本可一键初始化MySQL数据库，Word文档则对部署步骤和项目目录进行了说明。已有6979人学习下载，适合课程设计、毕业设计或个人自学练手。通过完整源码，既能掌握基于模型-视图-控制器模式的项目分层思想，也能体会动态代理在权限控制中的实际用法，配合数据库脚本可快速跑通系统，为进一步深入JavaWeb开发打下基础。
1. 学生成绩管理系统：为什么 Java 课设总爱打包成源码、数据库脚本和文档三件套
学生成绩管理系统是 Java 课程设计里最常见的工程样本之一。它的交付形态常年是一个压缩包：源码、数据库脚本、文档各占一份，看起来只是交作业的存档，实际上覆盖了一个小型关系型应用从建表、连库、增删改查到统计报表的全部流程。很多人拿到压缩包的第一反应是解压后拖进 IDE 点运行，然后被 ClassNotFoundException 或者连接超时劝退。这个项目本身不算复杂，难在三件套的配合没有理顺：源码里的连接串对应哪个库，脚本里的库名和账号密码对不对，文档里画好的模块在代码里是否真的存在。这篇文章按实际做课设指导的顺序拆开讲，先盘点代码包，再把数据库脚本跑干净，然后回到源码逐层核对，最后用五类高频报错收尾，让一套学生成绩管理系统在本地稳稳跑起来。
2. 拆包第一步：源码、数据库脚本、文档的分工关系与验收顺序
拿到一个 .rar 代码包，别急着双击那个主类文件。先做一次系统性盘点，通常五分钟就能把后续可能踩的坑摸出大半。拆包的本质不是解压，而是确认三件事：脚本能不能独立导入，源码能不能独立编译，文档跟源码说的到底是不是同一个版本。
2.1 三件套各管一段生命周期，少任何一件都修不干净
源码是业务逻辑的最终表现。它决定界面上某个按钮点击后发生什么、查询条件怎么拼、管理员和普通用户在哪里被区分。数据库脚本是系统的初始状态。建库、建表、插入几条演示成绩数据，等于给代码准备好启动条件。单独跑源码而没有脚本时，程序会反复提示数据库连接失败或表不存在，这时候孤立地去改代码解决不了任何问题。文档则是产品层约定，比如有哪些角色、哪些用例、成绩是录入后立即生效还是需要审核，这些规则在代码里经常分散在十几个方法里，文档把它们串成一条可验收的线。
按我拆这类包的习惯，第一眼只扫三处：
| 交付物 | 回答的问题 | 最容易出问题的地方 |
|---|---|---|
| 数据库脚本 | 系统初始数据从哪来 | 建表顺序、外键依赖、字符集 |
| 源码 | 业务逻辑怎么做 | 驱动类、连接串、JDK 版本 |
| 文档 | 需求边界在哪 | 版本漂移、表名与代码不一致 |
三者之间没有优先级先后，但有一个推荐的操作顺序：先跑脚本、再改连接串、最后启动项目。脚本跑不干净时，所有代码层面的报错都会被误诊成代码问题，整个排错周期会拉得很长。
2.2 用几条命令把压缩包结构摸清楚，再决定用哪种方式启动
第一步通常先验证压缩包完整性，避免解压到一半才提示损坏。Windows 下直接双击解压工具也能做测试，Linux 下我习惯这样操作：
# 只测试压缩包完整性，不实际解压 unrar t student_score.rar # 完整解压到当前目录 unrar x student_score.rar # 列出两层以内的文件，判断项目形态 find . -maxdepth 2 -type f | sortunrar t只做测试，不会产生文件，适合拿包先验伤；unrar x才是真正解压。中间的find命令会把源码文件、SQL 文件和文档一次性摊开。看到有pom.xml说明是 Maven 工程，看到WebContent/WEB-INF/web.xml说明是 Servlet 工程，只有.java文件散落时多半是 Eclipse 老式工程。形态不同，后面启动方式完全不一样，这一步不能省。
解压之后接着做一件事：打开README.txt或文档里的“运行环境”一节。很多课设代码包都会写明 JDK 版本和数据库版本，比如 MySQL 5.7 还是 8.0，这直接决定驱动类名和连接串写法。千万不要跳过这一步直接导入 IDE，环境不匹配带来的报错在外观上几乎一样，却最难分清是哪一端出了问题。
2.3 环境预检：JDK 版本、MySQL 版本、驱动包版本要三处对齐
学生成绩管理系统最常见的运行环境是 JDK 8 配 MySQL 5.7 或 MySQL 8.0。三处任意错一位，跑起来都会暴露一些看起来莫名其妙的错误。先执行两条命令确认现状：
java -version # 例如输出 openjdk version "1.8.0_202" mysql --version # 例如输出 mysql Ver 14.14 Distrib 5.7.36如果本地是 JDK 8，而源码里用了List.of()、var这类语法，基本能判断源码是高版本 JDK 写的，需要换 JDK 或回退语法。数据库方面最麻烦的是版本差异，5.7 和 8.0 在认证方式和驱动类名上都不一致。常见搭配可以参考下表：
| 驱动包版本 | Class.forName 类名 | 适合数据库 |
|---|---|---|
| 5.1.x | com.mysql.jdbc.Driver | MySQL 5.6 / 5.7 |
| 8.0.x | com.mysql.cj.jdbc.Driver | MySQL 8.0 |
如果代码里写的是com.mysql.cj.jdbc.Driver，项目 lib 目录里却只有 5.x 的 jar，运行时会在加载驱动那一行直接抛NoClassDefFoundError，跟驱动没加进 classpath 的表现很像，但定位方式完全不同：一个要替换 jar，一个要添加 jar。区分方法是看异常栈里是ClassNotFoundException还是NoClassDefFoundError，前者是类完全找不到，后者是类存在但初始化失败。这一下就能省出半个小时的试错时间。
3. 数据库脚本先行：导入成绩库、对齐 JDBC 参数、从表结构反推功能
代码包里的 .sql 文件是整个系统的地基。地基没打对，后面所有排错都是在替数据库背锅。这一章把从导入脚本到核对连接参数的过程拆成三步，每步都带可以直接执行的命令。
3.1 导入脚本的两种方式与字符集兜底
拿到脚本的第一件事是确认脚本头部有没有建库语句。常见做法是脚本文件里直接写：
CREATE DATABASE IF NOT EXISTS score_db DEFAULT CHARACTER SET utf8mb4; USE score_db;IF NOT EXISTS是为了防止重复导入时报错，utf8mb4则是为了中文成绩单和姓名不出现乱码。如果脚本里没有这段，需要手动建库并把默认字符集设对。导入命令有两种，效果略有差别：
# 方式一：重定向输入，适合完整文件一次性导入 mysql -u root -p < /path/student_score.sql # 方式二：交互式会话里执行 source mysql -u root -p mysql> source /path/student_score.sql;方式一简单直接，但出错时定位相对困难；方式二能看到每一条语句的执行结果，第一次导入建议用source。导入完成后用一条 SQL 检查服务端字符集：
SHOW VARIABLES LIKE 'character_set_server';如果输出不是utf8mb4，说明服务端默认字符集偏低。最快调整方式是在 MySQL 配置文件的[mysqld]段加上character_set_server=utf8mb4后重启服务。如果此前已经用 latin1 建过库，光改服务端变量不够，必须删库重建，否则表结构里的字符集仍然是旧的。这一点是很多中文乱码问题的根因，属于“删库重来”的一类后悔药。
3.2 JDBC 连接串里值得反复核对的那几个参数
数据库脚本跑通后，再回到源码看连接配置。成绩管理系统的 JDBC 连接串通常长这样：
String url = "jdbc:mysql://localhost:3306/score_db" + "?useUnicode=true&characterEncoding=utf8" + "&useSSL=false&serverTimezone=Asia/Shanghai" + "&allowPublicKeyRetrieval=true"; Connection conn = DriverManager.getConnection(url, "root", "123456");这段代码浓缩了几个高频翻车点。逐个说清楚：
| 参数 | 作用 | 典型坑 |
|---|---|---|
| useUnicode / characterEncoding | 保证中文字符正常入库出库 | 不写会出现中文乱码 |
| useSSL=false | 关闭 SSL 握手 | MySQL 8 默认打印警告 |
| serverTimezone | 时区对齐 | 不设置直接抛时区异常 |
| allowPublicKeyRetrieval | 允许获取服务器公钥 | MySQL 8 报 Public Key Retrieval is not allowed |
最容易被忽略的是serverTimezone。新版本 JDBC 驱动要求显式指定时区，缺了它会在启动时直接抛The server time zone value 'CST' is unrecognized。很多同学遇到这行报错会去改系统时区，绕了一大圈，其实只要在连接串里加上serverTimezone=Asia/Shanghai就结束了。
另一个注意事项是账号密码。课设包里写的密码通常不是本机的密码，导入脚本只负责建库建表，不会帮你改 MySQL 用户密码。连接串里的用户名和密码必须跟本机 MySQL 实际账号完全一致，这是第一道排查点。经常出现脚本执行成功、依赖也齐全，唯一的原因是密码不对，报错还被隐藏在一大段Access denied里。
3.3 从表结构反推系统的功能边界
脚本导入后，用DESC或直接看 .sql 文件里的建表语句，就能反推出这套成绩系统的功能边界。典型的三张核心表是这样的结构：
CREATE TABLE student ( student_id INT PRIMARY KEY AUTO_INCREMENT, student_no VARCHAR(20) NOT NULL UNIQUE, name VARCHAR(50) NOT NULL, gender CHAR(2) DEFAULT '男', class_name VARCHAR(60) ); CREATE TABLE course ( course_id INT PRIMARY KEY AUTO_INCREMENT, course_name VARCHAR(100) NOT NULL, credit DECIMAL(3,1) DEFAULT 0 ); CREATE TABLE score ( id INT PRIMARY KEY AUTO_INCREMENT, student_id INT NOT NULL, course_id INT NOT NULL, score DECIMAL(5,2), UNIQUE KEY uk_student_course (student_id, course_id), CONSTRAINT fk_score_student FOREIGN KEY (student_id) REFERENCES student(student_id), CONSTRAINT fk_score_course FOREIGN KEY (course_id) REFERENCES course(course_id) );student_id的自增主键说明新增学生时不需要手动传学号，代码里插入语句应避开主键列。UNIQUE KEY uk_student_course说明系统不允许同一学生同一课程重复录入成绩，业务层在插入前要先查重，否则数据库直接抛Duplicate entry。两个外键约束意味着插入成绩前，学生和课程必须已经存在；删除学生时，成绩记录也要先清理。这三条约束组合起来，就引出了事务处理的必要性。
从表结构反向推断文档里写了哪些功能，比从源码开始读要快得多。表里只有 student、course、score 三张实体表，系统大概率就是单一管理员角色的成绩维护界面，不会有复杂的权限设计。如果文档里宣称有“班级管理”“教师角色”“课程安排”，但表结构里没有对应字段，基本可以判断文档是模板改的，功能并没有全部实现。
4. 源码落地：成绩增删改查、统计 SQL 和事务处理的三个关键点
数据库侧准备完毕，才轮到源码。学生成绩系统里的源码最值得研究的是 DAO 层怎么写、统计聚合放哪、多表操作如何保证一致性。这三点正好对应课设答辩和面试时最容易被打分的部分。
4.1 学生与成绩模块的 DAO 骨架与 PreparedStatement 选择
先写一个最简单的成绩录入 DAO，它同时演示了连接管理和参数化查询：
public class ScoreDao { private static final String URL = "jdbc:mysql://localhost:3306/score_db" + "?useSSL=false&serverTimezone=Asia/Shanghai"; private static final String USER = "root"; private static final String PASSWORD = "123456"; public int insertScore(Score score) throws SQLException { String sql = "INSERT INTO score(student_id, course_id, score) VALUES (?, ?, ?)"; try (Connection conn = DriverManager.getConnection(URL, USER, PASSWORD); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setInt(1, score.getStudentId()); ps.setInt(2, score.getCourseId()); ps.setBigDecimal(3, score.getScore()); return ps.executeUpdate(); } } }这个代码块里有三个关键动作。try-with-resources确保连接、语句对象在方法结束后自动关闭，避免连接泄漏；PreparedStatement用?占位，而不是字符串拼接 SQL，防止注入和语法错误；setBigDecimal保存成绩，避免float和double的浮点精度污染成绩字段。
多数课设代码会因为追求简单而改用Statement加字符串拼接。数据量小的时候看不出来问题，但一旦成绩记录包含英文单引号或特殊字符，拼接 SQL 直接报语法错误。更严重的是注入风险，虽然课设问答里不一定会被追问，但这个习惯一旦带到工作里，是会被评审盯上的硬伤。
4.2 成绩统计的 SQL 写法与 Java 调用分工
成绩系统的统计场景集中在两个方向：按课程算平均分、按学生算挂科数。这两个统计用 SQL 表达比用 Java 循环要高效得多。按课程统计的典型语句：
SELECT c.course_name, COUNT(sc.student_id) AS student_count, ROUND(AVG(sc.score), 2) AS avg_score, MAX(sc.score) AS max_score, MIN(sc.score) AS min_score FROM course c LEFT JOIN score sc ON sc.course_id = c.course_id GROUP BY c.course_id, c.course_name ORDER BY avg_score DESC;按学生统计挂科数量：
SELECT s.student_no, s.name, COUNT(sc.id) AS total_courses, SUM(CASE WHEN sc.score < 60 THEN 1 ELSE 0 END) AS fail_count FROM student s LEFT JOIN score sc ON sc.student_id = s.student_id GROUP BY s.student_id, s.student_no, s.name HAVING fail_count > 0 ORDER BY fail_count DESC;这两条 SQL 有四个值得留意的点。LEFT JOIN保留没有成绩的学生或课程，如果用INNER JOIN，没选课的学生会从统计结果里消失。ROUND把平均值格式化成两位小数，避免显示一长串小数位。GROUP BY必须把 select 中所有非聚合列包含进去，MySQL 5.7 默认开启了only_full_group_by，漏掉任何一列直接报错。HAVING在分组之后过滤，跟WHERE的执行时机不同，条件里出现的聚合别名只能在HAVING中使用。
习惯上，这类统计逻辑放 SQL 里做，Java 端只负责传参数和接收结果集。看到有人在 DAO 里查出全部成绩再用循环算平均分，要把代码拉回去重写，数据量到一千行以后，这种写法会明显变慢。
4.3 删除学生与登记成绩必须走事务
三张表之间有外键关系时，单条更新往往牵动多张表。删除一个学生的完整事务代码如下：
try (Connection conn = DriverManager.getConnection(URL, USER, PASSWORD)) { conn.setAutoCommit(false); try (PreparedStatement ps1 = conn.prepareStatement("DELETE FROM score WHERE student_id = ?"); PreparedStatement ps2 = conn.prepareStatement("DELETE FROM student WHERE student_id = ?")) { ps1.setInt(1, studentId); ps2.setInt(1, studentId); ps1.executeUpdate(); ps2.executeUpdate(); conn.commit(); } catch (SQLException e) { conn.rollback(); throw e; } }如果只删成绩而没删学生，会在成绩表里留下与任何学生都不对应的孤儿记录；反过来只删学生没删成绩，外键约束会直接拒绝执行。这两个错误的共同根源就是把多步操作放进了多个独立连接里，没有用事务包住。
登记成绩同样需要事务边界。常见的顺序是：先查学生是否存在，再查课程是否存在，最后插入成绩。三步如果分别用三个连接执行，中间任何一步失败，数据都处于不可预期的状态。把这三步放进一个事务，任何一个环节失败都用回滚收场，成绩表绝不会留下半条记录。事务这个概念在课设里经常被忽略，但它是区分“能跑”和“能可靠用”的分界线。
5. 避坑指南：成绩系统跑不起来的五个高频原因与排查
这一章整理五条真实出现率很高的踩坑记录，每条都按“现象 → 原因 → 解决”的路径写。遇到问题直接对照，能省下大部分查资料的功夫。
5.1 启动即报 ClassNotFoundException：驱动 JAR 没进构建路径
现象：运行到Class.forName(...)这一行，抛出java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver，程序终止。
原因：驱动 jar 没有进入运行时 classpath。很多老式 Eclipse 工程里，jar 虽然放在lib目录下，但项目构建路径没有引用它；IDEA 工程则常见是本地库依赖失效。
解决：先验证 jar 能不能被命令行加载：
# Windows 用分号分隔多个 classpath java -cp .;lib/mysql-connector-java-8.0.33.jar com.你的包名.MainControllerLinux 和 macOS 把分号换成冒号。命令行能启动，说明问题只出现在 IDE 运行配置。IDEA 在File -> Project Structure -> Libraries里添加驱动 jar，Eclipse 在项目属性的Build Path里Add External JARs。这个坑高频出现，是因为很多人只把 jar 放进了工程目录，没有告诉 IDE 去加载它。
5.2 控制台和页面中文全是问号：三层字符集没对齐
现象：界面或控制台显示???或乱码，数据库里存的汉字也是乱码。
原因：三个环节字符集不一致。数据库服务端默认字符集不是 utf8mb4，或者脚本建表时没有指定字符集；JDBC 连接串没加characterEncoding=utf8；JVM 的file.encoding不是 UTF-8。三层里任何一层不对齐，全链路都会出问题。
解决：先用命令查服务端：
mysql -u root -p -e "SHOW VARIABLES LIKE 'character_set_server';"不是 utf8mb4，就去配置文件设置默认字符集并重启服务。连接串统一加useUnicode=true&characterEncoding=utf8。Java 启动参数加上-Dfile.encoding=UTF-8。还有一个容易被忽略的点是源码文件本身保存编码，Eclipse 工程默认 GBK，IDEA 默认 UTF-8，源码编码不一致也会造成乱码。把源文件统一转为 UTF-8 再跑。字符集问题看起来像玄学，其实把三层对齐就收口了。
5.3 连接失败：Public Key Retrieval 与 serverTimezone 的组合拳
现象：启动时抛The server time zone value 'CST' is unrecognized，或者Public Key Retrieval is not allowed。
原因：MySQL 8.0 默认认证插件是caching_sha2_password，新驱动要求显式时区，而旧连接串没有准备处理公钥获取。
解决：在 JDBC 连接串里一次性补齐：
String url = "jdbc:mysql://localhost:3306/score_db" + "?useSSL=false&serverTimezone=Asia/Shanghai" + "&allowPublicKeyRetrieval=true";加完这两个参数，绝大多数报错会消失。还有一种后悔药式做法是改账号认证方式：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';这能把 root 账号降级回旧认证方式，本地课设勉强能用，但线上千万别学。我的习惯是优先改连接串，不碰数据库账号配置，避免把环境越改越乱。
5.4 表名或列名找不到：先跑一遍元数据查询再怀疑代码
现象：运行时报告Table 'score_db.score' doesn't exist，但打开数据库工具明明能看到表。
原因：连接串里的库名和脚本CREATE DATABASE用的库名不一致，这是最常见的一种。另一种是 Linux 下 MySQL 表名区分大小写，脚本建的是score，代码查询写的是Score，自然找不到。
解决：用一条命令把现状完整打出来：
mysql -u root -p -e "SHOW DATABASES; USE score_db; SHOW TABLES; DESC score;"先对比库名列表，再比对表名。列名问题用DESC score的输出逐一核对，通常比反复在 IDE 里刷新依赖快得多。注意USE score_db要换成实际库名，不要照抄。
5.5 文档画的功能和源码实际功能不同步
现象：文档里写支持教师录入成绩、管理员管理班级，但程序跑起来只有学生成绩查询一个页面。
原因：这类课设文档经常是模板批量生成，源码是另一个历史版本，两个东西本来就没有同步。
解决：以源码为准。先跑通现有功能，列出真实功能清单，再去文档里删除对不上的模块。如果答辩要求文档必须完整，就把源码真实实现补写回文档。强行按文档改代码通常不划算，尤其是对方文档描述的功能超出了源码架构的承载范围时。我接过好几套这类包，凡是文档与实现不一致的，花半天时间同步文档，比试图给代码增补功能快得多，也稳得多。
6. 给成绩系统加一个批量导入：CSV 成绩录入的事务化改造
6.1 用 JDBC 批处理一次写入整份成绩表
课设版本的成绩管理通常是逐条录入。答辩现场不少人就是拿着鼠标一条一条点，效率低不说，还很难体现工程意识。一个成本很低却很亮眼的改造是支持 CSV 批量导入成绩。
public int importScores(Path csvPath) throws Exception { String sql = "INSERT INTO score(student_id, course_id, score) VALUES (?, ?, ?)"; try (Connection conn = getConnection()) { conn.setAutoCommit(false); try (PreparedStatement ps = conn.prepareStatement(sql)) { int count = 0; for (String line : Files.readAllLines(csvPath)) { String[] c = line.split(","); ps.setInt(1, Integer.parseInt(c[0].trim())); ps.setInt(2, Integer.parseInt(c[1].trim())); ps.setBigDecimal(3, new BigDecimal(c[2].trim())); ps.addBatch(); count++; if (count % 500 == 0) { ps.executeBatch(); } } ps.executeBatch(); conn.commit(); return count; } catch (Exception e) { conn.rollback(); throw e; } } }这段代码的核心是addBatch和executeBatch。它们把多条插入语句攒成一批发给数据库，避免每行成绩都走一次网络往返。每 500 条刷一次，是为了防止大批量数据下驱动或服务端内存占用过高。setAutoCommit(false)配合rollback保证了整批导入的原子性：文件中间有一行格式不对，前面所有已添加的数据都会回滚，数据库里不会留下半截文件的内容。
6.2 验证导入流程的正确性
导入写完后，用一个数据量很小的 CSV 做验证，比如三行正常成绩加一行故意写错的学生编号。命令行跑一次：
java -cp .;lib/mysql-connector-java-8.0.33.jar com.你的包名.ImportMain test_ok.csv java -cp .;lib/mysql-connector-java-8.0.33.jar com.你的包名.ImportMain test_bad.csv正常文件导入后统计行数应是 CSV 行数；错误文件导入后表里行数应为 0，代表事务回滚生效。再用SELECT COUNT(*) FROM score确认两次操作后的最终结果。这个验证动作一分钟内做完，却能把事务逻辑彻底压实。我第一次给类似项目加批量导入时忘了分批刷，数据量到八百行时连接直接卡死；后来改成这种分批发加事务回滚的写法，同一份文件不到一秒刷完。这个改造在答辩时效果很好，因为它直接证明了你不只会写单条 CRUD，还知道批量写入的正确姿势。希望帮到你。
本文还有配套的精品资源，点击获取
