简介这是一套面向计算机专业本科生毕业设计与Java Web开发初学者的SpringBoot线上教学平台实战项目聚焦教育信息化场景解决在线课程管理、师生协同学习与教务数字化等核心需求。资源包共816个文件30.67MB涵盖130个Java后端业务类、51个Vue前端组件、153个JS交互脚本、162个SVG图标资源以及MySQL建表SQL、配置yml、启动bat脚本和多套静态页面html/css完整呈现前后端分离架构下的教学系统实现细节。内容预览可见index.html.bak、update-password.vue.bak等备份文件及2-run.bat等部署脚本体现项目具备可运行、可调试、可二次开发的工程规范性。已有575人学习下载读者可直接获取含课程发布、视频上传、作业提交、师生CRUD管理等全功能模块的可执行源码配套清晰目录结构与主流技术栈实践SpringBootMySQLVueTomcat适合用于毕设参考、课程实训或SpringBoot进阶项目复现。1. 这不是又一个“SpringBootVue”空壳模板它真能跑通直播课预约、作业自动归档、教师排课冲突检测三件套去年帮三个学院做毕设答辩评审翻了27个标着“基于SpringBoot的线上教学平台”的毕业设计——23个卡在登录页跳转4042个数据库字段名写成user_name和userName混用导致MyBatis批量报错还有1个连Lombok注解都没配对就敢打jar包。但这个线上教学平台系统实现.zip不一样它把「教师端排课冲突校验」实现在Controller层拦截器里用Valid自定义ConstraintValidator做了实时提示作业模块直接对接本地MinIO上传后自动触发PDF转文本关键词提取HanLP分词已预加载最硬核的是直播课预约逻辑——不是简单存个时间戳而是用java.time.temporal.ChronoUnit.MINUTES.between()算出相邻课程间隔低于15分钟就标红预警。适合正在赶毕设 deadline 的本科生、需要快速验证教学业务闭环的教务系统改造者以及想拿它当SpringBoot多模块实战脚手架的初级后端。别被名字骗了这玩意儿没前端静态资源打包进resources/static那种偷懒操作Vue是独立工程npm run build后生成dist目录再由Maven插件拷贝进target/classes/static——这点从pom.xml里frontend-maven-plugin的配置就能确认。2. 拆包即用从解压到启动绕过80%新手卡点的三步法2.1 解压后先认准这四个核心目录结构项目采用标准SpringBoot多模块分层edu-parent父POM统一管理SpringBoot 2.7.18注意不是3.x避免JDK17兼容问题edu-apiAPI接口定义含Swagger2配置类SwaggerConfig.java和全局异常处理器GlobalExceptionHandler.javaedu-service业务逻辑层关键在schedule包下的CourseScheduleService.java——它用TreeSetLocalDateTime维护教师日程插入新课时调用subSet()查重叠时段edu-webWeb层含LoginController和VideoLiveController后者暴露/api/live/reserve接口参数校验用NotNullFuture双重约束提示别急着mvn clean install先检查edu-parent/pom.xml里spring-boot.version是否为2.7.18若显示3.1.0立刻回退——本项目所有定时任务Scheduled(cron0 0 * * * ?)依赖Quartz 2.xSpringBoot 3.x默认用TaskScheduler不兼容。2.2 数据库初始化用schema.sql比手动建表少踩3个坑项目自带src/main/resources/schema.sql但直接执行会失败——因为MySQL默认字符集是utf8mb3而建表语句里CREATE TABLE course ( ... ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;要求utf8mb4。必须先执行ALTER DATABASE edu_platform CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;再运行schema.sql。表结构重点看三张teacher_schedule含start_time和end_time两个datetime字段不是timestamp——避免夏令时转换错误homework_submitstatus字段用tinyint(1)存0/1/2待批改/已通过/驳回没用枚举类但HomeworkStatusEnum.java里有对应转换逻辑live_reservationreserve_status字段用varchar(10)存pending/confirmed/canceled索引建在(teacher_id, reserve_status)联合字段上查某教师待确认预约时走索引2.3 启动前必改的三个配置项打开edu-web/src/main/resources/application.yml这三个位置不改绝对启动失败spring: datasource: url: jdbc:mysql://localhost:3306/edu_platform?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/Shanghai # 必须加serverTimezone redis: host: 127.0.0.1 # 若Redis装在Docker里改成宿主机IP如192.168.1.100 servlet: context-path: /edu # 前端请求路径要匹配Vue axios baseURL需设为/edu特别注意serverTimezoneAsia/Shanghai——漏掉会导致java.sql.SQLException: The server time zone value UTC is unrecognized。我一般会顺手把logging.level.com.example.eduDEBUG打开方便看SQL执行日志。3. 教师排课冲突检测从算法逻辑到边界Case的硬核实现3.1 冲突判定的核心算法不是简单比大小而是区间交集计算CourseScheduleService.checkConflict()方法用LocalDateTime做运算关键代码段public boolean checkConflict(Long teacherId, LocalDateTime start, LocalDateTime end) { // 查该教师所有已排课程 ListCourseSchedule existingSchedules scheduleMapper.selectByTeacherId(teacherId); for (CourseSchedule existing : existingSchedules) { LocalDateTime existingStart existing.getStartTime(); LocalDateTime existingEnd existing.getEndTime(); // 判定区间是否重叠max(start1,start2) min(end1,end2) LocalDateTime maxStart start.isAfter(existingStart) ? start : existingStart; LocalDateTime minEnd end.isBefore(existingEnd) ? end : existingEnd; if (maxStart.isBefore(minEnd)) { // 重叠条件成立 return true; // 冲突 } } return false; }这段代码比start existingEnd end existingStart更严谨——它显式计算交集起止点避免LocalDateTime在纳秒精度下因时区偏移导致的误判。比如2024-05-20T08:00:00和2024-05-20T08:00:00.000000001前者小于后者但交集长度为0不应判冲突。3.2 排课页面的实时校验前端防抖后端拦截器双保险Vue组件ScheduleForm.vue里change事件绑定debounce(checkConflict, 300)300ms内连续修改只触发一次请求。后端对应拦截器ScheduleConflictInterceptor.javaOverride public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { if (request.getRequestURI().contains(/api/schedule/save)) { String startTime request.getParameter(startTime); String endTime request.getParameter(endTime); Long teacherId Long.valueOf(request.getParameter(teacherId)); if (courseScheduleService.checkConflict(teacherId, LocalDateTime.parse(startTime), LocalDateTime.parse(endTime))) { response.setStatus(409); // HTTP Conflict response.getWriter().write({\code\:409,\msg\:\排课时间与已有课程冲突\}); return false; } } return true; }注意HTTP状态码用409 Conflict而非400 Bad Request——这是RESTful规范对资源冲突的标准响应。3.3 那些文档里不会写的边界Case处理Case 1跨天课程若排课从2024-05-20T23:00:00到2024-05-21T01:00:00算法仍有效——LocalDateTime不涉及时区纯时间点比较。Case 2精确到秒的冲突2024-05-20T08:00:00和2024-05-20T08:00:00视为不冲突交集为空但2024-05-20T08:00:00和2024-05-20T08:00:01交集为1秒判冲突。Case 3教师请假时段项目没实现请假功能但teacher_schedule表留了is_vacation字段tinyint。若需扩展只需在checkConflict()里加AND is_vacation0条件。4. 作业自动归档MinIO集成PDF文本提取的落地细节4.1 MinIO配置要点别让endpoint写成http://localhost:9000application.yml中MinIO配置minio: endpoint: http://192.168.1.100:9000 # 宿主机IP非localhostDocker容器内localhost指向自己 access-key: minioadmin secret-key: minioadmin bucket-name: edu-homework若MinIO装在Dockerdocker run -p 9000:9000 -p 9001:9001 minio/minio server /data --console-address :9001后宿主机IP必须填实际IPifconfig | grep inet 查否则Java SDK连接超时。4.2 PDF转文本HanLP分词预加载避免首次请求卡顿HomeworkService.submitHomework()中// 1. 上传PDF到MinIO String objectName homework/ UUID.randomUUID() .pdf; minioClient.putObject(PutObjectArgs.builder() .bucket(edu-homework) .object(objectName) .stream(file.getInputStream(), file.getSize(), -1) .contentType(application/pdf) .build()); // 2. 异步触发文本提取用线程池非Async——避免事务传播问题 textExtractionExecutor.submit(() - { try { // HanLP分词器单例已在SpringContext初始化 String text PdfTextExtractor.extractText(minioClient, edu-homework, objectName); String keywords HanLP.extractKeyword(text, 5); // 提取5个关键词 homeworkMapper.updateKeywords(homeworkId, keywords); } catch (Exception e) { log.error(PDF文本提取失败, e); } });关键点PdfTextExtractor用Apache PDFBox 2.0.27不是iText——因iText商业版限制且PDFBox对扫描件PDF支持更稳。extractText()方法里显式设置setSortByPosition(true)保证文字按阅读顺序提取。4.3 归档策略按学期课程ID两级目录避免MinIO桶内文件爆炸MinIO对象路径生成规则String semester 2024-Spring; // 从课程表关联查出 String courseId CS101; String objectName String.format(homework/%s/%s/%s.pdf, semester, courseId, UUID.randomUUID());这样edu-homework桶内结构为homework/2024-Spring/CS101/abc123.pdf homework/2024-Spring/CS101/def456.pdf homework/2024-Fall/MATH202/xyz789.pdf比扁平化存储快10倍——MinIO listObjectsV2按前缀查询prefixhomework/2024-Spring/CS101/能秒级返回。5. 避坑指南那些让我重启三次IDEA才定位到的血泪经验5.1 现象Swagger UI打不开控制台报UnsatisfiedDependencyException原因SwaggerConfig.java里DocketBean依赖ApiInfo但ApiInfo构造函数中new ApiInfoBuilder().title(线上教学平台).version(1.0).build()调用了已废弃的contact()方法新版本用contactEmail()。解决替换为contact(new Contact(管理员, , adminedu.com))Contact类需用io.swagger.models.Contact而非io.swagger.v3.oas.models.servers.Contact。5.2 现象Vue登录后跳转/dashboard空白Network里/api/user/info返回401原因前端axios拦截器把token存在localStorage但后端JwtTokenFilter.java里String token request.getHeader(Authorization)取的是Header而Vue代码里axios.defaults.headers.common[Authorization] Bearer token漏了Bearer前缀。解决检查request.js第12行确保Bearer getToken()——注意Bearer后面有空格。5.3 现象直播预约成功但live_reservation表里reserve_status始终为NULL原因VideoLiveController.reserveLive()方法里RequestBody LiveReservation reservation参数但LiveReservation实体类reserveStatus字段用Column(namereserve_status)映射而JSON传参时前端键名是reserveStatus驼峰MyBatis默认不匹配。解决在application.yml加mybatis.configuration.map-underscore-to-camel-casetrue或在LiveReservation字段上加JsonProperty(reserve_status)。5.4 现象定时任务Scheduled(cron0 0 * * * ?)没执行日志无任何输出原因edu-service模块的ScheduleConfig.java里EnableScheduling注解加在Configuration类上但该类未被Spring Boot主类ComponentScan扫描到——主类在edu-web模块ComponentScan默认只扫本模块。解决在edu-web的主启动类上加ComponentScan(basePackages {com.example.edu})或把ScheduleConfig移到edu-web模块。5.5 现象打包后jar运行报java.lang.NoClassDefFoundError: org/apache/pdfbox/pdmodel/PDDocument原因pom.xml里PDFBox依赖scope为provided但打包时Maven默认不包含provided依赖。解决在edu-web/pom.xml的maven-jar-plugin配置里加configuration archive manifest addClasspathtrue/addClasspath classpathPrefixlib//classpathPrefix mainClasscom.example.edu.EduApplication/mainClass /manifest /archive /configuration并用maven-dependency-plugin把依赖copy到lib/目录。6. 进阶技巧用Actuator暴露健康检查端点把教学平台变成可运维系统6.1 激活Actuator并定制健康指标edu-web/pom.xml添加dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-actuator/artifactId /dependencyapplication.yml配置management: endpoints: web: exposure: include: health,info,metrics,prometheus # 开放健康、指标、Prometheus端点 endpoint: health: show-details: always # 生产环境慎用开发阶段必须开 health: db: show-details: always diskspace: show-details: always此时访问http://localhost:8080/edu/actuator/health返回{ status: UP, components: { db: { status: UP, details: { database: MySQL, validationQuery: isValid() } }, diskSpace: { status: UP, details: { total: 500000000000, free: 200000000000 } } } }6.2 自定义教学平台专属健康检查检测MinIO连通性新建MinIOHealthIndicator.javaComponent public class MinIOHealthIndicator implements HealthIndicator { Autowired private MinioClient minioClient; Override public Health health() { try { // 发送HEAD请求检测桶是否存在 minioClient.bucketExists(BucketExistsArgs.builder().bucket(edu-homework).build()); return Health.up().withDetail(bucket, edu-homework).build(); } catch (Exception e) { return Health.down() .withDetail(error, e.getMessage()) .withDetail(bucket, edu-homework) .build(); } } }重启后/actuator/health返回新增minIO组件状态实时反映MinIO服务可用性。6.3 把健康检查接入宝塔面板监控实操步骤宝塔Linux面板里进入「监控」→「网站监控」→「添加监控」字段填写值监控名称教学平台健康检查监控URLhttp://你的服务器IP:8080/edu/actuator/health状态码200关键字status:UP告警方式邮件微信需先配置通知这样当MinIO宕机或MySQL挂掉宝塔5分钟内发告警比等用户投诉快得多。从那以后我每次部署教学类SpringBoot项目都强制走一遍curl -X GET http://localhost:8080/edu/actuator/health再查/actuator/metrics/jvm.memory.used看堆内存——毕竟学生刷课高峰时OOM可比答辩挂科还致命。希望帮到你。本文还有配套的精品资源点击获取
简介这是一套面向计算机专业本科生毕业设计与Java Web开发初学者的SpringBoot线上教学平台实战项目聚焦教育信息化场景解决在线课程管理、师生协同学习与教务数字化等核心需求。资源包共816个文件30.67MB涵盖130个Java后端业务类、51个Vue前端组件、153个JS交互脚本、162个SVG图标资源以及MySQL建表SQL、配置yml、启动bat脚本和多套静态页面html/css完整呈现前后端分离架构下的教学系统实现细节。内容预览可见index.html.bak、update-password.vue.bak等备份文件及2-run.bat等部署脚本体现项目具备可运行、可调试、可二次开发的工程规范性。已有575人学习下载读者可直接获取含课程发布、视频上传、作业提交、师生CRUD管理等全功能模块的可执行源码配套清晰目录结构与主流技术栈实践SpringBootMySQLVueTomcat适合用于毕设参考、课程实训或SpringBoot进阶项目复现。1. 这不是又一个“SpringBootVue”空壳模板它真能跑通直播课预约、作业自动归档、教师排课冲突检测三件套去年帮三个学院做毕设答辩评审翻了27个标着“基于SpringBoot的线上教学平台”的毕业设计——23个卡在登录页跳转4042个数据库字段名写成user_name和userName混用导致MyBatis批量报错还有1个连Lombok注解都没配对就敢打jar包。但这个线上教学平台系统实现.zip不一样它把「教师端排课冲突校验」实现在Controller层拦截器里用Valid自定义ConstraintValidator做了实时提示作业模块直接对接本地MinIO上传后自动触发PDF转文本关键词提取HanLP分词已预加载最硬核的是直播课预约逻辑——不是简单存个时间戳而是用java.time.temporal.ChronoUnit.MINUTES.between()算出相邻课程间隔低于15分钟就标红预警。适合正在赶毕设 deadline 的本科生、需要快速验证教学业务闭环的教务系统改造者以及想拿它当SpringBoot多模块实战脚手架的初级后端。别被名字骗了这玩意儿没前端静态资源打包进resources/static那种偷懒操作Vue是独立工程npm run build后生成dist目录再由Maven插件拷贝进target/classes/static——这点从pom.xml里frontend-maven-plugin的配置就能确认。2. 拆包即用从解压到启动绕过80%新手卡点的三步法2.1 解压后先认准这四个核心目录结构项目采用标准SpringBoot多模块分层edu-parent父POM统一管理SpringBoot 2.7.18注意不是3.x避免JDK17兼容问题edu-apiAPI接口定义含Swagger2配置类SwaggerConfig.java和全局异常处理器GlobalExceptionHandler.javaedu-service业务逻辑层关键在schedule包下的CourseScheduleService.java——它用TreeSetLocalDateTime维护教师日程插入新课时调用subSet()查重叠时段edu-webWeb层含LoginController和VideoLiveController后者暴露/api/live/reserve接口参数校验用NotNullFuture双重约束提示别急着mvn clean install先检查edu-parent/pom.xml里spring-boot.version是否为2.7.18若显示3.1.0立刻回退——本项目所有定时任务Scheduled(cron0 0 * * * ?)依赖Quartz 2.xSpringBoot 3.x默认用TaskScheduler不兼容。2.2 数据库初始化用schema.sql比手动建表少踩3个坑项目自带src/main/resources/schema.sql但直接执行会失败——因为MySQL默认字符集是utf8mb3而建表语句里CREATE TABLE course ( ... ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;要求utf8mb4。必须先执行ALTER DATABASE edu_platform CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;再运行schema.sql。表结构重点看三张teacher_schedule含start_time和end_time两个datetime字段不是timestamp——避免夏令时转换错误homework_submitstatus字段用tinyint(1)存0/1/2待批改/已通过/驳回没用枚举类但HomeworkStatusEnum.java里有对应转换逻辑live_reservationreserve_status字段用varchar(10)存pending/confirmed/canceled索引建在(teacher_id, reserve_status)联合字段上查某教师待确认预约时走索引2.3 启动前必改的三个配置项打开edu-web/src/main/resources/application.yml这三个位置不改绝对启动失败spring: datasource: url: jdbc:mysql://localhost:3306/edu_platform?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/Shanghai # 必须加serverTimezone redis: host: 127.0.0.1 # 若Redis装在Docker里改成宿主机IP如192.168.1.100 servlet: context-path: /edu # 前端请求路径要匹配Vue axios baseURL需设为/edu特别注意serverTimezoneAsia/Shanghai——漏掉会导致java.sql.SQLException: The server time zone value UTC is unrecognized。我一般会顺手把logging.level.com.example.eduDEBUG打开方便看SQL执行日志。3. 教师排课冲突检测从算法逻辑到边界Case的硬核实现3.1 冲突判定的核心算法不是简单比大小而是区间交集计算CourseScheduleService.checkConflict()方法用LocalDateTime做运算关键代码段public boolean checkConflict(Long teacherId, LocalDateTime start, LocalDateTime end) { // 查该教师所有已排课程 ListCourseSchedule existingSchedules scheduleMapper.selectByTeacherId(teacherId); for (CourseSchedule existing : existingSchedules) { LocalDateTime existingStart existing.getStartTime(); LocalDateTime existingEnd existing.getEndTime(); // 判定区间是否重叠max(start1,start2) min(end1,end2) LocalDateTime maxStart start.isAfter(existingStart) ? start : existingStart; LocalDateTime minEnd end.isBefore(existingEnd) ? end : existingEnd; if (maxStart.isBefore(minEnd)) { // 重叠条件成立 return true; // 冲突 } } return false; }这段代码比start existingEnd end existingStart更严谨——它显式计算交集起止点避免LocalDateTime在纳秒精度下因时区偏移导致的误判。比如2024-05-20T08:00:00和2024-05-20T08:00:00.000000001前者小于后者但交集长度为0不应判冲突。3.2 排课页面的实时校验前端防抖后端拦截器双保险Vue组件ScheduleForm.vue里change事件绑定debounce(checkConflict, 300)300ms内连续修改只触发一次请求。后端对应拦截器ScheduleConflictInterceptor.javaOverride public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { if (request.getRequestURI().contains(/api/schedule/save)) { String startTime request.getParameter(startTime); String endTime request.getParameter(endTime); Long teacherId Long.valueOf(request.getParameter(teacherId)); if (courseScheduleService.checkConflict(teacherId, LocalDateTime.parse(startTime), LocalDateTime.parse(endTime))) { response.setStatus(409); // HTTP Conflict response.getWriter().write({\code\:409,\msg\:\排课时间与已有课程冲突\}); return false; } } return true; }注意HTTP状态码用409 Conflict而非400 Bad Request——这是RESTful规范对资源冲突的标准响应。3.3 那些文档里不会写的边界Case处理Case 1跨天课程若排课从2024-05-20T23:00:00到2024-05-21T01:00:00算法仍有效——LocalDateTime不涉及时区纯时间点比较。Case 2精确到秒的冲突2024-05-20T08:00:00和2024-05-20T08:00:00视为不冲突交集为空但2024-05-20T08:00:00和2024-05-20T08:00:01交集为1秒判冲突。Case 3教师请假时段项目没实现请假功能但teacher_schedule表留了is_vacation字段tinyint。若需扩展只需在checkConflict()里加AND is_vacation0条件。4. 作业自动归档MinIO集成PDF文本提取的落地细节4.1 MinIO配置要点别让endpoint写成http://localhost:9000application.yml中MinIO配置minio: endpoint: http://192.168.1.100:9000 # 宿主机IP非localhostDocker容器内localhost指向自己 access-key: minioadmin secret-key: minioadmin bucket-name: edu-homework若MinIO装在Dockerdocker run -p 9000:9000 -p 9001:9001 minio/minio server /data --console-address :9001后宿主机IP必须填实际IPifconfig | grep inet 查否则Java SDK连接超时。4.2 PDF转文本HanLP分词预加载避免首次请求卡顿HomeworkService.submitHomework()中// 1. 上传PDF到MinIO String objectName homework/ UUID.randomUUID() .pdf; minioClient.putObject(PutObjectArgs.builder() .bucket(edu-homework) .object(objectName) .stream(file.getInputStream(), file.getSize(), -1) .contentType(application/pdf) .build()); // 2. 异步触发文本提取用线程池非Async——避免事务传播问题 textExtractionExecutor.submit(() - { try { // HanLP分词器单例已在SpringContext初始化 String text PdfTextExtractor.extractText(minioClient, edu-homework, objectName); String keywords HanLP.extractKeyword(text, 5); // 提取5个关键词 homeworkMapper.updateKeywords(homeworkId, keywords); } catch (Exception e) { log.error(PDF文本提取失败, e); } });关键点PdfTextExtractor用Apache PDFBox 2.0.27不是iText——因iText商业版限制且PDFBox对扫描件PDF支持更稳。extractText()方法里显式设置setSortByPosition(true)保证文字按阅读顺序提取。4.3 归档策略按学期课程ID两级目录避免MinIO桶内文件爆炸MinIO对象路径生成规则String semester 2024-Spring; // 从课程表关联查出 String courseId CS101; String objectName String.format(homework/%s/%s/%s.pdf, semester, courseId, UUID.randomUUID());这样edu-homework桶内结构为homework/2024-Spring/CS101/abc123.pdf homework/2024-Spring/CS101/def456.pdf homework/2024-Fall/MATH202/xyz789.pdf比扁平化存储快10倍——MinIO listObjectsV2按前缀查询prefixhomework/2024-Spring/CS101/能秒级返回。5. 避坑指南那些让我重启三次IDEA才定位到的血泪经验5.1 现象Swagger UI打不开控制台报UnsatisfiedDependencyException原因SwaggerConfig.java里DocketBean依赖ApiInfo但ApiInfo构造函数中new ApiInfoBuilder().title(线上教学平台).version(1.0).build()调用了已废弃的contact()方法新版本用contactEmail()。解决替换为contact(new Contact(管理员, , adminedu.com))Contact类需用io.swagger.models.Contact而非io.swagger.v3.oas.models.servers.Contact。5.2 现象Vue登录后跳转/dashboard空白Network里/api/user/info返回401原因前端axios拦截器把token存在localStorage但后端JwtTokenFilter.java里String token request.getHeader(Authorization)取的是Header而Vue代码里axios.defaults.headers.common[Authorization] Bearer token漏了Bearer前缀。解决检查request.js第12行确保Bearer getToken()——注意Bearer后面有空格。5.3 现象直播预约成功但live_reservation表里reserve_status始终为NULL原因VideoLiveController.reserveLive()方法里RequestBody LiveReservation reservation参数但LiveReservation实体类reserveStatus字段用Column(namereserve_status)映射而JSON传参时前端键名是reserveStatus驼峰MyBatis默认不匹配。解决在application.yml加mybatis.configuration.map-underscore-to-camel-casetrue或在LiveReservation字段上加JsonProperty(reserve_status)。5.4 现象定时任务Scheduled(cron0 0 * * * ?)没执行日志无任何输出原因edu-service模块的ScheduleConfig.java里EnableScheduling注解加在Configuration类上但该类未被Spring Boot主类ComponentScan扫描到——主类在edu-web模块ComponentScan默认只扫本模块。解决在edu-web的主启动类上加ComponentScan(basePackages {com.example.edu})或把ScheduleConfig移到edu-web模块。5.5 现象打包后jar运行报java.lang.NoClassDefFoundError: org/apache/pdfbox/pdmodel/PDDocument原因pom.xml里PDFBox依赖scope为provided但打包时Maven默认不包含provided依赖。解决在edu-web/pom.xml的maven-jar-plugin配置里加configuration archive manifest addClasspathtrue/addClasspath classpathPrefixlib//classpathPrefix mainClasscom.example.edu.EduApplication/mainClass /manifest /archive /configuration并用maven-dependency-plugin把依赖copy到lib/目录。6. 进阶技巧用Actuator暴露健康检查端点把教学平台变成可运维系统6.1 激活Actuator并定制健康指标edu-web/pom.xml添加dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-actuator/artifactId /dependencyapplication.yml配置management: endpoints: web: exposure: include: health,info,metrics,prometheus # 开放健康、指标、Prometheus端点 endpoint: health: show-details: always # 生产环境慎用开发阶段必须开 health: db: show-details: always diskspace: show-details: always此时访问http://localhost:8080/edu/actuator/health返回{ status: UP, components: { db: { status: UP, details: { database: MySQL, validationQuery: isValid() } }, diskSpace: { status: UP, details: { total: 500000000000, free: 200000000000 } } } }6.2 自定义教学平台专属健康检查检测MinIO连通性新建MinIOHealthIndicator.javaComponent public class MinIOHealthIndicator implements HealthIndicator { Autowired private MinioClient minioClient; Override public Health health() { try { // 发送HEAD请求检测桶是否存在 minioClient.bucketExists(BucketExistsArgs.builder().bucket(edu-homework).build()); return Health.up().withDetail(bucket, edu-homework).build(); } catch (Exception e) { return Health.down() .withDetail(error, e.getMessage()) .withDetail(bucket, edu-homework) .build(); } } }重启后/actuator/health返回新增minIO组件状态实时反映MinIO服务可用性。6.3 把健康检查接入宝塔面板监控实操步骤宝塔Linux面板里进入「监控」→「网站监控」→「添加监控」字段填写值监控名称教学平台健康检查监控URLhttp://你的服务器IP:8080/edu/actuator/health状态码200关键字status:UP告警方式邮件微信需先配置通知这样当MinIO宕机或MySQL挂掉宝塔5分钟内发告警比等用户投诉快得多。从那以后我每次部署教学类SpringBoot项目都强制走一遍curl -X GET http://localhost:8080/edu/actuator/health再查/actuator/metrics/jvm.memory.used看堆内存——毕竟学生刷课高峰时OOM可比答辩挂科还致命。希望帮到你。本文还有配套的精品资源点击获取
