这阵子好几个同学都在问我，SpringBoot做在线学习系统到底怎么下手。刚好手头有一套健身智途系统的完整源码，前后端能跑通、功能也不花哨，非常适合拿来当毕业设计的主框架。今天干脆就把它拆开了聊聊——从项目是干嘛的、技术是怎么选的，到核心模块怎么设计、数据库字段怎么规划，最后把开发路上容易踩的坑也一并说了，希望能节省你查资料的时间。

健身智途在线学习系统，核心定位就是“健身领域的知识付费与课程学习平台”。和普通的视频网站不一样，它的业务闭环是：用户注册登录，在课程中心挑选自己感兴趣的健身课程（减脂、增肌、瑜伽、普拉提之类），点开视频学习，系统记录学习进度，下次继续；管理员这边负责发布课程、维护分类、管理视频资源。整个过程贯穿了完整的前后端交互，数据都是真实落库的，可演示性很强，这也是我比较推荐拿它作为毕设蓝本的原因。

1. 先看全貌：健身智途在线学习系统的定位与功能边界

1.1 这种题目为什么每年都有人选

你仔细琢磨“健身智途在线学习系统”这个题目就会发现，它踩中了两个被反复验证的选题思路：一是行业垂直，健身是近年来持续上升的消费领域，课程内容具有稀缺性；二是场景熟悉，在线学习系统是程序员们再熟悉不过的业务模型，网上参考案例多，即便遇到问题也有大量可检索的解决方案。

这套系统的业务范围不复杂，很适合本科生在几个月之内完成。它的功能无非是：用户端看课、学习、记录进度；管理端管内容、管用户。可别小看这点功能，真正做起来涉及用户认证、权限控制、文件上传、分页查询、数据库设计等好几个硬骨头，覆盖面刚好踩在毕业设计的考核点上。

1.2 系统角色与核心功能模块拆解

我把功能拆成了两个端，你在写开题报告或者做需求分析时可以直接照着画用例图。

• 普通用户端：注册/登录、个人信息维护、课程分类浏览、课程列表与详情查看、视频在线播放、学习进度记录、课程收藏。
• 管理员端：管理员登录、课程分类管理（增删改查）、课程管理（发布、编辑、上下架）、视频资源上传与管理、用户管理（查看列表、禁用/启用）、首页数据统计。

这里我把“学习进度记录”单独拎出来说，因为它是这个系统的灵魂功能。它不同于普通的视频播放，需要把“用户看到第几分钟”这个状态持久化到数据库。什么时候记录？一般是视频播放中每隔15秒或者视频暂停、关闭时上报一次当前时间，下次用户再打开这个视频时，直接跳转到上次记录的时间点。

知识点补充：进度上报接口是典型的高频写操作，为了提高并发能力，将来可以引入消息队列异步落库，不过毕业设计阶段用同步接口足够了。

1.3 为什么SpringBoot成了毕设事实标准

你如果去问身边做毕设的人，十个里有六七个用的SpringBoot，剩下几个是SSM或者Vue+NestJS。原因很现实：SpringBoot把一个Web项目里繁琐的配置干掉了，内嵌Tomcat，用maven依赖一引，java -jar就能跑，对短期项目极其友好。

对比一下传统SSM，配置一堆XML，光一个Spring和MyBatis整合就可能折腾两天；SpringBoot把这些繁琐的东西全部自动化，你只需要关注业务逻辑本身。同时Spring生态延续性极好，SpringBoot的自动化配置能自动根据jar包生成相关Bean，比如你引入spring-boot-starter-data-redis后，RedisTemplate就直接能用了，这种开箱即体验让我认可它是毕业设计周期的救星。

2. 技术选型背后那些事儿：不只为了显得高大上

2.1 后端核心组件与版本搭配

我按照毕设最常见的方案给你一套组合，经过大量项目验证，稳定不折腾。

实际开发时，你只需要在pom.xml中引入你需要的starter，比如spring-boot-starter-web、mybatis-plus-boot-starter、mysql-connector-java、jjwt等。有一条经验：依赖版本不要乱写，去mvnrepository查一下SpringBoot对应的版本，或者直接用阿里云镜像仓库推荐的版本组合，不然启动时各种ClassNotFound能折腾到你怀疑人生。

2.2 前端方案：Thymeleaf还是前后端分离

我在指导这个项目的时候，会先问学生前端基础怎么样。如果只学过一点HTML/CSS/JS，那直接用Thymeleaf服务端渲染最简单，后端写好Controller返回视图名，页面跳转由后端控制，不需要处理跨域，也省去了一层Node环境。但如果你会Vue2/Vue3，那更推荐前后端分离：SpringBoot只提供JSON接口，前端用Vue + Element UI搭一个后台管理界面，简历上能写的东西也更漂亮。

健身智途这里建议用法是：用户端商城类页面用Vue3 + Vite，代理转发请求给后端；管理端用Vue Element Admin那种现成脚手架改改也能省不少功夫。

如果你选前后端分离，有两件事必须提前规划：

1. 跨域：后端需要开启全局CORS配置，开发时前端Vite的proxy代理到8080。
2. Token传输：前端在登录后把JWT存到localStorage，每次请求在axios的请求拦截器里加上Authorization请求头，后端用一个拦截器统一校验。

2.3 数据库设计：一张表一张表地捋清楚

整个系统的表不多，我梳理了一下核心的7张表，完全够支撑整个业务流程。

有几个设计细节特别值得说：

• 密码绝对不能明文存储，使用BCrypt加密，同时把密码字段设置为60字符长度，避免插入时被截断。
• 逻辑删除：所有业务表加一个deleted字段，默认0，不用物理删除，这样数据还在，也方便以后做数据恢复，这也是企业开发里的标准习惯。
• 外键：我没有用物理外键，表之间的关联靠逻辑关联ID，比如course表里有个category_id字段，查询时用JOIN联表。这让数据表解耦，变更灵活。
• 唯一索引：比如course_favorite表加一个(user_id, course_id)的组合唯一索引，避免用户重复收藏时产生脏数据。

数据库建好后，直接用MyBatis-Plus的代码生成器把entity、mapper、service、controller一次性生成，能省下大半天的CRUD时间，具体操作后面我会讲到。

3. 从0到1的实操：搭建、编码、跑通全流程

3.1 环境准备与项目初始化

环境这一关，我见过太多同学栽在版本不匹配上。建议直接按照下面的组合装好：

1. JDK 1.8（oracle官网或者使用云厂商的镜像源）
2. Maven 3.8+
3. MySQL 8.0（本地装个Navicat或者DataGrip）
4. IDE：IDEA Community或者Ultimate版都够用
5. Redis 可选，缓存功能需要时再装

如果你是直接拿到源码，先不要急着启动，打开项目后按顺序做三件事：

• 修改application.yml中的数据源配置，改成自己本地的数据库地址、账号、密码。
• 找到项目里的sql脚本文件，先执行建库建表语句，再执行初始化数据脚本，把示例分类和课程数据导进去。
• 确认端口：一般设置server.port=8080，如果被占用改成8081，注意前端代理和后端端口要一致。

application.yml里有一段核心配置我直接贴出来，这是常规操作，你根据自己的情况改即可：

server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/fitness_learning?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false username: root password: 123456 servlet: multipart: max-file-size: 500MB max-request-size: 500MB mybatis-plus: configuration: map-underscore-to-camel-case: true 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

关于上传文件大小，500MB同时设置max-file-size和max-request-size是为了防止大视频上传时“请求体过大”报错。如果你只设置了file-size不设置request-size，某些情况下文件小于限制但请求总大小超限，还是会上传失败。

3.2 用户登录与JWT认证实现

登录认证是我认为整个项目最值得拿出来讲的部分，它是安全性的第一道门。我推荐的方案是JWT（JSON Web Token），流程大概是：

1. 用户提交username和password。
2. 后端从数据库查询用户，用BCrypt校验密码。
3. 校验通过，生成一个JWT，里面包含userId、username、过期时间等，签名用密钥。
4. 前端把Token存起来，之后的请求都在请求头里带上。
5. 后端写一个拦截器，把所有需要登录的接口拦截下来，解析Token，校验通过才放行。

JWT工具类的核心代码我给你拆开看一下思路，这是网上正常代码风格：

@Component public class JwtUtil { private String secret = "your-secret-key"; // 生产环境放配置里 public String generateToken(Long userId, String username) { return Jwts.builder() .setSubject(username) .claim("userId", userId) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() + 1000 * 60 * 60 * 24)) .signWith(SignatureAlgorithm.HS256, secret) .compact(); } public Claims parseToken(String token) { return Jwts.parser() .setSigningKey(secret) .parseClaimsJws(token) .getBody(); } }

有几个细节你写的时候容易漏：

• 密钥不要写在代码里，放到application.yml中用@Value读出来。
• 拦截器里排除掉登录接口、注册接口、课程列表等公开接口，否则不登录就访问不了首页。

我在实际给同学调项目时发现最常出现的问题是拦截器把所有静态资源（css、js、图片）也拦了，导致页面加载不正常。解决办法是在拦截器配置中排除static路径。

3.3 课程与视频学习模块的开发

用户端的主流程就是浏览课程、看视频。这一个环节天天写，但想做得流畅还是有门道。

课程列表的分页查询，MyBatis-Plus做得很好。你需要配置一个分页插件：

@Configuration public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }

之后在Service里直接调用：

IPage<Course> page = new Page<>(current, size); LambdaQueryWrapper<Course> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(Course::getStatus, 1); // 只要上架课程 wrapper.orderByDesc(Course::getCreateTime); courseMapper.selectPage(page, wrapper);

视频学习的核心在于播放。Vue前端一般用视频播放器组件，比如Video.js或者原生video标签。后端要处理两种请求：一个是获取视频流，二是上报学习进度。

如果你把视频直接放在服务器本地，需要让SpringBoot能够访问外部磁盘目录。方法是在配置类里重写addResourceHandlers：

@Configuration public class WebMvcConfig implements WebMvcConfigurer { @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/video/**") .addResourceLocations("file:/www/video/"); } @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/**") .allowedOriginPatterns("*") .allowedMethods("GET", "POST", "PUT", "DELETE") .allowedHeaders("*") .allowCredentials(true); } }

这样前端的视频地址就是/video/xxx.mp4，浏览器发送请求后，SpringBoot把对应磁盘文件返回给前端播放。

3.4 学习进度上报与断点续播的实现

这是系统最能体现业务深度的功能点。想一想，用户在看一个30分钟的增肌课程视频，看到一半关掉了，下次打开希望从原位置继续。就这一个用户习惯，你需要做这么多事：

1. 前端定时获取当前播放时间，每10秒上报一次。
2. 上报接口接收userId、videoId、progressSeconds，存进study_record表。
3. 用户打开课程详情页时，查询该用户最近一次学习该视频的进度，把seconds返回给前端。
4. 前端拿到进度后，在video初始化时设置currentTime。

这里要特别注意一个坑：如果用户快进或者拖拽进度条，页面会自动触发timeupdate事件，可能瞬间上报一个错误进度，导致学习记录错乱。我建议在客户端做防抖/节流，比如60秒内只允许上报一次，或者在触发seek之后等待几秒再记录。

数据库表结构中的update_time字段在这里就很关键，每次上报直接更新同一行记录，而不是插入新记录。用MyBatis-Plus的编写时，一个updateById即可覆盖旧的播放位置。

3.5 后台管理系统开发要点

管理员端建议用Vue + Element UI来做。核心功能就是几个管理页面，但里面有些细节要注意。

课程管理页面最复杂的算视频上传。视频文件通常都很大，几十MB上百MB都正常，所以我建议：

• 上传之前先校验文件格式和后缀，只允许mp4、webm等视频格式。
• 上传过程中加入进度条，使用Vue的axios上传事件计算进度百分比。
• 上传到服务器后保存返回的URL，填到课程的视频章节表里。

另外一个常被忽略的点：课程字段里的价格。健身课程如果作为付费内容，字段可以设置成decimal(10,2)，同时增加一个是否免费字段。免费课程和付费课程的播放权限要分开控制，这一块在答辩时非常加分，因为很多人想不到。

4. 真实开发中踩过的坑与排查技巧

4.1 数据库连接与初始化问题

最常见的报错是：

java.sql.SQLException: The server time zone value '�й���ʱ��' is unrecognized

这是MySQL时区配置的问题。以前我折腾时也被这个问题卡了很久，后来统一在JDBC连接串后面加上serverTimezone=Asia/Shanghai，立刻就好。另外要注意MySQL 8.0的驱动是com.mysql.cj.jdbc.Driver，不是以前的com.mysql.jdbc.Driver。

执行SQL脚本时如果报字段乱码或者字符集错误，说明建库语句没有指定utf8mb4，MySQL默认的latin1存不了中文。建库语句我建议：

CREATE DATABASE fitness_learning DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

4.2 文件上传与视频播放的坑

视频上传后访问404，大概率是虚拟路径映射没配好。我前面写了addResourceHandlers的配置类，你还需要确认classPath下没有同名/video的静态目录，否则会被优先匹配。

还有跨域的问题。当前端在localhost:5173，后端在localhost:8080时，一定会有跨域报错。解决方式上面给了全局CORS，不够的话再看是不是请求头没带Authorization，浏览器可能会发起预检OPTIONS请求，你的拦截器必须放行OPTIONS请求，否则前端报错还是跨域。

4.3 分页查询与总数统计的陷阱

MyBatis-Plus如果没注册分页插件，selectPage返回的总数一直是0，数据却能列出第一页。这个问题学生问我无数次。记住，必须注册PaginationInnerInterceptor，因为内置的Page类是依赖于拦截器来执行Count查询的。

还有联表查询时，分页顺序也有讲究。你用自定义SQL配合Page参数时，写法是：

IPage<CourseDTO> page = new Page<>(current, size); List<CourseDTO> list = courseMapper.selectCourseWithCategory(page, condition); page.setRecords(list);

千万别在自定义SQL里手动编写COUNT语句，很容易和Count查询冲突。

4.4 常见报错速查表

这里再补充一个独家技巧：用浏览器Network面板监控视频请求的状态码，如果是206，说明正常支持分段播放；如果是200且卡顿，可能需要让后端支持Range请求。SpringBoot内置的资源处理默认支持Range，如果你手动加了资源映射没生效，检查是否在过滤器层面破坏了Response。

5. 让毕业设计变得更好说：演示逻辑与升级思路

5.1 答辩演示怎么讲最加分

很多同学一到答辩就开始讲技术细节，滔滔不绝讲JWT原理、讲SpringBoot自动装配。这其实不是最优策略。我建议你能把系统当成一个产品讲，按照“角色→流程→亮点”的顺序：

• 先介绍系统是给谁用的（健身用户、管理员）。
• 然后演示一条完整的业务路径：登录→查看课程列表→打开详情→播放视频→关闭后重新打开，发现进度被记住→收藏课程。
• 再去管理端演示：新增一个课程分类、上传课程视频、在用户端看到生效。

演示的时候最加分的点是“学习进度记录”。大多数简单系统都是增删改查，你能展示一个真实业务状态被持久化，直接体现系统设计功力。

5.2 从合格到优秀的扩展方向

如果你时间充裕，给项目做几个升级，答辩时亮点会很足：

• 加Redis缓存：把课程分类列表、课程详情缓存起来，减少数据库查询压力。
• 加简单推荐逻辑：根据用户收藏和学习的课程分类，给用户推荐同分类的其他课程。
• 加在线问答社区：让用户可以发帖提问，管理员或教练回复，形成互动闭环。
• 加微信小程序端：Vue代码可以尝试编译到小程序，这面广加分高。

我个人在实际操作中的体会是：与其堆砌新技术，不如把一个业务痛点做透。市面上健身App那么多，真正让用户留下来的是“学习进度被记录、内容被组织、路径被规划”的连续感。你写代码的时候，如果能把这种连续感做出来，项目就已经超过一大半同龄人了。

最后提醒一句：代码别光顾着跑通就完事，把注释写清楚、把数据库设计文档整理好、把工具类抽得干净一点，这些才是以后面试能拿出手的东西。真要遇到不懂的地方再回来翻这篇文章，估计能帮你省下小半天搜资料的时间。