简介一份基于JavaWeb与MySQL的学生成绩管理系统课程设计项目包面向计算机、通信、人工智能、自动化等专业的在校生与从业者适用于期末课程设计、大作业和毕业设计场景既能学习Servlet、JSP、Repository数据访问层与MySQL的整合开发也可在此基础上扩展班级、课程、教师、学生、成绩等管理功能。压缩包共101个文件大小11.57MB主要包含32个Java源码、19个JSP页面、3个JAR依赖、2个XML配置、SQL数据库脚本及文档配合class文件和图片资源整体分层清晰便于对照理解页面、业务控制与数据持久化实现。该项目为个人毕设据描述答辩评审分95分代码已经调试测试并附有数据库文件可快速导入MySQL运行对JavaWeb入门和课设参考有较高价值。目前已有1074人学习下载适合需要完成类似成绩管理系统的同学参考复用。1. 为什么学生成绩管理系统是 JavaWeb 课设里最值得认真做的题目如果你翻过历年的 JavaWeb 课设题目清单“学生成绩管理系统”出现的频率一定排在前三。原因不复杂它把 Web 项目里最容易考的几个点全占了——登录会话、多表关联查询、增删改查、统计报表。更重要的是这类项目的数据模型足够经典学生表 - 课程表 - 成绩表三张表之间的关系直接对应你在面试或工作中会遇到的学生选课、订单明细、用户角色这类真实场景。拿到“源码sql数据库”的压缩包最常见的尴尬是导入数据库时报错、Tomcat 启动即 404、页面中文乱码最后项目跑不起来。这篇文会把一套基于 JavaWeb MySQL 的学生成绩管理系统从数据模型、后端分层、前端页面到部署排错完整拆开讲。新手可以照着把整个项目搭通有经验的人也能从表结构设计、SQL 统计写法、连接池参数配置这些细节里获得一些可复用的东西。2. 学生成绩管理系统的数据模型MySQL 表结构设计与索引规划2.1 按三范式拆表先想清楚业务边界我见过的课设项目里八成以上把学生、课程、成绩塞进一张大表里这样做在“录入成绩”这个动作上确实省事但要统计“某门课的平均分”“某个学生的挂科门数”时查询会变得极其别扭而且会产生大量冗余数据。标准做法是拆成四张表student学生表学号主键、姓名、性别、班级、入学年份course课程表课程号主键、课程名、学分、授课教师score成绩表学号、课程号、成绩、考试学期联合主键是(学号, 课程号, 学期)user用户表登录账号、密码、角色管理员/教师/学生用户表单独拆出来是有意义的。很多课设把登录账号直接挂在学生表里但如果想让多个教师登录或者管理员要管理所有账号这样做就不好扩展了。把登录凭证和业务数据分离这是工作里最重要的一个习惯。2.1.1 score 表为什么不用自增主键建议score表用联合主键PRIMARY KEY (stu_id, course_id, semester)。这样同一个学生同一个学期同一门课只会有一条成绩记录数据库层面就保证了数据不重复。如果你用了自增主键每次插入成绩前都要先查一次是否已存在既多写一条 SQL又有并发下重复插入的隐患。2.2 建表 SQL字符集、引擎、外键一次到位以下 SQL 是这套系统最常用的 MySQL 5.7 / 8.0 建表脚本注意字符集用utf8mb4排序规则用utf8mb4_general_ci。很多导入 sql 后中文乱码的项目十有八九是建表时用了latin1或者系统默认字符集。CREATE DATABASE IF NOT EXISTS grade_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE grade_system; CREATE TABLE student ( stu_id VARCHAR(20) NOT NULL COMMENT 学号, stu_name VARCHAR(50) NOT NULL COMMENT 姓名, gender CHAR(1) DEFAULT M COMMENT 性别 M/F, class_name VARCHAR(50) DEFAULT NULL COMMENT 班级, enroll_year INT DEFAULT NULL COMMENT 入学年份, PRIMARY KEY (stu_id), KEY idx_class (class_name) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生表; CREATE TABLE course ( course_id VARCHAR(20) NOT NULL COMMENT 课程号, course_name VARCHAR(100) NOT NULL COMMENT 课程名, credit DECIMAL(3,1) DEFAULT 2.0 COMMENT 学分, teacher VARCHAR(50) DEFAULT NULL COMMENT 授课教师, PRIMARY KEY (course_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT课程表; CREATE TABLE score ( stu_id VARCHAR(20) NOT NULL COMMENT 学号, course_id VARCHAR(20) NOT NULL COMMENT 课程号, semester VARCHAR(20) NOT NULL COMMENT 学期如 2024-2025-1, score DECIMAL(5,1) DEFAULT NULL COMMENT 成绩0-100, PRIMARY KEY (stu_id, course_id, semester), KEY idx_course (course_id), CONSTRAINT fk_score_student FOREIGN KEY (stu_id) REFERENCES student (stu_id), CONSTRAINT fk_score_course FOREIGN KEY (course_id) REFERENCES course (course_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT成绩表; CREATE TABLE sys_user ( id INT NOT NULL AUTO_INCREMENT, username VARCHAR(50) NOT NULL, password VARCHAR(64) NOT NULL COMMENT 建议存 MD5/SHA-256 摘要, role VARCHAR(10) DEFAULT student COMMENT admin/teacher/student, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT登录用户表;这段 SQL 里有三个细节值得注意。第一个是score表的外键约束它保证录入成绩时学号和课程号必须已在对应表里存在这是数据完整性的底线不要为了省事省略。第二个是DECIMAL类型成绩和学分都用定点数而非浮点数避免浮点误差这一点在期末算平均分时尤其重要。第三个是semester字段用的字符串格式如2024-2025-1比单纯的年份更能表达“学年学期”的业务含义。2.3 MySQL 索引规划别过度建索引也别漏了关键索引成绩管理系统的查询场景集中在三类按学生查成绩单、按课程查成绩表、按班级查汇总。对应的索引设计应该是student表主键索引就是stu_idclass_name加普通索引因为经常按班级筛选score表联合主键(stu_id, course_id, semester)天然支持“查某学生的全部成绩”idx_course支持“查某门课的所有学生”sys_user表username加唯一索引登录查询走索引而非全表扫描用 MySQL 的EXPLAIN能快速验证索引是否生效。拿“查某个学生所有成绩”这个高频查询来说执行计划里type应该是ref或eq_refkey显示 PRIMARY说明索引被正确使用。如果出现typeALL说明全表扫描需要检查 SQL 条件是否用了函数包裹索引列或者表是否没建索引。3. JavaWeb 后端实现Servlet Service DAO 三层架构与 JDBC 连接池配置3.1 三层架构到底怎么分每层干什么这套系统最常见的后端组织方式是传统 JavaWeb 三层Servlet层负责接收请求、解析参数、跳转页面Service层处理业务逻辑比如“录入成绩前先判断该学生是否存在”DAO层只做最纯粹的数据库交互。这样的好处是每一层都能被单独测试后面想换数据库或者加缓存只改 DAO 层就行。一个常见的失败案例是把 SQL 直接写在 Servlet 里两三百行代码塞在一个方法里项目能跑但每加一个功能就要动原有代码。如果你是从课设出发想往后走得更远三层架构是必须养成的习惯。3.2 数据库连接从 DriverManager 到 Druid 连接池许多课设源码会用最原始的DriverManager.getConnection()每次操作数据库都重新创建连接。在开发和课设环境里这没什么问题但这正是你现在应该花十分钟替换掉的坏味道。更好的方案是用 Druid 连接池它在你每次请求需要数据库连接时从池子里复用已有连接同时自带监控页面能直观看到每一条 SQL 的执行耗时。先建一个db.properties配置文件jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/grade_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.passwordyourpassword jdbc.initialSize5 jdbc.maxActive20 jdbc.maxWait10000再写一个工具类package com.grade.util; import com.alibaba.druid.pool.DruidDataSourceFactory; import javax.sql.DataSource; import java.io.InputStream; import java.util.Properties; public class DBUtil { private static DataSource dataSource; static { try (InputStream in DBUtil.class.getClassLoader() .getResourceAsStream(db.properties)) { Properties props new Properties(); props.load(in); // Druid 从配置文件加载连接池参数 dataSource DruidDataSourceFactory.createDataSource(props); } catch (Exception e) { throw new ExceptionInInitializerError(数据库连接池初始化失败); } } public static Connection getConnection() throws Exception { // 从连接池获取连接比 DriverManager 复用已有连接性能更高 return dataSource.getConnection(); } }这段代码的关键在DruidDataSourceFactory.createDataSource(props)它会读取配置文件里jdbc.*开头的属性自动创建连接池。参数initialSize5表示启动时预创建 5 个连接maxActive20是最大连接数maxWait10000是拿不到连接时的最长等待毫秒数。对于课设的并发量5 到 20 足够如果部署在低配服务器上maxActive调到 10 就够了太大反而浪费内存。serverTimezoneAsia/Shanghai是必须加的否则 MySQL 8.0 会报The server time zone value的连接错误这是历年课设最常遇到的问题之一。3.3 登录功能PreparedStatement 防注入与 Session 会话控制登录功能是每个 JavaWeb 项目的门面。安全上最低的要求是用PreparedStatement而非字符串拼接 SQL密码存储用摘要算法而非明文。package com.grade.dao; import com.grade.entity.SysUser; import com.grade.util.DBUtil; import java.sql.Connection; import java.sql.PreparedStatement; import java.sql.ResultSet; public class UserDAO { public SysUser findByUsernameAndPassword(String username, String password) throws Exception { // 使用 PreparedStatement参数以占位符方式传入避免 SQL 注入 String sql SELECT id, username, role FROM sys_user WHERE username ? AND password ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, username); ps.setString(2, password); try (ResultSet rs ps.executeQuery()) { if (rs.next()) { SysUser user new SysUser(); user.setId(rs.getInt(id)); user.setUsername(rs.getString(username)); user.setRole(rs.getString(role)); return user; } return null; } } } }try-with-resources语法在这里是必须的它保证Connection、PreparedStatement、ResultSet无论是否异常都会被自动关闭不会出现连接泄漏。注意登录成功后只把username和role放进 Session不要放密码这是基本的安全意识。对应地写一个LoginServlet和登录过滤器package com.grade.filter; import javax.servlet.*; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.http.HttpSession; import java.io.IOException; public class AuthFilter implements Filter { Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; HttpServletResponse resp (HttpServletResponse) response; HttpSession session req.getSession(false); // 白名单页面直接放行其余请求必须登录 String uri req.getRequestURI(); if (uri.endsWith(login.jsp) || uri.endsWith(LoginServlet) || uri.endsWith(.css) || uri.endsWith(.js) || uri.endsWith(.png)) { chain.doFilter(request, response); return; } if (session null || session.getAttribute(username) null) { resp.sendRedirect(req.getContextPath() /login.jsp); return; } chain.doFilter(request, response); } }过滤器里的白名单数组值得根据你的项目实际调整。.css、.js、图片必须放行否则页面加载会异常。登录接口本身也必须放行不然会出现“永远无法登录”的死循环。chain.doFilter()代表放行sendRedirect是重定向到登录页注意这里要加req.getContextPath()否则在带应用路径的部署环境下会跳错位置。3.4 成绩管理的核心 DAO增删改查与多表关联成绩模块的 DAO 是整套系统的核心典型代码是public ListScoreVO findScoreByStudent(String stuId) throws Exception { String sql SELECT s.stu_name, c.course_name, sc.score, sc.semester FROM score sc JOIN student s ON sc.stu_id s.stu_id JOIN course c ON sc.course_id c.course_id WHERE sc.stu_id ? ORDER BY sc.semester DESC, c.course_id ASC; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, stuId); try (ResultSet rs ps.executeQuery()) { ListScoreVO list new ArrayList(); while (rs.next()) { ScoreVO vo new ScoreVO(); vo.setStuName(rs.getString(stu_name)); vo.setCourseName(rs.getString(course_name)); vo.setScore(rs.getDouble(score)); vo.setSemester(rs.getString(semester)); list.add(vo); } return list; } } }这条 SQL 连接了三张表把score表里的外键通过 JOIN 替换成可读的学生姓名和课程名。ORDER BY sc.semester DESC让最新的学期排在最前这比在 Java 里做完查询再手动排序效率高得多。如果你发现这里查询慢优先看score表的idx_course索引是否还在——很多人导入 sql 文件时把索引一起丢了表能查询但扫的是全表。4. 前端页面与统计报表JSP EL JSTL 渲染成绩列表SQL 完成分组统计4.1 JSP 页面为什么还在用课设的合理选择与替代方案如果你现在做的是课设前端用 JSP EL JSTL 仍然是最稳妥的组合因为 Tomcat 天然支持不需要额外配置前后端分离的跨域和打包流程。JSP 的作用是作为视图层把 Service 层传来的数据渲染成 HTML尽量不在 JSP 里写 Java 代码片段而是用 EL 表达式${}和 JSTL 标签库来输出数据。一个典型的学生成绩列表页长这样% page contentTypetext/html;charsetUTF-8 languagejava % % taglib prefixc urihttp://java.sun.com/jsp/jstl/core % html head title我的成绩/title /head body h2学生${sessionScope.username} 的成绩单/h2 table border1 tr th学期/th th课程号/th th课程名/th th学分/th th成绩/th th绩点/th /tr c:forEach items${scoreList} vars tr td${s.semester}/td td${s.courseId}/td td${s.courseName}/td td${s.credit}/td td${s.score}/td td %-- 成绩 90 以上为 4.060 分为 1.0其余线性映射 --% c:choose c:when test${s.score 90}4.0/c:when c:when test${s.score 80}3.0/c:when c:when test${s.score 70}2.0/c:when c:when test${s.score 60}1.0/c:when c:otherwise0.0/c:otherwise /c:choose /td /tr /c:forEach /table /body /html这里的scoreList是 Servlet 在request.setAttribute(scoreList, list)时放入的。JSTL 的forEach遍历集合choose做条件判断输出绩点这样避免在 JSP 里写 Java 代码块% %页面更清晰且更容易维护。4.2 MySQL 分组统计平均分、及格率、排名一次查出来统计报表是成绩管理系统里最能体现 SQL 功力的部分。最常见的需求是按课程统计平均分、最高分、最低分、及格人数和及格率。一条 SQL 就能完成任务SELECT c.course_id, c.course_name, COUNT(*) AS total_stu, ROUND(AVG(sc.score), 2) AS avg_score, MAX(sc.score) AS max_score, MIN(sc.score) AS min_score, SUM(CASE WHEN sc.score 60 THEN 1 ELSE 0 END) AS pass_cnt, ROUND(SUM(CASE WHEN sc.score 60 THEN 1 ELSE 0 END) / COUNT(*) * 100, 2) AS pass_rate FROM score sc JOIN course c ON sc.course_id c.course_id GROUP BY c.course_id, c.course_name ORDER BY avg_score DESC;几个要点说明ROUND(..., 2)保留两位小数AVG计算平均分。这里用CASE WHEN做条件计数成功算出及格人数从而得到及格率比在 Java 代码里二次遍历要简单得多GROUP BY后面两个字段都写是因为SELECT里出现了c.course_name在ONLY_FULL_GROUP_BY模式开启时MySQL 5.7 默认开启不写全会直接报 SQL 错误ORDER BY avg_score DESC对应热搜词里的“MySQL 排序”直接在数据库层完成排序前端拿到的是已经排好序的结果如果你还需要给每个学生按成绩排名典型的实现是窗口函数ROW_NUMBER()MySQL 8.0 直接支持SELECT stu_id, course_id, score, ROW_NUMBER() OVER (PARTITION BY course_id ORDER BY score DESC) AS rank_no FROM score;MySQL 5.7 不支持窗口函数你可以用rank变量模拟但既然是新项目直接用 8.0 更省事。PARTITION BY course_id的含义是“每个课程的内部独立排名”ORDER BY score DESC决定排名依据。这是一个非常有价值的技巧从课设到真实报表开发都会用到。4.3 成绩录入页面的表单校验与编辑回填录入成绩时最容易出错的操作是“覆盖已有成绩”。如果前端无条件提交一个学期同一门课的成绩会被重复插入触发联合主键冲突报错。标准做法是录入前先查询该学号该课程该学期的记录是否存在存在则走 UPDATE不存在走 INSERT。这对应 MySQL 里常见的“更新子查询”场景用一条 SQL 判断即可INSERT INTO score (stu_id, course_id, semester, score) VALUES (?, ?, ?, ?) ON DUPLICATE KEY UPDATE score VALUES(score);这条 SQL 利用score表的联合主键做唯一性判断如果记录已存在则更新成绩不存在则插入省去了先查再写的两步操作。这是 MySQL 特有的语法也是处理课设里“成绩改错要重录”的最佳解法。5. 部署排错与数据验证MySQL sql 导入、Tomcat 部署、中文乱码与索引验证5.1 把 sql 文件干净地导入 MySQL避坑 Navicat 与命令行差异拿到项目的 sql 文件第一步不是双击导入而是先看文件里的CREATE DATABASE和USE语句。如果你的 SQL 文件里没有建库语句需要先手动建库再导入如果有直接命令行导入最干净mysql -u root -p grade_system.sql使用 Navicat 等图形工具时选择“运行 SQL 文件”之前要注意不要在非目标库的窗口里执行否则表会建到默认库里去。导入成功后建议立即执行下面这句验证表是否齐全SHOW TABLES;如果发现少表通常是 sql 文件里 FOREIGN KEY 约束导致建表顺序问题。解决办法是在文件最末尾检查外键是否用ALTER TABLE单独添加或者导入时先临时关闭外键检查文件最前面加SET FOREIGN_KEY_CHECKS 0;最后恢复为 1。5.2 Tomcat 部署后的四个高频问题定位JavaWeb 项目部署到 Tomcat 后常见的报错集中在四个点按出现频率排序第一404 错误。访问http://localhost:8080/grade_system/返回 404先看webapps目录下是否真的存在grade_system这个应用文件夹再看WEB-INF/web.xml里欢迎页配置是否正确。课设项目最常见的 404 原因是把 war 包解压错了位置。第二ClassNotFoundException / ClassNotFound 异常。这通常是 JDBC 驱动 jar 没放对位置。Tomcat 的类加载机制决定了放在项目WEB-INF/lib下的 jar 优先级最高不要只放到全局lib目录。MySQL 5.7 用mysql-connector-java-5.1.49.jarMySQL 8.0 用mysql-connector-j-8.0.x.jar版本必须和数据库匹配。第三中文乱码。三个地方要同时设置数据库连接 URL 里必须有characterEncodingutf8JSP 页面顶部必须有% page contentTypetext/html;charsetUTF-8 %Tomcat 的server.xml里连接器需要设URIEncodingUTF-8。这三个有一处不一致就会出现页面乱码或插入数据库乱码。第四Communications link failure 连接失败。优先检查 MySQL 服务是否启动、db.properties里的用户名和密码是否正确、serverTimezone是否配置。还有一个容易漏的点MySQL 8.0 默认认证插件是caching_sha2_password老版本的驱动连接会报错需要换成 8.0 版驱动或者在 MySQL 里改用户认证插件。5.3 用 EXPLAIN 验证成绩查询是否走索引部署完成、功能跑通之后建议做一次查询性能验证。直接拿最高频的查询语句套上EXPLAINEXPLAIN SELECT sc.stu_id, c.course_name, sc.score FROM score sc JOIN course c ON sc.course_id c.course_id WHERE sc.stu_id 20240001;执行结果里关注这几列type如果是ALL说明全表扫描数据量大了会明显变慢如果是ref或eq_ref说明索引生效rows是预估扫描行数越小越好Extra如果出现Using where; Using index说明覆盖索引生效性能最佳。另一个更实用的优化点是给sys_user表加一条测试数据验证登录接口的响应时间。在 MySQL Workbench 里开启查询分析执行同样的登录 SQL正常情况下应小于 10ms如果耗时异常要么是索引没建要么是表数据膨胀后统计信息过期。5.4 用 Navicat / MySQL Workbench 画 ER 图检查表关系如果你拿到手的项目里只有 sql 文件没有设计文档最快的理解方式是反向画出 ER 图。MySQL Workbench 和 Navicat 都支持“逆向数据库到模型”功能导入后能看到四张表之间的连线。这一步的作用是检查外键关系是否完整比如score表和student表、course表之间是否都建立了连线。如果发现缺外键说明建表 SQL 不够严谨建议手动补上。ER 图这个数据库可视化的习惯越早养成越好因为它能帮你一眼定位到冗余表和缺失关系这是纯靠读代码很难快速做到的。本文还有配套的精品资源点击获取