简介本资源为基于SpringBoot与Vue的大学生体质测试系统完整源码面向计算机相关专业做毕业设计的学生及需要Java全栈项目练手的开发者可解决体测数据管理、成绩录入与统计查询等场景的开发需求。压缩包共794个文件约18.59MB以99个Java后端源码、41个Vue组件、164个js脚本、53个css样式及34个html页面为主另含svg、png、jpg等图片素材与xml、yml、properties等配置文件前后端结构完整。技术栈覆盖Java、SpringBoot、MyBatisPlus、MySQL、Vue、Ajax与Maven数据库采用MySQL 5.7JDK版本为1.8并附有项目说明文档与目录结构便于快速导入IDE运行调试。目前已有109人学习下载适合作为毕设参考或课程设计模板帮助读者理解B/S架构下的体测管理模块划分与前后端交互实现。1. 大学生体质测试系统从体测排队两小时到扫码录入三秒钟每年九月开学体育部的老师最头疼的不是排课而是全校一两万人的体质测试数据怎么收。纸质表格发下去、学生手填、班长收齐、老师再一份份敲进 Excel一个学院折腾一周最后汇总时还发现身高体重单位混着填、肺活量少录一位、50 米跑成绩有人写成 7 秒有人写成 7.0。这套流程我见过太多学校在跑问题不在老师不认真而在于工具本身就不该是纸和 Excel。大学生体质测试系统要解决的就是这件事把学生信息、测试项目、成绩录入、统计查询、上报导出这几件事搬到 Web 上让体测从「体力活」变成「数据流」。它适合两类人一类是正在做毕设、需要一套能跑通、能讲清楚、能答辩的 Java Web 项目的同学另一类是学校体育部或信息中心想自己搭一套轻量系统替换掉纸质流程的开发者。标题里出现的「源码」「毕设项目」「java」这几个词说明大多数人要的不是概念而是一套能部署、能改、能写进论文的实现路径。这篇笔记按「先想清楚数据模型 → 再搭后端 → 再落前端 → 最后避坑和进阶」的顺序走中间会给可直接抄的代码和参数。我做过两版类似的体测系统第一版踩了数据模型的坑返工重写第二版才顺下来这些经验都会写进去。2. 先把数据模型定死体测系统的四张核心表怎么设计体测系统看着简单其实最容易翻车的地方就是表结构。我第一版把「学生」和「成绩」塞进一张表结果一个学生测了两次补测数据直接冲突只能删表重来。所以动手写代码之前先把实体关系理清楚。2.1 体测业务的实体关系与字段取舍一个标准的大学生体质测试业务核心实体有四个学生、测试项目、测试批次、成绩记录。学生和成绩是一对多一个学生多个项目、可能多次测试测试项目和成绩是一对多批次用来区分「2024 秋季」「2025 春季」这种时间维度。字段设计上有几个必须提前想清楚的点。性别字段不能省因为坐位体前屈、引体向上/仰卧起坐、800 米/1000 米这些项目的评分标准是按性别分开的。年级字段也要留不同年级的及格线在部分学校是有差异的。成绩表里我建议存原始值比如 50 米跑存 7.2 秒而不是直接存分数评分逻辑放到业务层这样评分标准变了不用改历史数据。下面是我最终用的建表 SQLMySQL 8.0 直接跑-- 学生表体测的主体 CREATE TABLE student ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_no VARCHAR(20) NOT NULL UNIQUE COMMENT 学号登录和查询的唯一标识, name VARCHAR(50) NOT NULL, gender TINYINT NOT NULL COMMENT 1男 2女评分标准依赖此字段, grade VARCHAR(10) NOT NULL COMMENT 年级如2023, college VARCHAR(50) COMMENT 学院, class_name VARCHAR(50) COMMENT 班级, created_at DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 测试项目表把项目做成可配置别写死在代码里 CREATE TABLE test_item ( id BIGINT PRIMARY KEY AUTO_INCREMENT, item_code VARCHAR(20) NOT NULL UNIQUE COMMENT 如 height/weight/vital_capacity/run_50, item_name VARCHAR(50) NOT NULL, unit VARCHAR(10) COMMENT 单位cm/kg/ml/s, sort_order INT DEFAULT 0 COMMENT 前端展示顺序 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 测试批次表区分学期方便按批次统计和上报 CREATE TABLE test_batch ( id BIGINT PRIMARY KEY AUTO_INCREMENT, batch_name VARCHAR(50) NOT NULL COMMENT 如2024年秋季体测, start_date DATE, end_date DATE, status TINYINT DEFAULT 0 COMMENT 0进行中 1已结束 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 成绩表核心数据一个学生一个批次一个项目一条记录 CREATE TABLE score_record ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id BIGINT NOT NULL, item_id BIGINT NOT NULL, batch_id BIGINT NOT NULL, raw_value DECIMAL(6,2) COMMENT 原始测量值不存分数, score INT COMMENT 换算后的得分由业务层计算, test_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_stu_item_batch (student_id, item_id, batch_id), INDEX idx_batch (batch_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这段 SQL 的关键在最后那张成绩表的唯一索引uk_stu_item_batch。它保证同一个学生在同一批次、同一个项目上只有一条记录补测时用INSERT ... ON DUPLICATE KEY UPDATE覆盖即可不会产生脏数据。raw_value用 DECIMAL 而不是 FLOAT是因为体测成绩要精确到小数点后一位浮点数在统计求和时会出现 0.30000000000000004 这种玄学问题。2.2 评分标准怎么落地配置化而不是硬编码体测的评分标准是国家学生体质健康标准每个项目按性别、按成绩区间给分。很多毕设项目图省事直接在 Java 里写一堆 if-else结果老师一问「标准改了怎么办」就答不上来。正确做法是把评分表也做成数据。我一般会加一张score_standard表字段是项目、性别、下限、上限、对应分数。查询时按 raw_value 落在哪个区间取分。这样评分标准更新只需要改数据不用重新编译部署。CREATE TABLE score_standard ( id BIGINT PRIMARY KEY AUTO_INCREMENT, item_id BIGINT NOT NULL, gender TINYINT NOT NULL, min_value DECIMAL(6,2) NOT NULL, max_value DECIMAL(6,2) NOT NULL, score INT NOT NULL, INDEX idx_item_gender (item_id, gender) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;注意 50 米跑、800/1000 米这类项目是「数值越小越好」而肺活量、坐位体前屈是「数值越大越好」。所以区间匹配时不能统一用BETWEEN要么在表里加一个direction字段标记方向要么在业务层按项目类型分别处理。我选的是后者因为项目类型是有限的代码里判断更直观。提示评分标准表的数据量不大几十个项目 × 2 个性别 × 若干区间可以直接用 SQL 脚本初始化不用做管理界面省一大块工作量。3. 后端接口怎么搭Spring Boot 三层结构的最小可用实现数据模型定完接下来是后端。标题里「java」「源码」这两个词决定了技术栈我选 Spring Boot MyBatis-Plus这是目前毕设和中小型 Web 项目最稳的组合资料多、上手快、答辩时老师也认。3.1 项目结构与依赖配置标准的 Maven 项目结构controller / service / mapper / entity 四层。pom.xml 里核心依赖就三个spring-boot-starter-web、mybatis-plus-boot-starter、mysql-connector-j。别引一堆用不上的东西依赖越少启动越快答辩演示时也少出岔子。dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.5/version /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency /dependenciesapplication.yml 里数据库连接是必调参数重点看serverTimezone和characterEncoding这两个不写对中文乱码和时间差 8 小时的问题会一直缠着你。spring: datasource: url: jdbc:mysql://localhost:3306/fitness_test?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: configuration: map-underscore-to-camel-case: true server: port: 8080map-underscore-to-camel-case: true这行很关键它让数据库的student_no自动映射到 Java 的studentNo省掉大量手动映射代码。3.2 成绩录入与评分计算的核心 Service成绩录入是整个系统的心脏。前端传上来的是原始值后端要负责换算分数、判断是否及格、处理补测覆盖。下面这个 Service 方法是我实际用的简化版Service public class ScoreService { Autowired private ScoreRecordMapper scoreRecordMapper; Autowired private ScoreStandardMapper scoreStandardMapper; /** * 录入成绩先算分再落库补测时覆盖旧记录 * param studentId 学生ID * param itemId 项目ID * param batchId 批次ID * param rawValue 原始测量值 * param gender 性别决定用哪套评分标准 */ Transactional public void recordScore(Long studentId, Long itemId, Long batchId, BigDecimal rawValue, Integer gender) { // 1. 查评分标准找到 rawValue 落在哪个区间 ScoreStandard std scoreStandardMapper.findByValue(itemId, gender, rawValue); int score (std ! null) ? std.getScore() : 0; // 2. 构造记录利用唯一索引做 upsert ScoreRecord record new ScoreRecord(); record.setStudentId(studentId); record.setItemId(itemId); record.setBatchId(batchId); record.setRawValue(rawValue); record.setScore(score); // 3. 存在则更新不存在则插入 scoreRecordMapper.upsert(record); } }逻辑说明第一步查标准表拿到分数第二步组装记录第三步靠数据库唯一索引做 upsert。Transactional保证算分和落库是一个原子操作避免算完分插入失败导致数据不一致。参数说明rawValue用 BigDecimal 接收前端传字符串后端转避免精度丢失gender必须从学生表查出来传进来不能信前端传的值否则学生可以伪造性别拿高分。对应的 upsert SQL 在 Mapper XML 里insert idupsert INSERT INTO score_record (student_id, item_id, batch_id, raw_value, score) VALUES (#{studentId}, #{itemId}, #{batchId}, #{rawValue}, #{score}) ON DUPLICATE KEY UPDATE raw_value #{rawValue}, score #{score}, test_time NOW() /insertON DUPLICATE KEY UPDATE是 MySQL 特有的语法命中唯一索引时执行更新否则插入。这一句就解决了补测覆盖的问题比先查后判断再插入的写法少一次数据库往返。3.3 统计查询接口按学院、按项目汇总体测系统最后一定要出统计报表体育部要的是「各学院及格率」「各项目平均分」这类数据。这类查询用 MyBatis 写聚合 SQL 最直接别在 Java 里循环累加数据量一大就慢。-- 按学院统计及格率及格线60分 SELECT s.college, COUNT(DISTINCT s.id) AS total_students, SUM(CASE WHEN r.score 60 THEN 1 ELSE 0 END) AS pass_count, ROUND(SUM(CASE WHEN r.score 60 THEN 1 ELSE 0 END) / COUNT(DISTINCT s.id) * 100, 2) AS pass_rate FROM student s JOIN score_record r ON s.id r.student_id WHERE r.batch_id #{batchId} GROUP BY s.college;这个查询里COUNT(DISTINCT s.id)是必须的因为一个学生有多个项目记录直接 COUNT 会把学生数算多。这是统计类需求最常见的坑我第一次写就栽在这报表里学生总数比实际多出好几倍。4. 前端页面与数据录入让体测老师愿意用的三个细节后端接口通了前端如果做得难用老师还是回去用 Excel。体测系统的前端不需要花哨但有几个细节直接决定它能不能被真正用起来。4.1 成绩录入页的批量提交与实时校验体测现场是老师拿着平板或笔记本一个班几十个学生挨个录。如果每录一项就提交一次网络一卡就丢数据。我的做法是前端攒一个班级的成绩数组老师录完点「提交本班」一次性发请求。// 批量提交本班成绩 async function submitBatchScores(classId, batchId, scoreList) { // scoreList 结构: [{studentId, itemId, rawValue}, ...] const invalid scoreList.filter(s { // 基本校验数值必须为正且不超过合理上限 return !s.rawValue || s.rawValue 0 || s.rawValue 9999; }); if (invalid.length 0) { alert(有 ${invalid.length} 条数据异常请检查后再提交); return; } const resp await fetch(/api/score/batch, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ classId, batchId, scores: scoreList }) }); const result await resp.json(); if (result.code 200) { alert(成功录入 ${result.data.successCount} 条); } }逻辑说明提交前先在前端做一轮基础校验把明显错误负数、超大值拦下来减少无效请求。后端接口接收数组循环调用 Service 的 recordScore返回成功条数。参数说明rawValue前端用parseFloat转成数字再传避免传字符串导致后端 BigDecimal 解析异常。校验上限设 9999 是个经验值肺活量最大也就 8000 多毫升超过这个数基本是手滑多按了一位。4.2 学生自助查询扫码登录与成绩单展示现在学生都习惯自己查成绩与其让老师一个个通知不如做个查询页。学生输入学号 姓名后四位就能查自己的体测成绩和总分。这里要注意隐私不能只凭学号就返回数据否则学号是连号的别人随便试就能看到。成绩单展示时把每个项目的原始值、得分、是否及格列成表格最后给一个总分和等级优秀/良好/及格/不及格。等级划分按国家标准90 分以上优秀80-89 良好60-79 及格60 以下不及格。4.3 数据导出Excel 上报格式的字段对齐体测数据最终要上报到国家学生体质健康网上报格式是固定的 Excel 模板。导出功能不能随便设计列必须和上报模板对齐。我一般用 EasyExcel 做导出字段顺序严格按模板来学号、姓名、性别、出生日期、各项成绩、总分、等级一个都不能错位。// 导出上报 Excel字段顺序必须和官方模板一致 public void exportReport(Long batchId, HttpServletResponse response) throws IOException { ListReportRow rows scoreRecordMapper.selectReportData(batchId); response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setHeader(Content-Disposition, attachment;filenamereport.xlsx); EasyExcel.write(response.getOutputStream(), ReportRow.class) .sheet(体测上报) .doWrite(rows); }ReportRow这个类用ExcelProperty注解标好列名和顺序EasyExcel 会按注解顺序写列。这里最容易翻车的是日期格式上报模板要求出生日期是yyyy-MM-dd如果实体里是 Date 类型要加DateTimeFormat或在注解里指定格式否则导出来是一串数字。5. 避坑与排查体测系统上线后最常炸的五个地方系统能跑起来只是开始真正上线用起来才会暴露问题。下面这五条是我和同行踩过的按「现象 → 原因 → 解决」写清楚。现象一中文姓名和学院名在页面上显示成问号。原因数据库连接串没指定字符集或者建表时用了 latin1。解决连接串加characterEncodingutf8建表统一用utf8mb4已经建错的表用ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4改过来。现象二成绩录入后查询不到但数据库里明明有。原因查询时 batch_id 传的是当前批次但录入时用的批次 ID 不一致或者前端传的 batchId 是字符串没转数字。解决在 Controller 层统一用RequestParam Long batchId强制类型前端传参前parseInt转换别信 JS 的隐式类型。现象三补测成绩覆盖了原始成绩老师要求保留两次记录。原因唯一索引设计成「学生项目批次」补测和初测在同一批次就冲突了。解决如果业务要求保留多次唯一索引要加上测试轮次字段或者干脆去掉唯一索引改成查询时取最新一条。这个需求一定要提前和老师确认我第一版就是没问清楚返工的。现象四统计报表的及格率和手工算的对不上。原因一个学生有多个项目有的项目及格有的不及格及格率到底按「人」算还是按「人次」算没定义清楚。解决明确按人算——一个学生所有项目都及格才算及格SQL 里用HAVING MIN(score) 60或者子查询先聚合到人再统计。现象五系统部署到服务器后本地能连的数据库连不上。原因本地 MySQL 是 localhost服务器上数据库可能是独立 IP或者防火墙没放行 3306。解决连接串改成实际 IP服务器安全组放行端口生产环境别用 root 账号建一个只有该库权限的专用账号。注意体测数据涉及学生个人信息导出和查询接口一定要做权限控制别让未登录用户能拉到全量数据。这是答辩时老师最爱问的点。6. 进阶技巧把评分标准和上报模板做成可配置系统做完能跑和系统做完能长期用中间差的就是「可配置」这三个字。体测的评分标准和上报模板几乎每年都可能微调如果每次都改代码重新部署维护成本会很高。我最后做的一件事是把这两块都抽成配置。评分标准前面已经做成表了这里补一个管理端的思路加一个简单的标准维护页面管理员可以按项目、性别维护分数区间改完立即生效。上报模板则做成字段映射配置把「系统字段」和「上报列名」的对应关系存到一张export_config表里导出时动态组装列。这样上报模板变了改配置就行不用动代码。验证配置是否生效我一般用一个小技巧造一批边界数据跑一遍。比如 50 米跑刚好卡在及格线的那一秒、肺活量刚好差 1 毫升到下一档看系统给的分对不对。边界值最容易暴露区间匹配的 off-by-one 错误min_value x max_value还是min_value x max_value差一个等号结果就不同。-- 边界测试数据验证评分区间是否闭合正确 INSERT INTO score_record (student_id, item_id, batch_id, raw_value, score) VALUES (1, 3, 1, 59.9, NULL), -- 坐位体前屈刚好差0.1到及格档 (1, 3, 1, 60.0, NULL); -- 刚好到及格档看是否给对分跑完看这两条记录的 score 字段如果 59.9 和 60.0 拿到同一个分说明区间边界写错了得回去检查score_standard表的 min/max 定义。我自己做这套系统最大的教训是别一上来就写代码先花半天把数据模型和评分标准想清楚尤其是补测和统计口径这两个问题一定要提前问清楚需求方。我第一版返工重写就是因为没问「补测要不要保留原始记录」结果表结构推倒重来白干三天。把模型定死再动手后面会顺很多。希望帮到你。本文还有配套的精品资源点击获取