简介基于Java的Web学生成绩管理系统压缩包是一份完整的课程设计/毕业设计参考项目面向Java Web初学者及有成绩管理需求的教育机构开发者。项目采用ServletJSPJDBC技术栈遵循MVC分层思想覆盖学生信息维护、成绩录入修改、条件查询、成绩排序统计等典型业务场景可帮助快速上手Java Web开发。包内共36个文件包含10个Java源文件、9个JSP页面、10张运行截图与3张PNG示意图另附XML配置、MF清单和README说明压缩包仅2.94MB结构清晰便于按代码、页面、文档分类阅读。配套截图展示了数据表设计、系统首页、查询结果、成绩筛选与统计等核心页面便于对照代码理解前后端交互及JDBC持久化过程。目前已有33人学习浏览适合作为项目实战蓝本支持在Tomcat与MySQL环境下部署运行并能根据实际需求扩展统计分析、权限控制等功能。1. 基于Java的Web学生成绩管理系统.zip课程设计里的常青树能跑通才算数做 Java 课程设计或毕业设计的同学大概率绕不开「学生成绩管理系统」这个题目。网上流传的基于Java的Web学生成绩管理系统.zip就是这类项目最常见的存在形态一个压缩包里面有 Eclipse 或 IDEA 工程、SQL 脚本、部署说明解压后理论上能跑出一个带登录、带成绩录入和查询的 Web 应用。这类系统看起来不难但真正动手解压、导入、改配置、启动 Tomcat 之后翻车率远比你想象的高——版本不匹配、JDK 和 Tomcat 位数对不上、数据库脚本编码错乱每一步都可能卡住。这篇笔记的目标很直接把这个压缩包里的东西讲透从架构拆解到运行调试让你拿到手之后两小时内跑通并且知道怎么改成面试能讲的项目。2. 拆解系统的三层骨架角色权限、成绩流转、数据访问怎么协同2.1 用户模型管理员、教师、学生三条权限线几乎所有学生成绩管理系统的业务原点都是「谁能用、能用什么」。典型的角色分三种管理员管基础数据学生信息、课程信息、教师账号教师负责录入和修改成绩学生只能查询自己的成绩和排名。这个权限模型直接决定了数据库用户表的设计和前端页面的跳转逻辑。我见过很多课程设计在这块做得敷衍——一个 user 表存个 role 字段登录后靠 JSP 里的 if 判断跳转权限校验全靠页面超链接藏起来直接访问 URL 就能越权。如果你的系统后面要写进简历权限这块值得认真补一下。常见的做法是用 Filter 做一层登录拦截再根据 role 判断功能菜单的可见性数据库层面保持简单CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(30) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, role TINYINT NOT NULL COMMENT 1-管理员, 2-教师, 3-学生, real_name VARCHAR(30), status TINYINT DEFAULT 1 COMMENT 1-启用, 0-禁用 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;角色字段用 TINYINT 而不是字符串查询快业务里用常量类映射就行。实际在 Java 代码里我习惯登录时把 user 对象塞进 session再写一个 BaseServlet 或者拦截器统一判断public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; Object loginUser request.getSession().getAttribute(loginUser); if (loginUser null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } // 按角色控制访问范围教师不能访问学生管理模块 User user (User) loginUser; String uri request.getRequestURI(); if (uri.contains(/student/manage) user.getRole() ! 1) { response.sendError(403); return; } chain.doFilter(req, resp); }这里有个容易忽略的点角色判断不要只在前端隐藏按钮后端 Filter 必须拦截否则手工拼 URL 就能进管理页。很多老项目就是这么被攻破的面试时如果被问到 Web 安全能主动说出「后端权限校验」这个点会加分不少。2.2 成绩数据流从教师录入到学生查询的完整链路成绩是这个系统的核心实体它的流转链路是这样的教师登录后选择课程和班级看到一个学生名单列表逐个录入分数提交后写入成绩表学生登录后按学期、课程查询自己的成绩并看到总分、平均分和排名。管理员不直接改分只负责处理「补考」「缓考」这类状态字段。这条链路里最容易出问题的不是界面而是事务。教师录入一个班 40 人的成绩如果循环执行 40 条 insert中途第 25 条数据格式错了前面 24 条已经写进去了整个录入操作处于半完成状态学生端看到的成绩就是残缺的。所以成绩表的写入必须走事务要么全部成功要么全部回滚。public void saveScoreBatch(ListScoreInput list) { Connection conn null; try { conn dataSource.getConnection(); conn.setAutoCommit(false); String sql INSERT INTO t_score(student_id, course_id, term, score, remark) VALUES(?,?,?,?,?) ON DUPLICATE KEY UPDATE scoreVALUES(score), remarkVALUES(remark); PreparedStatement ps conn.prepareStatement(sql); for (ScoreInput input : list) { ps.setInt(1, input.getStudentId()); ps.setInt(2, input.getCourseId()); ps.setString(3, input.getTerm()); ps.setBigDecimal(4, input.getScore()); ps.setString(5, input.getRemark()); ps.addBatch(); } ps.executeBatch(); conn.commit(); } catch (SQLException e) { if (conn ! null) { try { conn.rollback(); } catch (SQLException ex) { ex.printStackTrace(); } } throw new RuntimeException(成绩批量保存失败, e); } finally { if (conn ! null) { try { conn.close(); } catch (SQLException e) { e.printStackTrace(); } } } }这段代码里有几个关键点。setAutoCommit(false)之后必须手动 commit任何一条 insert 失败都会走进 catch 块回滚。ON DUPLICATE KEY UPDATE是 MySQL 的幂等写法重复提交同一份成绩时直接更新而不是报主键冲突这正好对应「Java 怎么保证数据一致性」这类面试题里的常见答案——数据库层面做唯一约束应用层面做事务控制。成绩表上建议建唯一索引(student_id, course_id, term)这是防止重复录入最有效的手段比在 Java 代码里判断再 insert 靠谱得多。2.3 数据访问选型JDBC、DBUtils、MyBatis 改造成本对比老课程设计项目最常见的数据访问层写法是原生 JDBC 或者 Apache DBUtils新一些的用 MyBatis。解压 ZIP 后先看 lib 目录和代码里的 import基本就能判断属于哪一类。这三种选型的改造成本差别很大选型思路值得先说清楚。原生 JDBC 的优点是零依赖、部署简单缺点是样板代码多——每个 DAO 方法都要写获取连接、PreparedStatement、ResultSet 遍历、关闭资源这一套。DBUtils 是轻量封装用 QueryRunner 省掉了大部分样板代码还保留了 SQL 的完全控制力在课程设计这种规模下其实最顺手。MyBatis 则是把 SQL 和 Java 代码分离适合表结构复杂、查询条件多的场景但引入配置文件、Mapper 映射对新手来说排查问题路径更长。dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version5.1.49/version /dependency dependency groupIdcommons-dbutils/groupId artifactIdcommons-dbutils/artifactId version1.7/version /dependency如果拿到的是 MyBatis 版本最常见的坑是 Mapper XML 里resultType写错导致查询结果全是 null。排查技巧是把 MyBatis 的 SQL 日志打开在mybatis-config.xml里加setting namelogImpl valueSTDOUT_LOGGING/控制台就会打印实际执行的 SQL 和参数这时候你就能判断是 SQL 本身错了还是结果映射错了。3. 把 ZIP 变成能用的系统环境对齐、建库导表、启动调参3.1 版本对齐JDK、Tomcat、MySQL 三件套怎么配不出错课程设计项目的压缩包年代感往往很强很多是照着 JDK 8 Tomcat 8 MySQL 5.7 那一代写的。如果你机器上装的是 JDK 17 Tomcat 10 MySQL 8.0直接跑大概率起不来。版本不对齐的表现五花八门Tomcat 启动报UnsupportedClassVersionError说明 class 文件编译版本高于当前 JDK报ClassNotFoundException通常是 jar 包没拷贝到 WEB-INF/libMySQL 连不上则多半是驱动版本和数据库版本不兼容。我建议按这个组合去对齐踩坑最少组件推荐版本注意点JDK1.8不要装 JRE编译需要 javacTomcat8.5.x支持 Servlet 3.1兼容大多数老项目MySQL5.7和 mysql-connector-java 5.x 驱动匹配IDEEclipse 或 IDEA确保项目编码设为 UTF-8如果系统装了更高的版本别急着卸载。可以在 IDEA 里为这个项目单独指定 JDKProject Structure - SDKs - Add JDK把本机的 JDK 8 路径加进去再在Modules里把模块的 language level 设为 8。Tomcat 也可以在 IDEA 的 Run Configuration 里指定独立的 Tomcat 目录避免影响你机器上其他服务。3.2 导入数据库脚本五张核心表的结构与外键关系打开压缩包里的 SQL 文件一般叫db.sql或init.sql通常包含五张核心表用户表、学生表、教师表、课程表、成绩表。学生表和用户表在有些设计里是一张表通过 role 区分有些则是分开的成绩表通过 student_id 关联学生通过 course_id 关联课程。导入前先建库字符集直接指定 utf8mb4避免后续中文乱码mysql -u root -p -e CREATE DATABASE IF NOT EXISTS scoresystem DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p scoresystem db.sql注意 SQL 文件里如果有CREATE DATABASE那第二种写法里库名要一致否则会导到别的库去。导入成功后用SHOW TABLES;确认五张表都在再抽查几条数据看中文是否正常。SELECT c.course_name, ROUND(AVG(s.score), 2) AS avg_score, COUNT(*) AS total, SUM(CASE WHEN s.score 60 THEN 1 ELSE 0 END) AS fail_count FROM t_score s JOIN t_course c ON s.course_id c.id GROUP BY s.course_id;这条统计 SQL 是验证数据完整性的好工具 —— 如果 avg_score 是 null 或者 fail_count 明显不对说明成绩表里还有脏数据或者关联键有问题。3.3 三个必改配置连接串、端口、字符集把项目导入 IDE 后第一件事就是改配置文件。最常见的三个配置项集中在db.properties或jdbc.properties里jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/scoresystem?useUnicodetruecharacterEncodingUTF-8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456连接串里的characterEncodingUTF-8必须保留否则 JSP 页面传入的中文会乱码。serverTimezoneAsia/Shanghai是 MySQL 8.0 之前的驱动连 MySQL 5.7 时经常报时区错误的解药。useSSLfalse则是为了本地调试省去证书警告。密码改成你自己数据库的密码别照抄。Tomcat 端口在server.xml里改如果 8080 被占了把三个端口Connector port8080和后面两个 8009、8005一起改掉否则只改 HTTP 端口Tomcat 启动时仍可能因为其他端口占用而报错。字符集还有一个隐藏配置点IDEA 中项目文件的编码。如果File - Settings - File Encodings里 Global Encoding 和 Project Encoding 不一致JSP 文件里的中文在编译后就是乱码。统一设成 UTF-8并在conf/catalina.properties里加一行org.apache.catalina.connector.URIEncodingUTF-8老版本 Tomcat 可能需要8.5 默认已经是 UTF-8。4. 核心业务落地成绩录入、查询、统计的代码实现4.1 成绩录入接口分数校验与重复提交处理成绩录入是系统里写逻辑最密集的地方。分数不是随便填的0 到 100 之间是正常分数超过 100 或负数要直接拦截补考成绩、缓考标记要通过 remark 字段记录。我见过有项目把成绩设计成字符串存「优秀/良好/及格」统计的时候再转数字纯粹给自己找麻烦数字成绩加一个文本备注字段才是合理的结构。前端表单提交过来的参数后端必须二次校验不能信任前端public void addScore(HttpServletRequest req, HttpServletResponse resp) { String scoreStr req.getParameter(score); if (scoreStr null || scoreStr.trim().isEmpty()) { writeJson(resp, 400, 分数不能为空); return; } try { BigDecimal score new BigDecimal(scoreStr); if (score.compareTo(BigDecimal.ZERO) 0 || score.compareTo(new BigDecimal(100)) 0) { writeJson(resp, 400, 分数必须在0到100之间); return; } // 通过校验写入service层 scoreService.saveOne(req); } catch (NumberFormatException e) { writeJson(resp, 400, 分数格式不正确); } }BigDecimal而不是double是因为成绩平均分计算涉及精度double算出来 89.99999999 这种结果在页面显示时很难处理。compareTo比较大小而不是符号也是 BigDecimal 的规范用法直接score 100在 Java 里编译都过不了。这里校验逻辑写在 Controller真正落库在 Service 层层与层之间的参数传递用 DTO 对象不要用Map到处传否则项目一复杂就变成一坨。4.2 多条件查询按学号、课程、班级拼 SQL 的规范姿势成绩查询页一般是三到四个筛选条件学号、学生姓名、课程、班级。老项目里最常见的写法是String sql SELECT * FROM t_score WHERE 11; if (studentId ! null) { sql AND student_id studentId; } if (courseId ! null) { sql AND course_id courseId; }这个写法隐患很大。第一参数直接拼进 SQL存在注入风险学号传个1 OR 11就能把整个表拖出来第二WHERE 11虽然能让后续拼接省心但性能上对索引不友好。规范做法是用 PreparedStatement 的占位符动态拼 SQLStringBuilder sql new StringBuilder(SELECT s.student_no, s.student_name, c.course_name, sc.score, sc.term ); sql.append(FROM t_score sc ); sql.append(JOIN t_student s ON sc.student_id s.id ); sql.append(JOIN t_course c ON sc.course_id c.id ); sql.append(WHERE 11 ); ListObject params new ArrayList(); if (studentNo ! null !studentNo.isEmpty()) { sql.append(AND s.student_no LIKE ? ); params.add(% studentNo %); } if (courseId ! null) { sql.append(AND sc.course_id ? ); params.add(courseId); } if (term ! null !term.isEmpty()) { sql.append(AND sc.term ? ); params.add(term); }LIKE 查询的%要拼在参数里而不是拼在 SQL 里这是参数化查询的基本规矩。另外如果t_score表的数据量超过几万条按课程和学期查询必须走索引否则每次查询都是全表扫描。建议在成绩表上加复合索引(course_id, term)把 WHERE 条件里最常用的两个字段放前面。Java 面试八股文里常说的「联合索引最左前缀原则」在这个系统里就能实际感受到——查询条件里有 course_id 但没有 term 时索引只能用到第一段。4.3 统计排名平均分、及格率、分数段分布一条 SQL 算完课程设计的验收环节老师通常会在意统计功能——班级平均分、及格率、优秀率、分数段分布。这些指标用一条 SQL 就可以全算出来不需要在 Java 里循环计算SELECT c.course_name, COUNT(*) AS total_students, ROUND(AVG(sc.score), 2) AS avg_score, ROUND(SUM(CASE WHEN sc.score 60 THEN 1 ELSE 0 END) / COUNT(*) * 100, 1) AS pass_rate, ROUND(SUM(CASE WHEN sc.score 90 THEN 1 ELSE 0 END) / COUNT(*) * 100, 1) AS excellent_rate, SUM(CASE WHEN sc.score 60 THEN 1 ELSE 0 END) AS fail_count FROM t_score sc JOIN t_course c ON sc.course_id c.id GROUP BY sc.course_id;排名功能则是用窗口函数 RANK 或 DENSE_RANKMySQL 5.7 不支持窗口函数5.8MySQL 8.0 之前的版本号不存在这里容易记混MySQL 8.0 才支持。如果你的数据库是 5.7排名就得用变量实现SELECT student_id, course_id, score, rank : IF(prev_course course_id, rank 1, 1) AS rank, prev_course : course_id FROM t_score ORDER BY course_id, score DESC;这个写法的坑在于rank和prev_course必须按 course_id 排序后再计算否则排名会乱掉。而且变量的赋值和查询字段出现在同一条语句里不同版本 MySQL 的执行顺序有细微差别建议在 Java 端调好排序后验证一次结果再交付。如果系统跑在 MySQL 8.0 上直接用ROW_NUMBER() OVER (PARTITION BY course_id ORDER BY score DESC)更直观也不用担心变量作用范围的问题。5. 老项目翻车实录ZIP 里跑不起来的原因与解法5.1 Tomcat 启动报ClassNotFoundException但 jar 包明明在 WEB-INF/lib 里现象启动 Tomcat 时抛出java.lang.ClassNotFoundException: com.mysql.jdbc.Driver打开 WEB-INF/lib 目录明明能看到 mysql-connector-java.jar。原因这个 jar 没有被编译进 classpath。在 Eclipse 老项目里jar 需要在Deployment Assembly里配置IDEA 里则是Project Structure - Artifacts - WEB-INF/lib里确认 jar 是否被打包进去。很多人的 jar 只是放在文件夹里IDE 没有把它关联到编译输出。解决IDEA 中在 WEB-INF 下新建 lib 目录把 jar 拖进去右键 Add as Library然后在 Artifacts 页面确认 Output Layout 里 lib 目录存在且 jar 在里面。重新 Build - Rebuild 一次再启动。这个坑在课程设计验收前最容易出现因为换了一台电脑重新导入项目后lib 关联经常丢。5.2 数据库连不上密码在配置文件里改了三处还是报 Access denied现象Access denied for user rootlocalhost (using password: YES)配置文件里密码确认没问题。原因同时存在多个配置文件。老项目可能在src下有db.properties在WEB-INF/classes下有另一份还有一份在config目录下。代码加载配置的顺序是 classpath 优先你改的那一份可能根本没被加载。解决先看代码里配置文件加载的方式。如果是Properties.load(Thread.currentThread().getContextClassLoader().getResourceAsStream(db.properties))那就必须改src/main/resources下的那一份。用 IDEA 打开项目后按 CtrlShiftF 全局搜jdbc.password把所有出现的位置都找出来确认实际上被读取的是哪一个。还有一种情况是 MySQL 8.0 的密码加密方式变了驱动 5.x 连不上 8.0解决办法是换成mysql-connector-java8.x 驱动并把 URL 里的 serverTimezone 参数配上。5.3 页面中文乱码浏览器里满屏问号现象登录页面标题是中文用 Tomcat 启动后全是??部分请求参数里的中文也变成了???。原因三层不一致——JSP 文件保存时的编码、Tomcat 解析请求的编码、数据库连接的编码。老项目压缩包里的 JSP 很可能是 GBK 编码保存的而 Tomcat 默认 UTF-8数据库表是 latin1 还是 utf8 也要确认。解决先确认 JSP 文件头部有% page contentTypetext/html; charsetUTF-8 pageEncodingUTF-8%然后看文件本身编码——IDEA 右下角能看到文件编码如果是 GBK 就转成 UTF-8 并选择「转换而不是复制」。数据库连接 URL 里加characterEncodingUTF-8MySQL 建表时统一 utf8mb4。修改完成后清浏览器缓存、重启 Tomcat这一串搞完乱码基本能解决。注意 Filter 里如果写了request.setCharacterEncoding(UTF-8)必须在第一次 getParameter 之前调用放在 doFilter 的最前面。5.4 端口被占启动日志里 Address already in use现象Tomcat 启动到一半报java.net.BindException: Address already in use: JVM_Bind:8080然后整个启动失败。原因本机已经有另一个 Tomcat 实例或者别的进程占了 8080。常见的是上一个调试项目没被 IDEA 停掉后台还有一个 java 进程活着。解决先netstat -ano | findstr 8080看是哪个进程占用的Windows 下直接taskkill /PID xxx /F。如果确定是本机已有的正式 Tomcat 占用的端口修改当前项目的配置改用 8081 —— 在 IDEA 的 Run Configuration 里改 HTTP port 为 8081JMX port 也同步改掉避免只改一个端口出现新的冲突。这是个容易被忽略的点Tomcat 要占用三个端口8080 是 HTTP8009 是 AJP8005 是 shutdownIDEA 里 Run Configuration 只让你改 HTTP port但server.xml里三个端口都写死了修改时要一起动。5.5 数据存进去了但从页面看到的时间、小数位不对现象成绩表里存的是89.5页面显示89.50或者89.5跟设计文档对不上日期字段存进去再取出来时间偏移了 8 小时。原因小数位是BigDecimal的 scale 设置问题数据库字段 DECIMAL(5,2) 会强制两位小数但 Java 端setBigDecimal传入的是89.5JDBC 驱动按数据库精度自动补零或截断。时间偏移 8 小时是 MySQL 驱动连接 URL 没加serverTimezone默认按服务器本地时区解析而驱动本身的时区是 UTC。解决Java 端统一用BigDecimal.setScale(2, RoundingMode.HALF_UP)再入库避免数据库隐式转换。时间字段在实体类里用java.time.LocalDateTimeJDBC 4.2 之后原生支持不要用java.util.Date去接 LocalDateTime 的字段。连接 URL 里 serverTimezoneAsia/Shanghai 加上后重启再插入一条数据验证时间偏移问题是否消失。6. 从能跑到能交打包部署与验收自查清单课程设计系统验收有两种形式一种是答辩现场用 IDE 跑起来演示另一种是要求部署到服务器上通过浏览器访问。后者更考验工程的完整度因为现场拷贝项目、切换运行环境最容易出幺蛾子。我习惯的做法是打 WAR 包而不是让人现场开 IDEA 跑——WAR 包丢到 Tomcat 的 webapps 目录启动后自动解压部署干净利落。出 WAR 包的方式是IDEA 里File - Project Structure - Artifacts - Add - Web Application: Archive - Empty把项目的compile output和WEB-INF/lib下的 jar 都拖进WEB-INF/classes和WEB-INF/lib然后Build - Build Artifacts。打包完成后把 WAR 放到本机 Tomcat 的webapps目录启动 Tomcat浏览器访问http://localhost:8080/项目名/能出登录页就说明部署链路通了。如果项目名带中文访问路径里要 URL 编码或者打包前把 Artifact 名字改成英文。最后做一轮验收自查按这个顺序检查完答辩基本不会被问倒管理员能否创建教师账号、录入学生信息和课程信息异常数据重复学号能否拦截教师登录后能否看到自己负责的课程录入成绩后刷新页面数据还在重复提交同一份成绩是更新而不是多了一条学生登录后能否看到自己的全部成绩排名是否和手动算的一致退出登录后直接访问受保护页面 URL是否正确跳转回登录页把数据库密码改错一次系统是否给出友好错误提示而不是堆栈信息我自己的习惯是把第 5 条当成必测项。很多项目在正常路径下表现完美一遇到异常输入就崩溃答辩时老师最喜欢在这种地方试探。把异常处理做成「页面提示 日志记录」而不是一行红字堆栈整个系统的完成度就上了一个台阶。每次拿到基于Java的Web学生成绩管理系统.zip这类项目我都先按这套流程跑通再改代码省下的时间远比折腾环境多希望帮到你。本文还有配套的精品资源点击获取