简介本资源为基于Java的学生体质健康管理系统毕业设计资料包含完整论文与项目源码面向计算机相关专业毕业生及需要Java Web实战练习的开发者。系统采用Java语言、SpringBoot框架与MySQL数据库基于B/S模式构建涵盖登录注册、个人中心、学生管理、医生管理、健康知识管理、体测标准管理、班级信息管理、健康档案管理及健康建议管理等模块论文完整呈现绪论、相关技术、系统分析、系统设计、系统实现与系统测试等章节并附数据库概念与逻辑设计、测试用例及结论。资源包共1个docx文件约2.54MB内容为论文与源码整合文档目录结构清晰便于按章节查阅与对照学习。目前已有264人学习下载适合需要完整毕设方案、系统设计思路与功能模块实现参考的读者可帮助快速理解项目架构、数据库表设计与测试流程为毕业设计写作与Java Web项目开发提供实用参考。1. 从一份“学生体质健康管理系统”说起为什么 Java SpringBoot MySQL 依然是毕设最稳的落地组合每年到了毕设季后台被问得最多的一类问题就是“基于 Java 的学生体质健康管理系统到底该怎么落地”问的人里有刚学完 Java 基础、连 SpringBoot 配置文件都还没写利索的新手也有工作两年想补一个完整项目练手的熟手。这个标题看着朴素但它背后其实是一套非常典型的 B/S 架构业务系统学生端录入体测数据、教师端审核与统计、管理端维护班级与指标数据落到 MySQL接口用 SpringBoot 暴露前端浏览器直接访问。它不追求算法炫技考的是你对 CRUD、权限、数据校验、报表导出的综合掌控力。我见过太多人卡在同一个地方不是不会写代码而是不知道一个“能交差、能演示、能讲清楚”的系统边界在哪。体质健康管理系统恰好是个好载体——业务规则清晰身高体重肺活量五十米跑数据关系明确学生-班级-体测批次-指标项又天然带统计和导出需求。选 Java 技术栈不是因为它新而是因为 SpringBoot 把配置、依赖注入、事务这些脏活都收进了 starter 里MySQL 又是最不容易在答辩现场掉链子的关系库。这一篇就按我实际带人做这类系统的顺序把选型、建表、接口、导出、部署和踩坑一次讲透让你照着能跑起来而不是停在“看起来懂了”。2. 技术选型与工程骨架为什么是 SpringBoot 而不是 ServletMySQL 表该怎么切2.1 选型理由B/S 架构下 SpringBoot 省掉的到底是什么先把话说直白如果这个系统用原生 Servlet JSP 写你要自己处理请求分发、参数绑定、连接池、事务边界、JSON 序列化一个体测录入接口能写出两百行样板代码。SpringBoot 的价值不是“框架高级”而是它把这些重复劳动变成了约定。spring-boot-starter-web自带内嵌 Tomcatspring-boot-starter-jdbc或 MyBatis 帮你管连接Transactional一行注解解决体测批次写入时的一致性。B/S 架构在这里的含义是学生和教师只用浏览器不装客户端。这对毕设演示极其友好——答辩老师扫个二维码或输个地址就能看。代价是前端要处理表单校验和分页后端要保证接口幂等。我一般会建议前端用最朴素的 HTML 少量 Vue 或直接 Thymeleaf 服务端渲染别一上来就前后端分离否则光是跨域和 token 就能耗掉你一半时间。MySQL 的选择理由更实际体测数据是典型的结构化表格数据学生、班级、指标、成绩之间是清晰的外键关系用关系库最自然。而且 MySQL 安装配置教程满地都是mysql安装、mysql安装配置教程这类搜索词常年高热说明它的上手门槛低出问题也容易搜到答案。相比之下如果你用 MongoDB 存体测成绩统计“某班肺活量平均值”时聚合管道写起来反而更绕。2.2 工程骨架一个能跑的最小 SpringBoot 目录下面是我常用的最小骨架直接照着建目录即可。注意包名按自己学校要求改这里用com.example.health。health-system/ ├── src/main/java/com/example/health/ │ ├── HealthApplication.java # 启动类 │ ├── controller/ # 接口层 │ ├── service/ # 业务层 │ ├── mapper/ # MyBatis 映射接口 │ └── entity/ # 实体类 ├── src/main/resources/ │ ├── application.yml # 配置 │ ├── mapper/ # XML 映射文件 │ └── static/ # 前端静态页 └── pom.xml启动类就三行核心SpringBootApplication MapperScan(com.example.health.mapper) public class HealthApplication { public static void main(String[] args) { SpringApplication.run(HealthApplication.class, args); } }SpringBootApplication做了三件事开启自动配置、扫描当前包及子包的组件、允许通过代码注册 Bean。MapperScan告诉 MyBatis 去哪里找映射接口少了它启动时会报Invalid bound statement这是新手最常见的翻车点之一。application.yml里数据库连接是重头戏spring: datasource: url: jdbc:mysql://localhost:3306/health_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 10MB mybatis: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: true参数说明serverTimezone必须显式指定否则 MySQL 8 会抛时区异常characterEncodingutf8防止中文姓名乱码map-underscore-to-camel-case让数据库的student_id自动映射到 Java 的studentId省掉大量resultMap配置。max-file-size是为后面导入体测 Excel 预留的。2.3 数据库表怎么切四张核心表撑起整个系统体质健康管理系统的表设计不要贪多四张核心表足够跑通全流程表名作用关键字段student学生基本信息id, student_no, name, class_id, genderclass_info班级信息id, class_name, grade, teacher_idtest_item体测指标定义id, item_name, unit, upper_limit, lower_limittest_record体测成绩记录id, student_id, item_id, value, test_date, statustest_record是核心status字段用来标记“待审核/已通过/驳回”这样教师端审核逻辑就有了落点。test_item里存上下限是为了录入时做范围校验——比如肺活量不可能填 99999这个校验放在后端比放前端可靠。建表时注意student_no加唯一索引test_record上对(student_id, item_id, test_date)建联合索引统计查询会快很多。字符集统一utf8mb4别用utf8否则学生姓名里的生僻字会出问题。3. 核心功能落地体测录入、统计查询与 Excel 导出的完整实现3.1 体测录入接口参数校验和事务边界怎么定录入是最高频的操作也是最容易出脏数据的地方。我的做法是Controller 只做参数接收和返回封装校验和业务判断全放 Service。RestController RequestMapping(/api/record) public class TestRecordController { Autowired private TestRecordService recordService; PostMapping(/submit) public Result submit(RequestBody Valid TestRecordDTO dto) { // Valid 触发 DTO 上的注解校验失败会抛 MethodArgumentNotValidException return recordService.saveRecord(dto); } }DTO 上的校验注解public class TestRecordDTO { NotNull(message 学生ID不能为空) private Long studentId; NotNull(message 指标ID不能为空) private Long itemId; DecimalMin(value 0.0, message 成绩不能为负) private BigDecimal value; PastOrPresent(message 体测日期不能是未来) private LocalDate testDate; }逻辑说明Valid配合NotNull、DecimalMin在进入业务前就拦掉明显非法数据。Service 层再做一次业务校验——查test_item拿到上下限判断value是否在合理区间不在就返回带具体提示的失败结果。这样前端能明确告诉学生“肺活量填写超出合理范围”而不是笼统的“提交失败”。事务边界如果一次提交包含多个指标比如一次体测录入身高、体重、肺活量三项整个方法加Transactional任何一项失败全部回滚。这是保证数据一致性的基本操作别省。3.2 统计查询按班级算平均分和达标率的 SQL 怎么写统计是教师端最看重的功能。需求通常是某班级某次体测各指标的平均值、达标人数、达标率。达标率依赖test_item里的上下限所以 SQL 要关联三张表。SELECT ti.item_name, AVG(tr.value) AS avg_value, SUM(CASE WHEN tr.value BETWEEN ti.lower_limit AND ti.upper_limit THEN 1 ELSE 0 END) AS pass_count, COUNT(*) AS total_count, ROUND(SUM(CASE WHEN tr.value BETWEEN ti.lower_limit AND ti.upper_limit THEN 1 ELSE 0 END) / COUNT(*) * 100, 2) AS pass_rate FROM test_record tr JOIN test_item ti ON tr.item_id ti.id JOIN student s ON tr.student_id s.id WHERE s.class_id #{classId} AND tr.test_date #{testDate} AND tr.status APPROVED GROUP BY ti.id, ti.item_name;参数说明classId和testDate由前端传入status APPROVED保证只统计已审核通过的数据避免教师还没审就出报表。ROUND(..., 2)保留两位小数前端直接展示。这条 SQL 在数据量上万时依然很快前提是前面提到的联合索引建好了。如果要做全校排名把WHERE换成按test_date过滤GROUP BY加上s.class_id外层再套一个ORDER BY avg_value DESC即可。别在 Java 里循环查数据库那是典型的 N1 问题几百个学生就能把接口拖到超时。3.3 Excel 导出用 POI 生成带表头的体测报表导出是答辩加分项也是java poi word能生成图表吗这类搜索词背后的真实需求。POI 生成 Excel 图表比较麻烦但生成带样式的表格非常成熟。下面是一个导出班级体测汇总的写法public void exportClassReport(Long classId, LocalDate testDate, HttpServletResponse response) throws IOException { ListClassReportVO list recordService.getClassReport(classId, testDate); XSSFWorkbook workbook new XSSFWorkbook(); XSSFSheet sheet workbook.createSheet(体测汇总); // 表头 String[] headers {指标名称, 平均成绩, 达标人数, 总人数, 达标率(%)}; XSSFRow headerRow sheet.createRow(0); for (int i 0; i headers.length; i) { headerRow.createCell(i).setCellValue(headers[i]); } // 数据行 int rowIdx 1; for (ClassReportVO vo : list) { XSSFRow row sheet.createRow(rowIdx); row.createCell(0).setCellValue(vo.getItemName()); row.createCell(1).setCellValue(vo.getAvgValue().doubleValue()); row.createCell(2).setCellValue(vo.getPassCount()); row.createCell(3).setCellValue(vo.getTotalCount()); row.createCell(4).setCellValue(vo.getPassRate().doubleValue()); } response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setHeader(Content-Disposition, attachment; filenamereport.xlsx); workbook.write(response.getOutputStream()); workbook.close(); }逻辑说明用XSSFWorkbook支持.xlsx格式createSheet建工作表逐行逐列写入。Content-Disposition告诉浏览器这是下载文件而不是页面跳转。注意workbook.close()必须调用否则文件流不完整下载下来打不开——这个坑我踩过排查了半天才发现是没关流。参数说明ClassReportVO是查询结果的封装类字段和 SQL 的别名对应。如果数据量大用SXSSFWorkbook替代XSSFWorkbook它会把行刷到磁盘内存占用低很多。4. 避坑与排查体质健康管理系统上线前最容易翻车的五件事4.1 中文乱码从数据库到响应全链路排查现象学生姓名在页面上显示成问号或方块。原因通常有三层数据库字符集不是utf8mb4、连接 URL 没带characterEncodingutf8、响应头没设Content-Type: application/json;charsetUTF-8。解决顺序是从底往上查先SHOW CREATE TABLE student确认字符集再检查application.yml的 URL最后在RequestMapping上加produces属性。三层都对了乱码基本消失。4.2 时区异常MySQL 8 的 serverTimezone 必须显式指定现象启动时报The server time zone value ???ú±ê×??±?? is unrecognized。原因是 MySQL 8 驱动不再自动推断时区。解决在 JDBC URL 里加serverTimezoneAsia/Shanghai。别用UTC否则体测日期会差 8 小时统计按日期分组时数据会错位。4.3 连接池耗尽默认配置扛不住并发演示现象答辩时几个人同时点接口开始报HikariPool-1 - Connection is not available。原因是默认连接池最大 10 个连接演示环境多人操作容易打满。解决在application.yml里显式配置spring.datasource.hikari.maximum-pool-size: 20同时检查有没有忘记关流的查询。更隐蔽的原因是某个 Service 方法开了事务但里面做了 HTTP 调用连接被长时间占用。4.4 Excel 导入日期格式错乱POI 的 CellType 判断现象导入体测 Excel 时日期列读出来是数字如44562。原因是 POI 把日期单元格当成数值类型。解决读取前先判断cell.getCellType() CellType.NUMERIC且DateUtil.isCellDateFormatted(cell)是则用cell.getLocalDateTimeCellValue()取值否则按字符串处理。这个判断不写导入功能在答辩现场必翻车。4.5 打包部署后 404静态资源和接口路径的坑现象本地跑得好好的打成 jar 部署到服务器后页面 404。原因通常是前端页面没放进src/main/resources/static或者接口路径带了上下文而前端没加。解决确认静态文件在static目录下SpringBoot 默认会映射如果用了 Nginx 反向代理检查location配置有没有把/api前缀吃掉。部署前先在本地用java -jar跑一遍别直接扔服务器上试。5. 进阶技巧把体质健康管理系统做成能讲出亮点的作品走到这里系统已经能跑通录入、统计、导出、部署。但如果你想让答辩老师多问两句而不是草草翻过得有一两个能展开讲的点。我一般会加两个数据校验的分层设计和统计结果的缓存。分层校验的意思是前端做即时提示比如输入框失焦就校验范围后端做最终把关Service 层查库校验数据库做兜底字段类型和约束。三层各司其职任何一层被绕过后面还有防线。讲的时候可以举例子学生用 Postman 直接调接口跳过前端校验后端依然能拦住这就是分层校验的价值。缓存统计结果更实用。班级体测汇总这种查询同一批数据会被教师反复查看每次查库没必要。用 SpringBoot 自带的Cacheable加在 Service 方法上配合ConcurrentMapCacheManager做本地缓存数据更新时CacheEvict清掉。代码就两行注解Cacheable(value classReport, key #classId _ #testDate) public ListClassReportVO getClassReport(Long classId, LocalDate testDate) { ... } CacheEvict(value classReport, allEntries true) public Result saveRecord(TestRecordDTO dto) { ... }参数说明value是缓存区名字key用 SpEL 拼出唯一标识。CacheEvict在录入新数据时清空缓存保证下次查询拿到最新结果。这个点讲出来说明你不仅会写功能还想过性能。最后一个习惯每次改完代码先本地mvn clean package打 jar用java -jar跑一遍完整流程再提交。我吃过太多次“本地 IDE 能跑、打包就崩”的亏后来养成这个习惯部署翻车率直接降到零。希望帮到你。本文还有配套的精品资源点击获取
Java+SpringBoot+MySQL学生体质健康管理系统毕设实战：从选型到部署
简介本资源为基于Java的学生体质健康管理系统毕业设计资料包含完整论文与项目源码面向计算机相关专业毕业生及需要Java Web实战练习的开发者。系统采用Java语言、SpringBoot框架与MySQL数据库基于B/S模式构建涵盖登录注册、个人中心、学生管理、医生管理、健康知识管理、体测标准管理、班级信息管理、健康档案管理及健康建议管理等模块论文完整呈现绪论、相关技术、系统分析、系统设计、系统实现与系统测试等章节并附数据库概念与逻辑设计、测试用例及结论。资源包共1个docx文件约2.54MB内容为论文与源码整合文档目录结构清晰便于按章节查阅与对照学习。目前已有264人学习下载适合需要完整毕设方案、系统设计思路与功能模块实现参考的读者可帮助快速理解项目架构、数据库表设计与测试流程为毕业设计写作与Java Web项目开发提供实用参考。1. 从一份“学生体质健康管理系统”说起为什么 Java SpringBoot MySQL 依然是毕设最稳的落地组合每年到了毕设季后台被问得最多的一类问题就是“基于 Java 的学生体质健康管理系统到底该怎么落地”问的人里有刚学完 Java 基础、连 SpringBoot 配置文件都还没写利索的新手也有工作两年想补一个完整项目练手的熟手。这个标题看着朴素但它背后其实是一套非常典型的 B/S 架构业务系统学生端录入体测数据、教师端审核与统计、管理端维护班级与指标数据落到 MySQL接口用 SpringBoot 暴露前端浏览器直接访问。它不追求算法炫技考的是你对 CRUD、权限、数据校验、报表导出的综合掌控力。我见过太多人卡在同一个地方不是不会写代码而是不知道一个“能交差、能演示、能讲清楚”的系统边界在哪。体质健康管理系统恰好是个好载体——业务规则清晰身高体重肺活量五十米跑数据关系明确学生-班级-体测批次-指标项又天然带统计和导出需求。选 Java 技术栈不是因为它新而是因为 SpringBoot 把配置、依赖注入、事务这些脏活都收进了 starter 里MySQL 又是最不容易在答辩现场掉链子的关系库。这一篇就按我实际带人做这类系统的顺序把选型、建表、接口、导出、部署和踩坑一次讲透让你照着能跑起来而不是停在“看起来懂了”。2. 技术选型与工程骨架为什么是 SpringBoot 而不是 ServletMySQL 表该怎么切2.1 选型理由B/S 架构下 SpringBoot 省掉的到底是什么先把话说直白如果这个系统用原生 Servlet JSP 写你要自己处理请求分发、参数绑定、连接池、事务边界、JSON 序列化一个体测录入接口能写出两百行样板代码。SpringBoot 的价值不是“框架高级”而是它把这些重复劳动变成了约定。spring-boot-starter-web自带内嵌 Tomcatspring-boot-starter-jdbc或 MyBatis 帮你管连接Transactional一行注解解决体测批次写入时的一致性。B/S 架构在这里的含义是学生和教师只用浏览器不装客户端。这对毕设演示极其友好——答辩老师扫个二维码或输个地址就能看。代价是前端要处理表单校验和分页后端要保证接口幂等。我一般会建议前端用最朴素的 HTML 少量 Vue 或直接 Thymeleaf 服务端渲染别一上来就前后端分离否则光是跨域和 token 就能耗掉你一半时间。MySQL 的选择理由更实际体测数据是典型的结构化表格数据学生、班级、指标、成绩之间是清晰的外键关系用关系库最自然。而且 MySQL 安装配置教程满地都是mysql安装、mysql安装配置教程这类搜索词常年高热说明它的上手门槛低出问题也容易搜到答案。相比之下如果你用 MongoDB 存体测成绩统计“某班肺活量平均值”时聚合管道写起来反而更绕。2.2 工程骨架一个能跑的最小 SpringBoot 目录下面是我常用的最小骨架直接照着建目录即可。注意包名按自己学校要求改这里用com.example.health。health-system/ ├── src/main/java/com/example/health/ │ ├── HealthApplication.java # 启动类 │ ├── controller/ # 接口层 │ ├── service/ # 业务层 │ ├── mapper/ # MyBatis 映射接口 │ └── entity/ # 实体类 ├── src/main/resources/ │ ├── application.yml # 配置 │ ├── mapper/ # XML 映射文件 │ └── static/ # 前端静态页 └── pom.xml启动类就三行核心SpringBootApplication MapperScan(com.example.health.mapper) public class HealthApplication { public static void main(String[] args) { SpringApplication.run(HealthApplication.class, args); } }SpringBootApplication做了三件事开启自动配置、扫描当前包及子包的组件、允许通过代码注册 Bean。MapperScan告诉 MyBatis 去哪里找映射接口少了它启动时会报Invalid bound statement这是新手最常见的翻车点之一。application.yml里数据库连接是重头戏spring: datasource: url: jdbc:mysql://localhost:3306/health_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 10MB mybatis: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: true参数说明serverTimezone必须显式指定否则 MySQL 8 会抛时区异常characterEncodingutf8防止中文姓名乱码map-underscore-to-camel-case让数据库的student_id自动映射到 Java 的studentId省掉大量resultMap配置。max-file-size是为后面导入体测 Excel 预留的。2.3 数据库表怎么切四张核心表撑起整个系统体质健康管理系统的表设计不要贪多四张核心表足够跑通全流程表名作用关键字段student学生基本信息id, student_no, name, class_id, genderclass_info班级信息id, class_name, grade, teacher_idtest_item体测指标定义id, item_name, unit, upper_limit, lower_limittest_record体测成绩记录id, student_id, item_id, value, test_date, statustest_record是核心status字段用来标记“待审核/已通过/驳回”这样教师端审核逻辑就有了落点。test_item里存上下限是为了录入时做范围校验——比如肺活量不可能填 99999这个校验放在后端比放前端可靠。建表时注意student_no加唯一索引test_record上对(student_id, item_id, test_date)建联合索引统计查询会快很多。字符集统一utf8mb4别用utf8否则学生姓名里的生僻字会出问题。3. 核心功能落地体测录入、统计查询与 Excel 导出的完整实现3.1 体测录入接口参数校验和事务边界怎么定录入是最高频的操作也是最容易出脏数据的地方。我的做法是Controller 只做参数接收和返回封装校验和业务判断全放 Service。RestController RequestMapping(/api/record) public class TestRecordController { Autowired private TestRecordService recordService; PostMapping(/submit) public Result submit(RequestBody Valid TestRecordDTO dto) { // Valid 触发 DTO 上的注解校验失败会抛 MethodArgumentNotValidException return recordService.saveRecord(dto); } }DTO 上的校验注解public class TestRecordDTO { NotNull(message 学生ID不能为空) private Long studentId; NotNull(message 指标ID不能为空) private Long itemId; DecimalMin(value 0.0, message 成绩不能为负) private BigDecimal value; PastOrPresent(message 体测日期不能是未来) private LocalDate testDate; }逻辑说明Valid配合NotNull、DecimalMin在进入业务前就拦掉明显非法数据。Service 层再做一次业务校验——查test_item拿到上下限判断value是否在合理区间不在就返回带具体提示的失败结果。这样前端能明确告诉学生“肺活量填写超出合理范围”而不是笼统的“提交失败”。事务边界如果一次提交包含多个指标比如一次体测录入身高、体重、肺活量三项整个方法加Transactional任何一项失败全部回滚。这是保证数据一致性的基本操作别省。3.2 统计查询按班级算平均分和达标率的 SQL 怎么写统计是教师端最看重的功能。需求通常是某班级某次体测各指标的平均值、达标人数、达标率。达标率依赖test_item里的上下限所以 SQL 要关联三张表。SELECT ti.item_name, AVG(tr.value) AS avg_value, SUM(CASE WHEN tr.value BETWEEN ti.lower_limit AND ti.upper_limit THEN 1 ELSE 0 END) AS pass_count, COUNT(*) AS total_count, ROUND(SUM(CASE WHEN tr.value BETWEEN ti.lower_limit AND ti.upper_limit THEN 1 ELSE 0 END) / COUNT(*) * 100, 2) AS pass_rate FROM test_record tr JOIN test_item ti ON tr.item_id ti.id JOIN student s ON tr.student_id s.id WHERE s.class_id #{classId} AND tr.test_date #{testDate} AND tr.status APPROVED GROUP BY ti.id, ti.item_name;参数说明classId和testDate由前端传入status APPROVED保证只统计已审核通过的数据避免教师还没审就出报表。ROUND(..., 2)保留两位小数前端直接展示。这条 SQL 在数据量上万时依然很快前提是前面提到的联合索引建好了。如果要做全校排名把WHERE换成按test_date过滤GROUP BY加上s.class_id外层再套一个ORDER BY avg_value DESC即可。别在 Java 里循环查数据库那是典型的 N1 问题几百个学生就能把接口拖到超时。3.3 Excel 导出用 POI 生成带表头的体测报表导出是答辩加分项也是java poi word能生成图表吗这类搜索词背后的真实需求。POI 生成 Excel 图表比较麻烦但生成带样式的表格非常成熟。下面是一个导出班级体测汇总的写法public void exportClassReport(Long classId, LocalDate testDate, HttpServletResponse response) throws IOException { ListClassReportVO list recordService.getClassReport(classId, testDate); XSSFWorkbook workbook new XSSFWorkbook(); XSSFSheet sheet workbook.createSheet(体测汇总); // 表头 String[] headers {指标名称, 平均成绩, 达标人数, 总人数, 达标率(%)}; XSSFRow headerRow sheet.createRow(0); for (int i 0; i headers.length; i) { headerRow.createCell(i).setCellValue(headers[i]); } // 数据行 int rowIdx 1; for (ClassReportVO vo : list) { XSSFRow row sheet.createRow(rowIdx); row.createCell(0).setCellValue(vo.getItemName()); row.createCell(1).setCellValue(vo.getAvgValue().doubleValue()); row.createCell(2).setCellValue(vo.getPassCount()); row.createCell(3).setCellValue(vo.getTotalCount()); row.createCell(4).setCellValue(vo.getPassRate().doubleValue()); } response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setHeader(Content-Disposition, attachment; filenamereport.xlsx); workbook.write(response.getOutputStream()); workbook.close(); }逻辑说明用XSSFWorkbook支持.xlsx格式createSheet建工作表逐行逐列写入。Content-Disposition告诉浏览器这是下载文件而不是页面跳转。注意workbook.close()必须调用否则文件流不完整下载下来打不开——这个坑我踩过排查了半天才发现是没关流。参数说明ClassReportVO是查询结果的封装类字段和 SQL 的别名对应。如果数据量大用SXSSFWorkbook替代XSSFWorkbook它会把行刷到磁盘内存占用低很多。4. 避坑与排查体质健康管理系统上线前最容易翻车的五件事4.1 中文乱码从数据库到响应全链路排查现象学生姓名在页面上显示成问号或方块。原因通常有三层数据库字符集不是utf8mb4、连接 URL 没带characterEncodingutf8、响应头没设Content-Type: application/json;charsetUTF-8。解决顺序是从底往上查先SHOW CREATE TABLE student确认字符集再检查application.yml的 URL最后在RequestMapping上加produces属性。三层都对了乱码基本消失。4.2 时区异常MySQL 8 的 serverTimezone 必须显式指定现象启动时报The server time zone value ???ú±ê×??±?? is unrecognized。原因是 MySQL 8 驱动不再自动推断时区。解决在 JDBC URL 里加serverTimezoneAsia/Shanghai。别用UTC否则体测日期会差 8 小时统计按日期分组时数据会错位。4.3 连接池耗尽默认配置扛不住并发演示现象答辩时几个人同时点接口开始报HikariPool-1 - Connection is not available。原因是默认连接池最大 10 个连接演示环境多人操作容易打满。解决在application.yml里显式配置spring.datasource.hikari.maximum-pool-size: 20同时检查有没有忘记关流的查询。更隐蔽的原因是某个 Service 方法开了事务但里面做了 HTTP 调用连接被长时间占用。4.4 Excel 导入日期格式错乱POI 的 CellType 判断现象导入体测 Excel 时日期列读出来是数字如44562。原因是 POI 把日期单元格当成数值类型。解决读取前先判断cell.getCellType() CellType.NUMERIC且DateUtil.isCellDateFormatted(cell)是则用cell.getLocalDateTimeCellValue()取值否则按字符串处理。这个判断不写导入功能在答辩现场必翻车。4.5 打包部署后 404静态资源和接口路径的坑现象本地跑得好好的打成 jar 部署到服务器后页面 404。原因通常是前端页面没放进src/main/resources/static或者接口路径带了上下文而前端没加。解决确认静态文件在static目录下SpringBoot 默认会映射如果用了 Nginx 反向代理检查location配置有没有把/api前缀吃掉。部署前先在本地用java -jar跑一遍别直接扔服务器上试。5. 进阶技巧把体质健康管理系统做成能讲出亮点的作品走到这里系统已经能跑通录入、统计、导出、部署。但如果你想让答辩老师多问两句而不是草草翻过得有一两个能展开讲的点。我一般会加两个数据校验的分层设计和统计结果的缓存。分层校验的意思是前端做即时提示比如输入框失焦就校验范围后端做最终把关Service 层查库校验数据库做兜底字段类型和约束。三层各司其职任何一层被绕过后面还有防线。讲的时候可以举例子学生用 Postman 直接调接口跳过前端校验后端依然能拦住这就是分层校验的价值。缓存统计结果更实用。班级体测汇总这种查询同一批数据会被教师反复查看每次查库没必要。用 SpringBoot 自带的Cacheable加在 Service 方法上配合ConcurrentMapCacheManager做本地缓存数据更新时CacheEvict清掉。代码就两行注解Cacheable(value classReport, key #classId _ #testDate) public ListClassReportVO getClassReport(Long classId, LocalDate testDate) { ... } CacheEvict(value classReport, allEntries true) public Result saveRecord(TestRecordDTO dto) { ... }参数说明value是缓存区名字key用 SpEL 拼出唯一标识。CacheEvict在录入新数据时清空缓存保证下次查询拿到最新结果。这个点讲出来说明你不仅会写功能还想过性能。最后一个习惯每次改完代码先本地mvn clean package打 jar用java -jar跑一遍完整流程再提交。我吃过太多次“本地 IDE 能跑、打包就崩”的亏后来养成这个习惯部署翻车率直接降到零。希望帮到你。本文还有配套的精品资源点击获取
)
