简介这份基于Spring Boot与Vue的大学生期末体测测试平台项目源码主要为Java Web课程设计、毕业设计及全栈入门者提供一套可运行、可二次开发的完整方案覆盖体测数据管理、测试流程记录、用户信息维护等典型业务模块。压缩包共861个文件约16.97MB包含147个Java后端类、53个Vue前端组件、55个HTML页面、53个CSS样式和164个JavaScript脚本同时有XML映射、MySQL数据库脚本、GIF演示图与图片素材目录按后端、前端、配置、资源分类便于按需检索。项目还附有安装、启动、构建等批处理脚本以及Word版设计文档含摘要、目录、绪论、相关技术等章节可帮助读者从环境搭建、数据库初始化到页面联调完整跑通流程并理解Spring Boot MyBatisPlus Vue前后端分离的实现细节。目前已有97人学习下载适合希望快速上手并扩展到实际体测管理场景的开发者。1. 从成绩填报到业务平台这个 Java Web 系统真正要解决的不是增删改查每年期末高校体育部都要把几千名学生的身高、体重、肺活量、立定跳远、长跑成绩汇总成一份体测总表。常见场景是体育老师逐个录入 Excel辅导员催数据催到崩溃最后再靠人工对照评分表算出等级和总分反复核对仍然出错。与其说这是一次“Java Web 课的期末项目”不如说它是一道典型的业务建模题同一套体测标准要同时服务学生查询、教师录入、管理员统计并且按性别、年级、项目三个维度实时计算得分与等级。从这个标题展开核心难点有三个体测标准怎么落库、评分逻辑怎么参数化、多角色权限怎么写得更安全。下面这套设计基于 Spring Boot MySQL 的 Web 技术栈实现读完可以照着建表、写评分引擎、再挂前端页面。项目适合 Java Web 学习者用作工程实践也适合直接改造成毕业设计或期末大作业。2. 先定体测业务边界再用关系模型固化评分标准2.1 三张核心业务表和一个关键中间表体测平台里的用户无非三类学生要查成绩、看等级体育老师要批量录入测试数据、导出异常名单管理员要管用户、管项目、看总评统计。很多初学者一上来就建一张巨大的score表把所有字段塞进去这是后期评分逻辑最难维护的写法。常见做法是把“一次测试”和“一项得分”拆开test_record测试记录保存某次体测的整体信息比如学期、学生、测试时间test_score_detail单项成绩明细保存每个具体项目的原始成绩和对应的单项得分。这样当你需要增加一个新的体测项目比如引体向上换成仰卧起坐不需要修改表结构只增加一行申报数据即可。 学生端还要区分身份。我一般会建议在user表里加入role字段后用int存储 0/1/2分别表示学生、教师、管理员配合 Spring Security 做接口级权限控制。除此之外最容易忽略的是test_appointment体测预约中间表。期末体测普遍存在场地和人数的瓶颈同一时段能接纳的考生有限用中间表保存student_id、appointment_date、time_slot三列后续做并发控制和冲突检测都很方便。2.2 评分标准的表结构把维度拆成行而不是硬编码体测成绩不能写死在 Java 代码里否则每年的标准一调整就得改源代码、重新打包。正确思路是把标准当作数据放进表里运行时查表计算。每一条标准记录的判定维度包括项目编号、性别、年级、成绩区间、得分。评定逻辑简述如下一段典型的建表 SQL 如下。CREATE TABLE test_standard ( id INT PRIMARY KEY AUTO_INCREMENT, item_code VARCHAR(20) NOT NULL COMMENT 体测项目编码height / lung / run / jump, gender TINYINT NOT NULL COMMENT 1-男 0-女, grade VARCHAR(20) NOT NULL COMMENT 适用年级freshman / sophomore, min_val DECIMAL(6,2) NULL COMMENT 区间下限含, max_val DECIMAL(6,2) NULL COMMENT 区间上限不含, score DECIMAL(5,2) NOT NULL COMMENT 命中此区间所得的分数, better_direction TINYINT NOT NULL DEFAULT 1 COMMENT 1-数值越大越好0-数值越小越好, KEY idx_standard (item_code, gender, grade) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;注意better_direction这个字段看起来不起眼实际在业务上影响很大。长跑是时间越小得分越高跳远是距离越大越好如果只做区间匹配而不区分方向就很容易把“跑得快”和“跑得慢”的得分对调。在实际开发中算分的时候用它来判断命中区间后是否需要翻转取值区间也用它辅助前端展示“越高越好”或“越低越好”的箭头指示。test_score_detail则偏向保存测试的原始成绩先录入学生的身高、体重、肺活量原始数值得分留空提交时触发评分服务回填。这样原始数据可追溯哪怕后来发现评分标准录入错了也可以重新触发一次全量或按班级的评分任务而不必让老师重新录一次原始成绩。2.3 事务边界一个批次提交对应的原子写操作成绩录入通常会采用“按班级批量保存”的方式如果快 50 条数据插入一半时报错数据库里就留下了脏数据。这里事务的粒度是一个批量提交批次Service public class TestRecordServiceImpl implements TestRecordService { Transactional(rollbackFor Exception.class) public BatchSubmitResult batchSubmit(ListScoreSubmitDTO list, Integer semesterId) { int success 0; ListString failedRows new ArrayList(); for (ScoreSubmitDTO dto : list) { try { saveSingleRecord(dto, semesterId); success; } catch (BusinessException ex) { failedRows.add(dto.getStudentNo() : ex.getMessage()); } } return new BatchSubmitResult(success, failedRows); } }Transactional保证了 saveSingleRecord 里的所有 insert/update 要么整体成功要么回滚。这里最容易踩的坑是“一个学生的一条记录失败导致整体失败”所以要在循环内部捕获异常并记录失败行而不是把异常直接向上抛。用户在界面上能得到成功数和失败列表同时事务又保证了失败行不会以半成品状态落库。3. 后端评分引擎与权限控制把判定规则从业务代码里拆出去3.1 分层之后的业务出口长什么样Java Web 项目最常见的分包方式是 controller、service、mapperdao、domain 四层这套结构放到体测平台上同样适用。但要注意 service 层不能只做一个“透传”动作评分计算这类复杂逻辑更应该沉淀成独立的领域服务比如ScoreCalculateService、StandardQueryService而不是全部写在 Controller 里。否则接口层会越来越胖想写单元测试都无从下手。Controller 层的典型写法RestController RequestMapping(/api/score) public class ScoreController { private final ScoreCalculateService scoreCalculateService; public ScoreController(ScoreCalculateService scoreCalculateService) { this.scoreCalculateService scoreCalculateService; } PostMapping(/calculate) public Result calculate(RequestBody StudentTestRecordDTO dto) { StandardEntity[] standards standardRepository.findByGenderAndGrade(dto.getGender(), dto.getGrade()); return Result.ok(scoreCalculateService.calculate(dto, standards)); } }3.2 评分引擎先查标准表再计算总分与等级核心评分逻辑可以抽象成三步查标准、单项匹配、汇总加权。其中匹配标准最关键的是二分查找。测试标准表按“离散区间”存放而长跑成绩是连续秒数直接在内存里循环匹配效率不高且代码难以维护。更稳妥的思路是在加载标准时按min_val排序然后用二分查找定位命中区间。打分并汇总的代码如下。Component public class ScoreCalculator { /** * param scoreValue 单项原始成绩 * param standards 已按 min_val 升序排列的标准列表 */ public BigDecimal evaluateSingleItem(BigDecimal scoreValue, ListStandardEntity standards) { int low 0, high standards.size() - 1; StandardEntity hit null; while (low high) { int mid (low high) 1; StandardEntity s standards.get(mid); if (scoreValue.compareTo(s.getMinVal()) 0 scoreValue.compareTo(s.getMaxVal()) 0) { hit s; break; } if (s.getBetterDirection() 1 scoreValue.compareTo(s.getMinVal()) 0) { high mid - 1; } else { low mid 1; } } return hit null ? BigDecimal.ZERO : hit.getScore(); } }这段代码把标准列表买下来之后直接用二分匹配前提是标准表按 min_val 升序。很多初次接触者容易忽略better_direction对二分方向的影响导致长跑项目命中错误区间。体测项目的方向在查询标准时已经确定此处需要传入列表中第一条标准的better_direction来决定“更小的数值”是向左走还是向右走。 总分计算则使用加权公式建议把权重也放到字典表中而不是硬编码。比如肺活量权重 15%、长跑权重 20%。当学校调整评估权重时只需要单独更新一条表记录如果这个项目是毕业设计完成“权重参数化”这个点也能让答辩更有亮点。3.3 用动态代理机制实现角色权限校验权限控制不能只靠前端隐藏按钮后端接口必须做二次拦截。Spring Security 已经提供了成熟的方案但如果不想引入过重的框架用 AOP 自定义注解也可以保证足够的强度。这里用到的是 Spring AOP底层基于 Java 动态代理机制对应的代码实现模式如下Aspect Component public class RoleCheckAspect { Before(annotation(roleCheck)) public void checkRole(JoinPoint joinPoint, RoleCheck roleCheck) throws Throwable { ServletRequestAttributes attrs (ServletRequestAttributes) RequestContextHolder.getRequestAttributes(); if (attrs null) { throw new UnauthorizedException(请求上下文不存在); } HttpServletRequest request attrs.getRequest(); UserDTO currentUser (UserDTO) request.getSession().getAttribute(currentUser); if (currentUser null) { throw new UnauthorizedException(未登录); } boolean allowed Arrays.stream(roleCheck.value()) .anyMatch(role - role currentUser.getRole()); if (!allowed) { throw new ForbiddenException(当前角色无权执行此操作); } } }自定义的RoleCheck注解可以加在 Controller 方法上例如RoleCheck(role RoleEnum.ADMIN)。如果了解过 Java 基础面试中动态代理的原理这里就是一个典型的工程应用Spring 在 Bean 初始化阶段为目标对象生成代理类拦截器方法在目标方法执行前先执行角色判定。这样做的好处是业务代码不需要重复写 if/else 判断角色新增接口时只要加一行注解即可。3.4 事务里的一个大坑同一事务内先删后插成绩重算功能必须支持“重新打分”常见做法是删除某个学生的所有单项成绩再插入新的。但如果这两个操作在同一个事务里并且删除用DELETE FROM test_score_detail WHERE student_no?插入用循环单条INSERT并发情况下可能出现重复数据。这里要用数据库层面的唯一约束兜底保证student_no item_code test_semester唯一。4. Web 前端与数据可视化成绩单、报表和图表如何跑通4.1 页面架构Bootstrap 搭骨架Vue 管交互作为课程设计级别的 Web 项目不需要上一套微前端架构。常见做法是后端用 Thymeleaf 或者直接把 Vue 通过 CDN 引入管理后台用 Bootstrap 搭建数据图表用 ECharts 渲染。Vue 负责绑定成绩录入表单、筛选条件和图表数据源后端只提供 JSON 接口这样最省事。成绩录入页面的核心交互模型是这样的第一列选择测试项目第二列填写原始成绩第三列显示实时评分。实现“输入即算分”需要调用后端的评分接口也可以为了减少请求次数先把该性别年级的评分标准一次性拉到前端用 JavaScript 做一次镜像计算。前者适合展示 Web 工程的异步交互能力后者性能更好。4.2 从成绩明细到分布报表学生端成绩单页面除了展示总分和等级通常还需要展示和往期成绩的对比图。一个典型页面是把后端接口返回的 JSON 数据直接传给 ECharts 的柱状图组件。const app new Vue({ el: #scoreChart, data: { chartData: [], studentNo: }, methods: { async loadScores() { const res await fetch(/api/score/history?studentNo this.studentNo, { headers: { Content-Type: application/json } }); const data await res.json(); this.chartData data.data; this.renderChart(); }, renderChart() { const chart echarts.init(document.getElementById(mainChart)); chart.setOption({ tooltip: { trigger: axis }, xAxis: { data: this.chartData.map(item item.semesterName) }, yAxis: { name: 分数 }, series: [{ name: 体测总分, type: line, data: this.chartData.map(item item.totalScore) }] }); } }, mounted() { this.loadScores(); } });抓取到的后端接口如果返回的是这样格式的 JSON至少要把semesterName和totalScore的字段名约定好不然页面就要做大量的防御性判断{ code: 200, data: [ { semesterName: 2024-2025-1, totalScore: 82.5 }, { semesterName: 2023-2024-2, totalScore: 78.0 } ] }4.3 批量导入Apache POI 读取 Excel 时的编码与格式坑教师端最常见的场景不是一行行录而是把手里一份现成的 Excel 表整体导入。常见做法是用 Apache POI 读取.xlsx逐行校验再入库。这里有两个高频坑需要预先规避。Excel 里的日期列会以数字形式存储。如果有一列是测试日期直接用row.getCell(5).getStringCellValue()会抛异常。正确写法是先判断单元格类型Cell cell row.getCell(5); String dateValue ; if (cell.getCellType() CellType.NUMERIC) { Date d cell.getDateCellValue(); dateValue new SimpleDateFormat(yyyy-MM-dd).format(d); } else { dateValue cell.getStringCellValue(); }第二个坑是空行和空单元格。解析 Excel 时经常在末尾出现完全空白的行去掉空行的判断逻辑可以这样写if (row null || row.getLastCellNum() 0) { continue; }如果导入过程中有一行的学号在 user 表里不存在建议不要中断整个文件而是把错误行记录到内存列表里导入完成后输出一个汇总结果。这与前面批量提交事务的容错思路一致。5. 并发预约、参数化调优与 Java Web 工程部署5.1 预约体测时的超卖问题版本号乐观锁体测预约最典型的高并发场景是开放预约当天的集中访问。一个时间段的容量是固定的比如某个时间段最多 50 人。如果只是简单做一次SELECT COUNT(*)然后判断是否小于容量两个并发请求同时读到 49 就会都放行最后变成 51 人。这里最轻量的解法是数据库乐观锁在test_appointment表里增加version INT字段UPDATE test_appointment SET booked_num booked_num 1, version version 1 WHERE slot_id ? AND booked_num ? AND version ?;如果更新影响的行数为 0说明此时段已满或版本号冲突直接提示“该时段已被约满”。这个方案不需要引入 Redis 就已经能避免超卖。如果要拿来做并发压测点可以在预约记录表上再加一个唯一索引(student_id, slot_id)保证同一学生同一时段只能预约一次。5.2 Windows 和 Linux 上的部署流程部署体测平台最常见的方式是把 Spring Boot 项目打成 jar 包运行这种方式最省心。用 Maven 打包之后服务器上只需要装 JDK 并配置好环境变量即可。如果选择 Docker 部署 Web 工程典型的 docker-compose 服务结构包含 mysql、java-app 和前端静态资源三个容器version: 3 services: mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: root123 MYSQL_DATABASE: physical_test ports: - 3306:3306 volumes: - ./init.sql:/docker-entrypoint-initdb.d/init.sql app: image: openjdk:11 depends_on: - mysql volumes: - ./target/physical-test.jar:/app/app.jar command: [java, -jar, /app/app.jar, --spring.profiles.activeprod] ports: - 8080:8080用 Docker 部署比直接java -jar多出不少细节。数据库连接地址不能写localhost而要写服务名mysql首次启动时要保证 MySQL 初始化完成否则 Spring Boot 启动会报数据库连接失败。可以在启动脚本中做一次端口检测也可以让 Java 应用开启重试连接。这里还要注意容器时区问题体测成绩记录依赖日期需要给 JVM 传入-Duser.timezoneAsia/Shanghai。5.3 安全基线必须做的三件事体测平台虽然是校内项目但成绩数据本身比较敏感直接裸奔上线容易被当成攻击练手靶子。参考常见 Web 安全加固思路至少要做三件事所有查询接口强制走预编译 SQLMyBatis 里用#{}而不是${}从根上避免 SQL 注入。管理后台的 Cookie 要设置HttpOnly属性防止脚本窃取会话。对成绩查询接口做数据越权检查。学生只能查自己的成绩不能通过拼接 URL 换 studentNo 查别人的数据。最简单的方式是从 Session 中获取当前登录人的 ID而不是无条件信任前端传参。这些点如果出现在课程设计答辩或面试里往往比“我用了 Spring Boot Vue”更有区分度。5.4 评分结果出现偏差时的排查路径如果发现单个学生的单项分和手工查询不一致优先怀疑两点一是该学生的性别、年级是否录错。男生 1000 米和女生 800 米的标准完全不同性别字段存反了必然算错。二是标准表的区间边界处理方式min_val是含端点、max_val是不含端点还是反过来必须和评分计算代码保持严格一致。建议在标准管理页面每次修改后都打印一条审计日志记录修改前后的值和时间方便回溯。另外在部署阶段如果遇到java.net.SocketException或数据库连接超时多数是 MySQL 的 wait_timeout 默认值偏短导致连接池回收空闲连接不及时。常见做法是在配置里增加spring.datasource.hikari.connection-test-querySELECT 1让连接池自动检测失效连接这样长假期后重新打开系统首页加载不会白屏。整个平台跑通后可以再补一份定时备份脚本每天凌晨将 MySQL 的备份文件归档保存体测成绩这类一年只用几次的数据真丢了才是最麻烦的灾难。本文还有配套的精品资源点击获取