1. 毕设选题与整体架构拆解

1.1 在线教学平台到底做什么：从需求拿捏项目形态

“基于 SpringBoot 的在线教学平台”这类题目在计算机毕业设计里属于出镜率极高的类型，但大家拿到的原始需求往往只有一句话：做一个支持课程管理、教学资源上传下载、学生选课、在线作业的网站。如果你直接照着这个列表去写代码，最后大概率会得到一个“CRUD 全家桶”——所有模块都有，但没有一个能用得像样。

我带的往届学生里，有人把这类题目做成了仿慕课网的视频站，有人做成了带直播间的“伪智慧课堂”，还有人做成了在线考试系统。同一个标题，落地形态天差地别。原因在于“网络教学系统”“智慧课堂系统”这些词本身是宽泛的，毕设阶段真正要做的是把题目拆成三个维度：

第一，角色体系。必须想清楚系统里有几种人。最基础的是学生、教师、管理员三套角色。要是题目里带了“智慧课堂”三个字，建议再拆出一个“课堂”概念，把课程、班级、签到、随堂提问、作业发布都挂在课堂下面，这样系统结构会比单纯的“课程管理”更立体。

第二，核心业务闭环。好的教学系统不是功能越多越好，而是能跑通一条完整链路。比如教师建课→发布教学资源→布置作业→发起课堂签到→学生参与→系统自动统计成绩，这条链路走通，论文里的业务流程图、时序图、用例图就全有了素材。

第三，教学设计的体现。如果这是“网络教学系统的教学设计与应用”，那么你在论文里必须回答一个问题：这个平台是怎么支撑教学活动的？也就是说，不能只有文件上传下载，还得有教学环节的承载。签到、答题、讨论、作业批改、学习进度跟踪，这些才是“教学设计”的好抓手。

1.2 技术栈选型：为什么是 SpringBoot 而不是 SSM 或 SpringCloud

很多同学选型时有个误区：以为毕设一定要用最新最重的东西。题目里写了 SpringBoot，就老老实实用 SpringBoot，别一上来就上 SpringCloud 微服务。微服务确实炫，但教学平台的业务体量根本不需要拆服务，硬拆只会让自己陷入分布式事务、服务发现的泥潭，答辩时还容易被老师问住。

选 SpringBoot 的理由其实很实在。它内置 Tomcat，能独立打成 jar 包运行，省掉了传统 SSM 项目里繁琐的 XML 配置。它对数据库、Redis、消息队列、WebSocket 都有非常成熟的 Starter 集成，写代码的时间能省下一半。更关键的是，SpringBoot 在招聘市场和毕设评审中的认可度极高，网上能查到的资料也非常多，遇到问题基本都能搜到答案。

如果项目想做得有区分度，可以适度引入两个组件：SpringBoot 自动配置机制的理解，以及 Spring Security 或 Sa-Token 做登录鉴权。这两块在面试和答辩里都是加分项，代码量却不会增加太多。

1.3 前后端分离还是整包部署：毕设场景下的取舍

现在的前端生态里，Vue 已经快成了毕设标配。于是出现了一个经典问题：后端 SpringBoot 和前端 Vue 前后端分离，最后怎么给老师演示。

前后端分离确实更贴近企业真实开发，但也会带来两个麻烦。第一，答辩现场的演示环境往往网络受限，前端 dev server 和后端服务都要起，容器端口、跨域问题全是隐患。第二，老师如果不懂前端工程化，看你在终端里敲 npm run dev 会觉得你在“变魔术”。

我个人的建议是：开发阶段老老实实做前后端分离，Vue 用代理转发请求到 SpringBoot，提升开发效率。最终打包阶段，把 Vue 构建好的静态文件放进 SpringBoot 的src/main/resources/static目录，让后端一个 jar 包同时承载接口和前端页面。这样演示时只需启动一个服务，稳定又直观。后面我会专门讲这个打包细节。

2. SpringBoot 关键机制与业务设计

2.1 自动配置与 Starter：项目里“看不见”的魔法

SpringBoot 最核心的设计思想是“约定优于配置”，体现形式就是自动配置和 Starter。很多同学写了半年 SpringBoot，却说不出spring-boot-starter-web里到底发生了什么，这个问题答辩时被问到的概率非常高。

简单讲，Starter 是一个聚合依赖。spring-boot-starter-web里打包了 Spring MVC、Jackson、Tomcat、Validation 等一整套 Web 开发需要的库。当你把它加进 pom.xml，SpringBoot 的自动配置类就开始干活了：框架会扫描 classpath 下存在的类，如果发现DispatcherServlet，就自动配置 Spring MVC；如果发现HikariCP依赖，就自动配置数据源。你可以打开META-INF/spring.factories或AutoConfiguration.imports文件，能在这里面看到所有自动配置类的名称。

这里有一个很实际的调试技巧：服务启动时，加一个启动参数--debug，SpringBoot 会在控制台打印自动配置报告，列出哪些配置生效了、哪些没生效。我排查“接口莫名 404”“配置没生效”这类问题时，第一件事就是看这份报告。

顺便说一句和热词相关的点：SpringBoot 2.x 之后，Spring 官方将 CGLIB 动态代理改为了默认的代理方式。也就是说即使你的 Service 类实现了接口，默认也不再走 JDK 动态代理，而是用 CGLIB 生成子类代理。这个细节在面试题里出现过无数次，毕设里如果遇到“注入的 bean 类型不对”或者“事务注解失效”，大概率就和代理方式有关。

2.2 分层结构与核心实体：从课程表到选课表的设计思路

在线教学平台的后端分层建议直接采用经典的四层结构：Controller 负责接收参数和返回结果，Service 写业务逻辑，Mapper 操作数据库，Entity 映射表结构。不要在这个基础上过度设计，加什么 DTO/VO/Query 对象一堆，毕设阶段只会增加自己维护成本。

数据库设计上，系统至少要包含这几类核心表：

用户表（user）：用户 ID、用户名、密码、姓名、角色（学生/教师/管理员）、头像、创建时间。

课程表（course）：课程 ID、课程名称、课程简介、封面图、教师 ID、创建时间。这是一张基础信息表，业务上的“开课”动作不应该直接改这张表，而应该单独建开课记录。

课堂表（class_session）：课堂 ID、课程 ID、教师 ID、上课时间、课堂主题、签到码、直播链接。这张表是智慧课堂的核心，在线点名、随堂提问、弹题都挂在它下面。

选课表（course_selection）：选课 ID、学生 ID、课程 ID、选课时间、课程成绩。这张表是典型的中间表，用于维护学生和课程的多对多关系。

资源表（resource）：资源 ID、课程 ID、资源名称、文件类型、文件大小、存储路径、上传时间。教务资源管理模块主要就是围绕它展开。

作业表（assignment）和作业提交表（assignment_submit）：作业基本信息放一张表，学生提交的答案和批改结果放另一张表，这样一对多的关系才清晰。

设计时有三个原则必须守住：第一，所有表都加create_time和update_time两个字段，后面做统计和排错非常有用。第二，外键约束在毕设项目里能不用就不用，用逻辑外键，否则数据删除时会被外键卡住。第三，状态字段用整型，比如 0 表示未提交、1 表示已提交、2 表示已批改，可读性交给代码注释。

2.3 一个典型业务闭环：教师发布课程、学生选课、系统生成任务

为了让思路更具体，我拿“教师发布课程”这个场景走一遍完整流程，你会发现后面写代码时脑子里会非常清晰。

教师登录后，在课程管理页面点击“新建课程”，填写课程名、简介、封面，提交到POST /api/course。Controller 接收到请求后，从登录态里取出当前用户 ID，Service 层把课程信息写入 course 表，同时自动在 class_session 表里生成第一节课堂记录。这一步是多数人容易漏的：如果你不在建课时自动生成课堂记录，后面点系统里的“进入课堂”按钮就会发现没有数据。

学生端看到的课程列表来自课程表和选课表的联合查询。学生点击“选课”，Service 层先检查选课表里是否已经存在记录，避免重复选课，然后写入一条选课记录。如果课程设置了选课人数上限，选课前还要 count 一下，超过上限就抛出业务异常，提示“课程已满”。

选课成功后，系统可以触发两个后续动作：给学生生成一条待办通知，给教师生成一条“XX 学生选课成功”的站内消息。这两个动作在毕设里可以直接同步写，但如果你想展示一下 SpringBoot 整合消息队列的能力，可以把通知发送放到 ActiveMQ 或者 RocketMQ 里，做成异步消息。这个点写进论文里就非常漂亮，因为它体现的不只是“会调用接口”，而是理解了解耦。

3. 实操环节：从零搭一个可运行的在线教学平台

3.1 项目初始化：Spring Initializr 该选哪些依赖

我建议直接用 IDEA 内置的 Spring Initializr 创建项目，比去网页端生成再导入多一步操作都省时间。起始页选择 Spring Boot 版本时注意一个原则：如果你本地 JDK 是 8，务必选 2.7.x；如果是 17 或更高，再选 3.x。热词里有一条就是“springboot版本太高”导致的启动问题，大多就是 JDK 版本和 SpringBoot 版本不匹配。

依赖方面我推荐这样选：

• Spring Web：提供 MVC 框架和内置 Tomcat
• Spring Data JPA 或 MyBatis Framework：持久层框架二选一。教学系统这种多表关联比较多的场景，我建议用 MyBatis-Plus 而不是原生 MyBatis，因为它的条件构造器和分页插件能让代码量下降一半
• MySQL Driver：数据库驱动
• Lombok：减少实体类 getter/setter 代码
• Spring Boot DevTools：热部署工具，改了代码自动重启
• Validation：参数校验
• Spring Security 或 Sa-Token：登录鉴权

有几个依赖是后面再加的，别一开始全勾上：WebSocket 相关的spring-boot-starter-websocket、Redis 相关的spring-boot-starter-data-redis、文件上传用的阿里云 OSS SDK 或者本地存储依赖。保持最小可用，先跑通再扩展，这才是正确顺序。

3.2 application.yml 配置实操：这些配置项必须写对

新建项目后第一件事不是写代码，而是把 resources 目录下的 application.properties 改成 application.yml，然后配置数据源。下面这份配置是我的常用模板，注释部分大家可以保留。

server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/teaching_system?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT+8 servlet: multipart: max-file-size: 100MB max-request-size: 200MB mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0

这份配置里藏着三个经典坑。第一，serverTimezone=Asia/Shanghai必须加，MySQL 8 默认时区和 JVM 时区不一致，不加你在代码里查询出来的时间会慢 8 小时。第二，allowPublicKeyRetrieval=true不能漏，新版 MySQL 驱动用 caching_sha2_password 加密方式时，不加这个会报 Public Key Retrieval is not allowed 的错误。第三，max-file-size必须显式设置，因为 SpringBoot 默认上传限制才 1MB，教学资源动辄几十兆视频，不调大上传必然报错。

配置好之后启动一次，控制台出现Tomcat started on port(s): 8080就说明环境没问题了。这时候把log-impl打开，还能看到框架自动执行的所有 SQL 语句，对后面调试非常有帮助。

3.3 核心代码示范：JWT 登录拦截器与自定义注解

在线教学平台必须解决“怎么知道当前登录的人是谁”这个问题。我不用 Spring Security 做完整方案，而是用 Sa-Token 或手写 JWT 拦截器，手写一遍反而更能讲清楚原理。下面这套方案是基于拦截器加 JWT 的思路，代码量小，理解起来也直观。

首先定义一个@CurrentUser注解：

@Target(ElementType.PARAMETER) @Retention(RetentionPolicy.RUNTIME) public @interface CurrentUser { }

然后在拦截器里解析 Token 并放入请求域：

@Component public class LoginInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (handler instanceof HandlerMethod) { String token = request.getHeader("Authorization"); // 这里调用 JwtUtil 验证 token，如果失效返回 401 Long userId = JwtUtil.parseToken(token); request.setAttribute("userId", userId); } return true; } }

最后写一个参数解析器，让 Controller 的方法签名里直接通过@CurrentUser Long userId拿到当前用户：

@Component public class CurrentUserArgumentResolver implements HandlerMethodArgumentResolver { @Override public boolean supportsParameter(MethodParameter parameter) { return parameter.hasParameterAnnotation(CurrentUser.class); } @Override public Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer, NativeWebRequest webRequest, WebDataBinderFactory binderFactory) { HttpServletRequest request = webRequest.getNativeRequest(HttpServletRequest.class); return request.getAttribute("userId"); } }

这三个类配合起来，业务代码里就不再需要到处写“从 session 取用户”的逻辑，Controller 变得更加干净。答辩时老师问“你怎么保证接口安全”，你就把这三个类讲一遍，从 Token 签发、拦截校验到参数注入，链路是完整的。

3.4 智慧课堂亮点：WebSocket 实时点名与随堂弹题

“智慧课堂”四个字里最有技术含量、也最适合当论文创新点的功能，是 WebSocket 实时互动。传统的 HTTP 请求是“一问一答”，学生端要不停刷新才能看到老师有没有发起签到。用 WebSocket 就能实现服务端主动推送：老师一点“发起签到”，所有在场学生的页面立刻弹出签到框。

SpringBoot 整合 WebSocket 其实并不复杂。先引入依赖，再写一个配置类实现WebSocketConfigurer：

@Configuration @EnableWebSocket public class WebSocketConfig implements WebSocketConfigurer { @Override public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) { registry.addHandler(new ClassSessionHandler(), "/ws/class") .setAllowedOrigins("*"); } }

这里的ClassSessionHandler继承TextWebSocketHandler，在afterConnectionEstablished方法里把当前连接的用户 ID 存到一个 ConcurrentHashMap，收到老师端的“SIGN_IN”消息后，遍历在线学生连接并推送签到通知。学生点击“签到”后，消息再往回传，服务端记录签到时间和签到状态。整个交互走的是事件驱动的思路，数据最终落到数据库。

这个功能做完之后，论文里能讲的东西就很多了：WebSocket 连接管理、心跳保活、消息协议设计、并发安全问题。论文里只要写一节“基于 WebSocket 的实时课堂互动模块设计”，评审印象分就上去了。

3.5 将 Vue 打包放进 SpringBoot：统一的部署方案

开发完成后，最关键的部署环节来了。这套方案我实测过很多次，流程稳定可靠。

第一步，在 Vue 项目根目录执行：

npm run build

构建成功后，dist 目录里会有 index.html、static 文件夹等静态资源文件。

第二步，把 dist 里的所有内容复制到 SpringBoot 项目的src/main/resources/static目录下。index.html 放 static 根目录，其它静态资源按原样放进去。

第三步，用 Maven 重新打包：

mvn clean package -Dmaven.test.skip=true

启动生成的 jar 包：

java -jar teaching-system-0.0.1-SNAPSHOT.jar

然后在浏览器访问http://localhost:8080，出现 Vue 的页面，就说明前后端已经合体了。

需要注意三个细节。第一，Vue 路由模式尽量用 hash 模式，用 history 模式时刷新页面会出现 404，因为后端没有配置对应的路由转发。第二，如果前端代码里有代理配置，打包后必须改为直接调后端以/api开头的路径，不能带 localhost:3000 之类的地址。第三，接口若包含文件上传，前端请求的baseURL要写相对路径，比如/api，这样打包后不需要再改任何地址。

4. 常见问题与避坑实录

4.1 Java 版本与 SpringBoot 版本不匹配：启动失败的头号原因

从热词里能看到很多人在搜“springboot版本太高”“java启动失败怎么解决”，这类问题在毕设群里几乎天天出现。最典型的现象是项目启动时报：

Unsupported class file major version 61

含义是 JVM 不认识 class 文件版本。major version 61 对应 Java 17，而你当前运行环境是 Java 8，当然不认识。反过来，SpringBoot 2.x 用的 Java 8 字节码，放到 Java 17 里跑也有问题，只是报错形式不一样。

处理原则如下：如果你用 SpringBoot 3.x，JDK 必须 17+；如果你用 SpringBoot 2.7.x，JDK 8 和 11 都可以。另外还要看 IDEA 里的 Project Structure、Maven Settings、命令行 java 版本是不是同一个，三处版本不一致也会导致编译通过但运行崩溃。我见过太多人只改了 Project SDK，忘记改 Maven 使用的 JDK，结果一直报错。

4.2 IDEA 中配置 SpringBoot 启动端口与热部署

热词里有人问“IDEA 2026 怎么配置 springboot 服务编辑配置数据比如启动端口”，这其实是运行配置的修改入口。打开 Run 面板，选择你的 Application 启动类，点击 Edit Configurations，在 VM options 里输入：

-Dserver.port=8081

或者简单点，直接修改 application.yml 里的server.port，重启即可。

热部署的设置则分两步：第一步，pom.xml 里加spring-boot-devtools依赖；第二步，IDEA 里打开Settings → Build, Execution, Deployment → Compiler → Build project automatically，然后按Ctrl+Shift+F9重新编译当前文件。DevTools 检测到 class 文件变化后会自动重启服务。注意，热部署并不能覆盖所有场景，新增方法签名或修改配置文件时，我还是建议手动重启，避免莫名报错。

4.3 Maven 依赖冲突与 AOP 代理的神秘 bug

毕设项目依赖一多，Maven 依赖冲突就来了。我遇到最典型的是 Jackson 版本被高版本模块冲掉，导致 LocalDateTime 序列化失败，前端拿到的时间格式变成一堆数字。排查思路很简单：IDEA 的 Maven 面板里有 Show Dependencies 功能，输入冲突的包名查看依赖树，找到重复的依赖后，在 pom.xml 里用<exclusions>排除其中一个版本。

另一个常见问题是 SpringBoot 默认使用 CGLIB 代理带来的奇怪 bug。项目里如果你的 Service 类没有实现接口，CGLIB 会用子类继承的方式来代理，此时类和方法不能是 final 的，否则代理失败。还有部分同学用@Transactional注解时发现事务不生效，原因往往是同一个类内部的this调用绕过了代理对象。这两个问题在热词里都有体现，排查思路是：先打印注入的 Bean 的 class 名称，看到Class$$EnhancerByCGLIB就知道是代理对象，再检查方法可见性。

4.4 Vue 打包进 SpringBoot 后的白屏、404 与跨域排查

把 Vue 放进 static 目录后，最常见的是白屏。先看控制台有没有报错，然后逐项排查。第一步，确认 dist 的静态文件路径是对的。如果 Vue 的publicPath配置了绝对路径，放到 SpringBoot 后资源就找不到了，需要把 publicPath 改为相对路径./再重新打包。

第二步，检查接口路径。前端页面能打开但接口全部报 404，就把前端请求的 URL 和后端 Controller 的@RequestMapping对照一下。比较稳妥的做法是给所有后端接口统一加一个/api前缀，比如@RequestMapping("/api/course")，前端请求也统一走/api。这样打包后不用额外区分环境。

第三步，处理跨域。开发阶段解决了跨域不代表打包后就没事。如果前端页面和后端接口同源，不会触发跨域，但如果你仍然访问的是 8080 端口的接口，而页面是 80 端口进来的，浏览器就会拦截。统一部署后通常不存在这个问题，如果仍然出现，就在后端加一个跨域配置类，允许所有来源访问。

4.5 MySQL 时区、JSON 序列化与逻辑删除的隐藏问题

时间字段的问题我在前面配置里提到过。代码层面还需要注意：实体类里的LocalDateTime字段，如果不配 Jackson 的序列化格式，前端拿到的会是时间戳或格式不对的数组。解决办法是在 application.yml 里设置：

spring: jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT+8

同时实体类的日期字段加@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")注解，这样后端返回给前端的就是标准字符串。

逻辑删除是 MyBatis-Plus 的常用功能。配置了逻辑删除后，所有 update 操作会自动带上deleted = 0条件，delete 操作变成 update。这个功能很好用，但带来的隐患是：如果你的自定义 SQL 里写了from user where id = ?而没有写deleted = 0，被逻辑删除的数据还是会被查出。排查时重点检查自定义 Mapper XML 里的 SQL。

5. 如何把这个项目扩展成高分论文和答辩亮点

5.1 论文结构：把项目代码翻译成学术表达

代码写完了，论文是很多同学最抵触的部分，但写论文其实是有套路可循的。标准的毕设论文结构基本是：绪论、需求分析、系统设计、系统实现、系统测试、总结。关键在于如何把“我写了个网站”变成“我设计并实现了一个教学平台”。

需求分析部分，不要只复述功能列表，要画出用例图，围绕教师、学生、管理员三种角色分别描述他们的业务目标。比如教师的核心目标是“高效组织教学资源并了解学生学习情况”，由此推导出资源管理、作业发布、签到统计等功能需求。这种推导逻辑是评委最喜欢的。

系统设计部分，从总体架构图开始，先画浏览器请求到后端的流程，再分模块画类图和时序图。不要光贴代码，画图反而更容易得分。特别是 WebSocket 互动模块，画一张消息时序图，把老师发起签到、服务端广播、学生响应、服务端存储这个链路展示出来，技术分就到手了。

5.2 答辩演示建议：五到十分钟讲清楚技术核心

答辩现场最忌讳照着 PPT 念功能列表。我建议按这个顺序准备演示流程：

第一步，用一分钟讲选题背景和现状，点出“教学设计”这个词，说明平台是如何支撑线上线下融合教学的。第二步，用两分钟展示角色登录界面，分别以教师、学生的视角走一遍核心流程。第三步，重点演示智慧课堂的实时签到，这是你区别于其它 CRUD 项目的最大亮点。第四步，打开 IDE 展示代码结构，不要从头讲代码，只选中拦截器、WebSocket 处理器、事务配置这几个关键类，讲一讲设计意图。最后把系统部署成一个 jar 包跑一遍，证明这不是“照片项目”。

提前准备好两个万能回答：一是“为什么用 Redis/消息队列”，二是“如果用户量变大你怎么办”。答“把核心数据缓存到 Redis、将耗时操作异步化、做读写分离”就足够了，不要不懂装懂讲微服务。

5.3 后续扩展：消息队列、实时统计与在线编辑器

毕设答辩结束后，如果想把这个项目真正做成能面世的成果，或者想在简历上多写一条亮点，有三个扩展方向。

第一个扩展点是低代码化的作业提交与批改功能。当前系统里作业提交只是文件上传，可以进一步接入代码在线评测，让学生提交 Java 源码后自动编译、跑测试用例并返回结果，这一块在企业面试和实习筛选里非常加分。第二个扩展点是把数据以可视化大屏形式展示，统计每位学生的学习时长、签到率、作业完成率，做成教师端的数据看板。第三个扩展点是事件驱动架构的落地，用消息队列把通知推送、日志记录、数据统计异步化，让系统从“能跑”升级成“抗压”。这三个方向都能在原有 SpringBoot 项目上无损叠加，只要把新模块的接口封装好，旧模块完全不用动。

最后分享一点个人心得：做这类系统型毕设，最大的风险不是技术不会，而是陷入“什么功能都想做”的泥潭。项目管理上要懂得做减法，把“教师建课、学生选课、课堂签到、资源下载、作业提交”这条主线打磨到运行稳定，就已经能覆盖大多数评审要求。至于智慧课堂的实时互动，它是我最建议投入时间的功能，它让你的项目不再是简单的管理系统，而是有真实教学场景支撑的“教学设计与应用”兼具的完整作品。代码能跑只是合格线，能讲清楚为什么这样设计才是高分线，这也是SpringBoot这类框架真正值得研究的地方。