简介：本资源为基于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.7，JDK版本为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 秒）而不是直接存分数，评分逻辑放到业务层，这样评分标准变了不用改历史数据。

下面是我最终用的建表 SQL，MySQL 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 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 测试项目表：把项目做成可配置，别写死在代码里 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 '前端展示顺序' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 测试批次表：区分学期，方便按批次统计和上报 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=已结束' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 成绩表：核心数据，一个学生一个批次一个项目一条记录 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) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

这段 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) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

注意 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> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.5</version> </dependency> <dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <scope>runtime</scope> </dependency> </dependencies>

application.yml 里数据库连接是必调参数，重点看serverTimezone和characterEncoding，这两个不写对，中文乱码和时间差 8 小时的问题会一直缠着你。

spring: datasource: url: jdbc:mysql://localhost:3306/fitness_test?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/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: 8080

map-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 id="upsert"> 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() </insert>

ON 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 { List<ReportRow> rows = scoreRecordMapper.selectReportData(batchId); response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); response.setHeader("Content-Disposition", "attachment;filename=report.xlsx"); EasyExcel.write(response.getOutputStream(), ReportRow.class) .sheet("体测上报") .doWrite(rows); }

ReportRow这个类用@ExcelProperty注解标好列名和顺序，EasyExcel 会按注解顺序写列。这里最容易翻车的是日期格式，上报模板要求出生日期是yyyy-MM-dd，如果实体里是 Date 类型，要加@DateTimeFormat或在注解里指定格式，否则导出来是一串数字。

5. 避坑与排查：体测系统上线后最常炸的五个地方

系统能跑起来只是开始，真正上线用起来才会暴露问题。下面这五条是我和同行踩过的，按「现象 → 原因 → 解决」写清楚。

现象一：中文姓名和学院名在页面上显示成问号。原因：数据库连接串没指定字符集，或者建表时用了 latin1。解决：连接串加characterEncoding=utf8，建表统一用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 定义。

我自己做这套系统最大的教训是：别一上来就写代码，先花半天把数据模型和评分标准想清楚，尤其是补测和统计口径这两个问题，一定要提前问清楚需求方。我第一版返工重写，就是因为没问「补测要不要保留原始记录」，结果表结构推倒重来，白干三天。把模型定死再动手，后面会顺很多。希望帮到你。

本文还有配套的精品资源，点击获取