简介：一套基于JSP与Java技术开发的体育成绩管理系统源码及配套资料，面向高校学生、体育教师及赛事组织者，解决学校体育比赛中成绩录入、统计与秩序册生成等环节的信息化问题。资源共98个文件，压缩包大小约4.96MB，涵盖JSP页面、Java类、class文件、jar依赖库、SQL数据库脚本、GIF功能演示图和EXE操作录屏等类型，可对照源码、数据库脚本与页面效果直观学习。系统包含修改个人密码、班级信息管理、比赛项目管理、生成秩序册、报名信息管理和成绩统计等完整模块，逻辑清晰，适合作为JSP课程设计或毕业设计的参考项目。目前已有468人学习，借助操作录像与项目目录结构，能够快速完成环境部署，并理解从数据库表设计到JSP页面交互的开发流程，便于后续二次开发或功能扩展。 做Java Web课程设计或者毕业设计的朋友，十有八九都遇到过这类选题：JSP + JAVA实现的体育成绩管理系统。说它难吧，业务逻辑其实很直白；说它简单吧，又涉及JSP页面、Servlet控制层、数据库设计、Tomcat部署这一整套链路，初学的时候每一个环节都能卡住半天。我这几年帮人看过不少这个题目的代码，网上的版本要么是纯JSP脚本片段堆出来的“糖水代码”，要么就是没必要的框架套了一层又一层，真正能直接跑起来并且逻辑清楚的反而少见。
这篇文章就是按照我自己做这个项目的思路来写的。先聊技术选型为什么用这个老组合，再拆数据库和成绩计算规则，然后讲实现过程中的核心细节和踩过的坑，最后整理一份高频问题排查表，顺便说说答辩或者面试时容易被问到哪些点。如果你正在做Java Web课设、毕设，或者刚学完Servlet + JSP想找个完整练手项目，这篇应该对你有用。
1. 项目整体设计与技术选型
1.1 为什么JSP + Servlet的老组合在课程设计里依然能打
现在出去面试，聊的几乎都是Spring Boot、Spring Cloud，新项目也基本没人直接拿JSP写了。但在课程设计和毕业设计这个场景里，JSP + Servlet依然被大量使用，原因很现实：教材是这么教的，考核是这么考的。JSP本质上是在HTML里嵌入Java代码的动态网页技术，Servlet负责处理请求和业务逻辑，这种“JSP做展示、Servlet做控制”的分工，恰恰是MVC模式最朴素的一种体现。
如果你纠结要不要上框架，我的建议是，题目没明确要求的话，老老实实用Servlet + JSP + JDBC。一是架构简单，代码量可控，适合几百行就能讲清楚的系统；二是答辩的时候逻辑容易讲明白，老师问“一个请求是怎么从浏览器走到数据库再返回页面的”，你一条链路串下来就行；三是有利于加深对HTTP、Session、JDBC这些基础知识的理解，Spring Boot帮封装掉的细节太多，面试时八股文一问反而容易露馅。
这次用MySQL做数据库。选择MySQL没太多玄学，就是课设环境普遍装它，网上资料多，遇到问题好搜。如果学校机房装了SQL Server或者别的，换驱动和连接串就行，后端SQL写法基本兼容。
1.2 管理员、教师、学生三类角色的功能模块拆解
体育成绩管理系统最核心的一点是角色权限要清楚，不然成绩数据会被改得乱七八糟。常见的角色划分和功能边界如下：
- 管理员：管理教师账号、学生账号、课程信息，查看全系统数据，处理成绩发布状态。
- 教师（体育老师）：录入学生成绩，支持按班级批量录入；查看、修改、导出所教班级的成绩单。
- 学生：查看自己各学期的体育课程成绩和项目明细，维护个人信息，打印成绩单。
功能边界确定之后，控制层就能顺势拆成AdminController、TeacherController、StudentController三个方向。在Servlet里做权限校验时，最简单的做法是登录成功后把登录用户对象放进Session，每次请求先用Filter统一检查Session里有没有用户，再根据请求路径前缀判断角色是否匹配，没有权限直接重定向到登录页。这样比在每个Servlet里手写判断要省事，也不容易漏。
JSP页面建议按角色建文件夹，比如webapp/admin、webapp/teacher、webapp/student，然后抽一个公共的header.jsp存放导航菜单，用include指令或JSTL引入，避免每个页面复制粘贴一大段菜单代码。我见过不少人把所有JSP全扔在根目录，页面一多自己都分不清哪个是哪个，后期改需求特别痛苦。
2. 数据库设计与成绩计算规则
2.1 核心表结构这样设计更省心
体育成绩和普通课程成绩不太一样，它不是单一分数，而是由多个项目构成，比如1000米跑、立定跳远、引体向上、平时考勤等。所以数据库设计上建议把“成绩”拆成原始项目分和总评分两部分，不要只存一个总评字段完事。
我这次设计的核心表有四张：student（学生信息）、teacher（教师信息）、course（课程/项目信息）、score（成绩记录）。登录账号我建议单独建一张表，把用户名、密码、角色类型和对应的学生ID或教师ID关联起来，后续扩展权限会方便很多。
| 表名 | 核心字段 | 说明 |
|---|---|---|
| student | id、stu_no（学号）、name、gender、class_name、major | 学生基础信息，学号设置唯一索引 |
| teacher | id、teacher_no（工号）、name、subject | 教师信息，任教科目 |
| course | id、course_name、type（体测/平时/理论）、credit | 课程或项目定义 |
| score | id、student_id、course_id、teacher_id、item_name、raw_score、total_score、semester、create_time | 成绩明细，raw_score存项目原始分，total_score存计算后的总评 |
score表里故意把item_name单独列出来，而不是只关联course表。原因是一门体育课可能包含多个体测项目，比如“大学体育一”有1000米、立定跳远两个体测项，加上平时分和理论分。如果只按course_id关联，一个学生同一门课就会产生多条记录，查询时反而要额外聚合。用item_name配合course_id，既保留项目粒度，查询展示也直观。
建表时注意两点：一是所有外键字段都要加索引，否则数据量大了之后关联查询会很慢；二是Decimal类型用来存成绩，不要用Float或Double，浮点数在计算总评时累加会产生精度问题，我后面算成绩的时候吃过这个亏。
2.2 成绩计算与统计的Java实现思路
体育成绩通常不是一个简单分数，以常见高校为例，总评成绩 = 平时成绩(20%) + 体测项目成绩(50%) + 理论/考勤成绩(30%)。体测项目里又有各自的小项评分标准，比如1000米跑多少秒对应多少分，这个规则每个学校都不一样。
实现计算时，我建议把计算逻辑单独抽成一个GradeCalculator类，不要散落在Servlet里。用Map把项目类型映射到对应的计算规则，后续新增一个项目类型，只需要往Map里注册一个计算函数，不用改调用的地方。
public class GradeCalculator { private static final Map<String, Function<RawGrade, BigDecimal>> RULES = new HashMap<>(); static { RULES.put("USUAL", GradeCalculator::calcUsual); // 平时成绩 RULES.put("PHYSICAL", GradeCalculator::calcPhysical); // 体测成绩 RULES.put("THEORY", GradeCalculator::calcTheory); // 理论/考勤 } public static BigDecimal calculate(List<RawGrade> grades) { BigDecimal total = BigDecimal.ZERO; for (RawGrade grade : grades) { Function<RawGrade, BigDecimal> rule = RULES.get(grade.getType()); if (rule == null) { throw new IllegalArgumentException("未定义的成绩类型: " + grade.getType()); } total = total.add(rule.apply(grade)); } return total; } }这里我踩过一个很典型的坑：用double直接算总评，结果出现像89.9999999这样的数字，页面展示还要额外四舍五入。改成BigDecimal之后，用String构造参数，计算精度就稳定了。
存储方面，score表的total_score字段是在录入或者修改原始成绩后，由GradeCalculator算好再入库。不要在查询的时候临时算，否则改了评分规则只能重新算历史数据，线上排查问题很麻烦。如果题目允许，也可以把计算规则做成一张权重配置表，修改规则时只需要改表数据，不用改Java代码再重新部署。答辩时提这个设计思路，老师通常会比较认可。
3. 核心功能实现与踩坑实录
3.1 学生个人信息展示页与成绩查询：用EL表达式和JSTL替代脚本片段
网上一搜“JSP个人信息展示页面怎么做”，出来的案例很多还在用<%，<%!%>这种脚本片段在JSP里写Java代码。项目能跑，但我不建议学这个写法。JSP脚本片段把业务逻辑和页面渲染耦合在一起，一出现异常，整个页面直接抛出一大段堆栈，用户看到的就是500错误页；而且多人协作时，Java代码和HTML混在一起，改起来极其痛苦。
更稳妥的做法是Servlet先把数据准备好，放到request域里，再forward到JSP页面。JSP层只用EL表达式取数据，循环用JSTL的<c:forEach>，判断用<c:if>或者<c:choose>。
<c:forEach var="score" items="${scoreList}"> <tr> <td>${score.itemName}</td> <td>${score.rawScore}</td> <td>${score.totalScore}</td> </tr> </c:forEach>如果课程里还没要求JSTL，我也建议你自己用上。因为JSP页面里不写Java代码这件事，本身就是Java Web开发的基础素养。面试的时候如果被问到“你在JSP里写过Java代码吗”，回答“没有，我用EL表达式和JSTL”，和回答“写过，用脚本片段”，给人的印象是完全不同的。
具体链路是：浏览器请求成绩查询Servlet -> Servlet调用Service层查询数据库 -> 把List放进request -> request.getRequestDispatcher("student/score.jsp").forward(req, resp)。不要在Servlet里直接给浏览器输出HTML，也不要用response.sendRedirect跳转，因为redirect是重新发起一次请求，request域里带的数据会丢。
3.2 成绩列表排序：别在页面里写冒泡排序
成绩列表基本都有排序需求：按总评成绩排名、按班级过滤、按学号排序。有不少同学的实现是在JSP里用脚本片段写个冒泡排序，把List排一遍再输出。这又是一次典型的“在错误的地方做业务逻辑”。排序属于业务处理，应该放在Service层或Controller层，JSP只负责显示已经排好的数据。
Java里对List排序，直接用Collections.sort()或者list.sort()就行。比如按总评成绩从高到低排，可以用Comparator.comparing配合reverseOrder：
list.sort(Comparator .comparing(StudentScoreVO::getTotalScore, Comparator.reverseOrder()) .thenComparing(StudentScoreVO::getStuNo));一个比较实用的小技巧是“把某元素值放第一个”。有一次需求是体育老师希望自己擅长的班级排在最前面，而其他班级按成绩排序。这个用Comparator可以这样实现：
Map<String, Integer> classOrder = Map.of("体育1班", 0); list.sort(Comparator .comparing((StudentScoreVO v) -> classOrder.getOrDefault(v.getClassName(), 1)) .thenComparing(StudentScoreVO::getTotalScore, Comparator.reverseOrder()));classOrder里命中的班级返回0，排前面；其余班级返回1，再按总评倒序排。这种写法比在循环里判断“当前班是不是目标班，是就插到前面”要干净得多，逻辑也一目了然。
再强调一遍：排序参数最好通过请求参数传进来，比如orderField=totalScore&orderType=desc，Servlet解析后动态构造Comparator。不要在页面里写死三种排序，然后在三个JSP之间复制粘贴同一个表格。
3.3 环境坑实录：JDK版本、Tomcat启动与内存溢出
这部分是实操中遇到最多、也最容易让新手心态爆炸的问题。我整理三个高频场景。
第一个是JDK版本不一致。本地用JDK 17编译出来的class文件，放到Tomcat 8的服务器上，一启动就抛UnsupportedClassVersionError。原因很简单：高版本JDK编译的字节码，低版本JVM不认。解决办法是把开发环境和运行环境的JDK版本统一。如果是课设，直接全用JDK 8最省心，Spring、Tomcat、MySQL驱动全兼容。IDE里报了“源发行版17需要目标发行版17”这类警告，就是Project Structure的Language level和maven compiler的source/target不一致，把它们都改成同一个版本即可。
第二个是Tomcat启动非常慢，有的甚至卡几十秒。这个在Linux服务器上很常见，是JDK的SecureRandom在高并发或低熵环境下初始化阻塞的问题。在catalina.sh的JAVA_OPTS里加一行参数能明显缓解：
JAVA_OPTS="-Djava.security.egd=file:/dev/urandom"Windows本地环境一般遇不到这个，但用Linux虚拟机部署时经常碰到，值得记一下。
第三个是OutOfMemoryError: Java heap space。课设数据量不大也会遇到，通常是本地调试时反复热部署，或者JSP页面里不小心把整个表的数据循环输出导致的。先检查代码是否存在一次性查询大量数据的问题，再给Tomcat调大JVM内存。Windows下修改catalina.bat（Linux是catalina.sh），加上：
set CATALINA_OPTS=-Xms256m -Xmx512m-Xms是初始堆大小，-Xmx是最大堆大小，这两个值根据机器内存合理设置即可。
4. 常见问题与排查技巧实录
4.1 高频问题速查表
做这个系统的过程中，我和身边同学踩过的坑五花八门，但高频的就那么几个。整理成表格，方便按图索骥。
| 问题现象 | 原因定位 | 解决方案 |
|---|---|---|
| 页面报java.lang.ClassNotFoundException: com.mysql.jdbc.Driver | MySQL驱动jar没放进WEB-INF/lib目录 | 下载对应版本的mysql-connector-java.jar放到WEB-INF/lib下并清理Tomcat缓存 |
| 中文乱码 | 页面编码、请求编码、数据库连接串编码未统一 | 全部统一为UTF-8，连接串加characterEncoding=utf8，JSP加pageEncoding="UTF-8" |
| 刷新页面成绩重复提交 | 表单提交后直接forward到展示页 | 录入成功后改用redirect重定向，防止表单重复提交 |
| 数据库连接耗尽导致系统卡死 | 连接/Statement/ResultSet没有关闭 | 使用try-with-resources，在finally里释放资源 |
| 启动时UnsupportedClassVersionError | JDK编译版本和运行版本不一致 | 统一开发环境与Tomcat运行环境的JDK版本 |
| JSP页面报找不到JSTL标签库 | 缺少jstl.jar和standard.jar | 根据Tomcat版本引入对应依赖，注意老项目用JSTL 1.x，新环境可能要用Jakarta taglibs |
还有一个值得单独说的：tomcat的web.xml里配置了filter，但filter里抛异常，页面只显示500却看不到日志。这种情况一定先看Tomcat的catalina.out或logs目录下的localhost.日期.log。很多同学遇到报错就盯着浏览器看，真正的堆栈信息都在服务器日志里。
4.2 从“能跑”到“能答辩”的加分经验
功能做完只是第一步，答辩或面试时老师最关注的是“这个项目你怎么想明白的”。我总结几个被问频率高、同时能给项目加分的点。
第一个是事务控制。成绩批量录入时，一个班30个学生，如果录入到第20个时报错，前19条已经写进数据库了，这就不符合数据一致性。用Connection的事务机制，录入全部成功再commit，任何一条失败就rollback：
try (Connection conn = dataSource.getConnection()) { conn.setAutoCommit(false); // 循环执行批量插入 conn.commit(); } catch (SQLException e) { conn.rollback(); throw e; }答完这一点，基本能向老师证明你考虑过数据安全问题。
第二个是权限校验。前面提过用Filter做统一校验，这里再补一句：Filter的url-pattern要写对。如果只配了“/admin/*”，那么直接访问“/adminList.jsp”可能绕过过滤。建议把所有JSP和Servlet都过滤一遍，在Filter内部先判断Session用户是否存在，再判断请求路径是否匹配角色权限，而不是只过滤一个目录。
第三个是成绩计算规则的“可配置化”。我在2.2里提到把计算规则抽成Map映射，答辩时可以进一步说“如果把规则改为从数据库读取，系统就不需要改代码调整评分权重”。这个思路一抛出来，就比单纯“用if判断成绩类型”的设计高一个层次。
最后一个建议，答辩前把项目里最核心的一条请求链路手画一遍。从浏览器输入URL开始，到Servlet接收请求、Service处理逻辑、DAO查数据库、结果set到request、forward到JSP渲染，每一步分别有哪个类、哪个文件，能做到对着白板流畅讲出来，你这门课的成绩基本稳了。
做这个系统的过程中，我自己最大的体会是：真正让你提升的往往不是把功能跑通的那一刻，而是踩坑之后把“为什么”想明白的过程。比如为什么不把排序写在JSP里、为什么成绩要用原始分而不是只存总评、为什么权限校验必须放在Filter而不是页面里——这些问题想清楚了，等到面试被问类似八股的时候，你能给出的就不再是干巴巴的定义，而是带着项目场景的具体答案。最后再分享一个小技巧：做完这个项目有空的话，可以试着用它当业务原型，自己从零搭一个Spring Boot + MyBatis的版本，同样功能对比着重写一遍，你就能直观感受到哪些工作被框架接管了，这对后续进阶的帮助比再刷十道题都实在。
本文还有配套的精品资源，点击获取
