基于SpringBoot+SSM的在线学习平台开发实战与核心设计

1. 项目整体解读与选型思路

1.1 这个平台到底解决什么问题

我接触过不少准备毕业设计的同学，也帮人排查过几套类似的在线学习项目源码，说句实话，这类“课程平台”看起来功能都差不多，但真正把业务线理清楚的并不多。这次聊的这套基于 Java + SpringBoot + SSM 的在线网络学习平台，本质上是一个典型的三端课程业务系统：学生能注册登录、浏览课程、购买或免费加入课程、观看课时并记录学习进度；教师能创建课程、管理章节和课时、查看学生情况；管理员则负责用户管理、课程审核上架、公告发布等后台操作。

你可以把它理解成一个精简版的网课站点，不需要像大型在线教育平台那样搞复杂的推荐算法和直播互动，但核心的“课程从发布到学习到记录”这条业务闭环是完整打通的。正因为边界清晰，这套项目既适合当作课程设计或毕业设计的骨架，也适合刚接触企业级开发的同学拿去练手——它能覆盖登录鉴权、权限分离、文件上传、数据库关联查询、分页搜索这些最常见的后端场景，而这些恰恰是面试和实际工作中高频出现的东西。

需要说明的是，SpringBoot 和 SSM 这两个词放在一起并不冲突。SSM 指 Spring + SpringMVC + MyBatis，是经典的前后端分离前技术栈；而 SpringBoot 在这个项目里承担的是“自动化配置 + 快速启动”的底座角色。实际落地时，大多数同学会直接用 SpringBoot 做容器，内部依然按照 Controller、Service、Mapper 这种 SSM 分层结构去写业务代码，所以项目名里的“Java + SpringBoot + SSM”本质上是同一套体系下的组合，不是什么奇怪的混搭。

1.2 为什么优先选这套方案而不是其他组合

如果现在让我给一个准备做在线学习项目的人推荐技术栈，SpringBoot + MyBatis 依然是第一选择。原因特别直接：社区成熟、资料多、出问题时候能搜到答案。你随便把一个报错信息粘到搜索引擎里，几乎都能找到对应解决方案，这是大厂自研框架和冷门框架比不了的。

很多人喜欢纠结“SSM 已经过时了，要不要换 Spring Cloud 或者微服务”。我的看法很明确：不要为了赶时髦而把简单问题复杂化。一个几百行业务代码的在线学习平台，强行拆成多个微服务，带来的注册中心、配置中心、服务调用链路这些成本，远大于它带来的收益。微服务解决的是团队协作和独立部署问题，不是让你用来展示“我会用新技术”的。

另外还有一个实用层面的考量：大部分课程设计和毕业设计都有“文档 + 答辩 + 演示”的要求。SpringBoot 项目结构直观，类名和分层职责清楚，写论文时候天然好描述。比如 Controller 层做参数接收和结果返回，Service 层做业务判断，Mapper 层做数据库操作，这种三层结构用文字一讲就明白。相比之下，如果用了过于抽象的架构，你自己讲不清楚，老师听着也费劲。

这套组合的另一个优势是调试方便。SpringBoot 内置 Tomcat，一个 main 方法就能起服务，不像传统 SSM 项目需要单独配置外部 Tomcat、改一堆 XML。开发期用 DevTools 还能做到热更新，改了代码不用反复重启。对于需要在有限时间内做完项目并演示的人来说，这个体验提升是非常明显的。

1.3 项目里的目录结构和模块划分值得怎么去看

拿到一套源码，第一步绝对不是打开 IDE 乱点，而是先看懂目录结构。一个规范的 SpringBoot 在线学习项目，包结构通常是这样组织的：

com.example.learning ├── controller // 控制层，接收前端请求 ├── service // 业务层，处理核心逻辑 │ └── impl // 业务实现类 ├── mapper // MyBatis的Mapper接口 ├── entity // 数据库实体类 ├── dto // 前后端数据传输对象 ├── vo // 视图对象，返回给前端的数据封装 ├── config // 配置类，比如拦截器、文件上传配置 ├── common // 公共类，统一返回结果、异常处理 ├── utils // 工具类 └── LearningApplication.java // SpringBoot启动类

我见过不少学生拿到源码后直接从 Controller 开始读，读了两天还在里面绕。正确的阅读顺序应该是：先看数据库设计文档或者 SQL 脚本，搞清楚有哪些表、表之间什么关系；然后看 entity 实体类和数据库字段的对应关系；接着看 mapper 里的 SQL 语句；最后才回到 controller 看接口是怎么调通整条链路的。这个顺序和你从零开发一个项目的思维路径是一致的。

还有个小细节，很多人不注意。启动类上的@SpringBootApplication默认只会扫描它所在包及子包下的组件。如果你新建了一个包放在启动类所在包的父子结构之外，Controller 和 Service 注册不进去，接口访问的时候就会 404。这个坑几乎每个月都能遇到一次。

2. 核心业务模块与数据库设计拆解

2.1 三角色权限体系是怎么设计和落地的

在线学习平台最基础的需求就是区分不同身份的人能干什么。学生不能去编辑课程，教师不能去删除用户，管理员也不能替学生去记学习进度。这套权限体系在实际项目里不一定用到 Spring Security 那种重型安全框架，很多课程项目就是用拦截器 + Session来实现的。

具体做法是这样：登录成功后，把用户信息放到 Session 中，同时给用户打一个角色标识字段role。后台定义一个拦截器，拦截所有需要登录才能访问的路径，在preHandle里检查 Session 是否有用户信息；然后再定义一个管理员专用的拦截器，在检查登录的基础上再检查role是不是管理员。这种做法的好处是逻辑简单，答辩时候能说得清楚，缺点是没有细粒度权限控制，比如你没法做到“某个教师只能编辑自己的课程”。但如果项目需求没提这一点，用拦截器完全够用。

权限控制的核心其实不是代码怎么写，而是你要先在数据库里把用户表设计好。用户表一般长这样：

设计用户表的时候有个常见的坑：密码一定要加密存储。很多初学项目直接把明文密码往数据库里塞，答辩时老师问一句“用户密码泄露了怎么办”就答不上来。不需要用多复杂的加密方式，哪怕用 Spring 自带的BCryptPasswordEncoder或者 MD5 加盐，也比明文强得多。这个项目如果是你拿来面试的作品，强烈建议把密码加密这块做上。

2.2 课程相关表的设计思路

课程是业务的核心，围绕课程的设计通常会拆成几张表：课程分类表、课程信息表、课程章节表、课时表。为什么要这么拆？因为一门课程包含多个章节，一个章节包含多个课时，这是天然的树形层级关系。如果全部塞进一张表里，查询一门课程的完整大纲会变得非常痛苦，而且数据冗余会越来越多。

课程信息表的字段通常包括：

• id课程编号
• teacher_id教师编号，关联用户表
• category_id分类编号
• title课程标题
• cover封面图地址
• intro课程简介
• price价格，0 表示免费课程
• status状态：0 草稿、1 待审核、2 已上架、3 已下架
• create_time创建时间

这里我想特别讲一下status字段。很多人在做课程管理时只做一个“上架/下架”的布尔值，但实际业务里还有一个审核状态。教师上传课程后，管理员需要审核内容是否合规，然后才能上架。引入一个待审核状态，整个项目的业务层次就出来了，答辩时候也能多讲一个场景。课程表中加个status字段，配合后台管理员操作，就能把“教师提交 → 管理员审核 → 学生可见”这条线完整展示出来。

章节表和课时表的关系也值得仔细想。章节表记录章节名和排序号，课时表记录课时标题、视频地址、视频时长。这里要注意，课时表需要冗余一个chapter_id字段，而不是通过章节表再反查课程。这样你在查询“某门课程的所有课时”时，可以一次性把所有数据捞出来，在内存里按章节分组，避免对数据库做多次往返查询。

2.3 学习记录和购买关系的业务闭环

在线学习平台和其他普通内容网站最大的区别，在于它要跟踪学习行为。用户看完了哪节课、看到第几分钟、下一次进来接着哪里看，这些都是实打实的业务需求。实现起来一般需要一个学习记录表：

前端播放视频时，定期通过接口上报播放进度到后端，后端拿到数据后执行插入或更新操作。这里需要考虑一个“并发”问题：用户快速切换课时的时候，可能会同时发送多个请求，如果每次都insert，学习记录表里就会出现同一课程多条记录。正确的做法是做一个存在性判断：先查该用户在该课程下是否已有记录，有则更新，没有则插入。

另外一个必须考虑的是购买关系。如果平台里有收费课程，学生下单购买后，需要记录在订单表或购买记录表里。为了避免用户直接通过课程详情页 URL 绕过购买逻辑去学习免费能看到的内容，学习前需要校验一下“当前用户是否购买了该课程”或“课程是否免费”。这个校验逻辑放在课程视频接口的 Service 层里做，而不是只在前端按钮上做，否则随便一个懂前端知识的人都能绕过限制。

3. 关键功能实现细节与实操要点

3.1 登录鉴权的核心代码怎么组织

登录鉴权几乎是所有 Java Web 项目被问得最多的部分。我用一个简单方案把流程串起来，方便你直接套用。

先在pom.xml里引入依赖，我用的是 Spring Boot 2.7 版本，对应的依赖坐标如下：

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>2.3.1</version> </dependency> <dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <scope>runtime</scope> </dependency>

启动类加上@MapperScan注解，指定 Mapper 接口所在的包路径：

@SpringBootApplication @MapperScan("com.example.learning.mapper") public class LearningApplication { public static void main(String[] args) { SpringApplication.run(LearningApplication.class, args); } }

登录业务的 Service 层代码大致长这样，注意密码比较时是通过BCryptPasswordEncoder来校验的：

@Service public class UserServiceImpl implements UserService { @Autowired private UserMapper userMapper; private final BCryptPasswordEncoder encoder = new BCryptPasswordEncoder(); @Override public User login(String username, String password) { User user = userMapper.findByUsername(username); if (user == null) { throw new BusinessException("用户不存在"); } if (!encoder.matches(password, user.getPassword())) { throw new BusinessException("密码错误"); } if (user.getStatus() != 1) { throw new BusinessException("账号已被禁用，请联系管理员"); } return user; } }

登录成功的 Controller 方法里，把用户对象存进 Session，同时设置一个存活时长，防止长时间不操作后 Session 一直有效：

@PostMapping("/login") public Result login(@RequestBody LoginDTO loginDTO, HttpSession session) { User user = userService.login(loginDTO.getUsername(), loginDTO.getPassword()); session.setAttribute("user", user); session.setMaxInactiveInterval(60 * 30); // 半小时过期 return Result.success(user); }

拦截器方面，注册一个全局拦截器，排除登录、注册、首页课程列表等公开接口。具体配置如下：

@Configuration public class WebConfig implements WebMvcConfigurer { @Autowired private LoginInterceptor loginInterceptor; @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(loginInterceptor) .addPathPatterns("/api/**") .excludePathPatterns("/api/user/login", "/api/user/register", "/api/course/list"); } }

这里有一个我实际踩过的坑：拦截器的excludePathPatterns路径必须和接口路径完全一致，包括前缀。如果你前端请求的是/api/course/list，但拦截器排除的是/course/list，那照样会被拦截，前端会莫名其妙地跳到登录页。排查这种问题最直接的办法，就是在拦截器里打日志，每次请求进来都输出请求路径。

3.2 课程上架与视频文件上传的处理细节

课程管理的后台操作里，最容易翻车的就是文件上传。视频文件动辄几十上百兆，如果不在配置里放开限制，SpringBoot 默认的 1MB 上传上限会直接把你的请求拦下来。

application.yml里需要这样配：

spring: servlet: multipart: max-file-size: 200MB max-request-size: 500MB

配完之后，Controller 方法里用MultipartFile接收文件，保存到一个固定的磁盘目录：

@PostMapping("/api/lesson/upload") public Result upload(MultipartFile file, HttpServletRequest request) { if (file.isEmpty()) { return Result.error("请选择文件"); } String originalFilename = file.getOriginalFilename(); String ext = originalFilename.substring(originalFilename.lastIndexOf(".")); String fileName = System.currentTimeMillis() + "_" + UUID.randomUUID().toString().substring(0, 8) + ext; String savePath = "/data/videos/" + fileName; File dest = new File(savePath); if (!dest.getParentFile().exists()) { dest.getParentFile().mkdirs(); } file.transferTo(dest); // 返回访问路径，实际部署时再用虚拟路径映射一下 return Result.success("/video/" + fileName); }

关于文件上传，我有几个经验想多说一句。第一，文件名一定要处理，不能直接用用户上传的文件名保存到服务器，防止文件名冲突和潜在的路径注入问题。第二，保存路径不要写在代码里写死，放到配置文件里，部署时根据服务器环境修改。第三，不是所有人都用 Linux 服务器目录，如果你在本机 Windows 上调试，路径分隔符记得用File.separator或者直接使用正斜杠，避免跨平台运行时报 FileNotFoundException。

还要在WebConfig里配置虚拟路径映射，让对外访问 URL/video/**映射到磁盘目录：

@Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/video/**") .addResourceLocations("file:/data/videos/"); }

这个配置在开发环境和生产环境容易不一致，我习惯把磁盘路径也放进application.yml里统一管理。

3.3 学习进度记录实现：前后端怎么协作

学习进度功能是这类项目的一个亮点功能，实现起来也不复杂。前端播放器（比如成熟的 video.js 或原生 video 标签）会触发timeupdate事件，这个事件大概每 250 毫秒到 1 秒触发一次。如果每次触发都往后台发请求，后端压力会比较大，而且完全没必要。我的做法是前端每 10 秒上报一次进度，同时记录当前播放秒数；在组件卸载或页面关闭前，再强制上报一次，确保最后的观看位置被保存。

后端的更新逻辑如下：

@Override public void updateProgress(Integer userId, Integer courseId, Integer lessonId, Integer progress) { StudyRecord record = recordMapper.findByUserAndLesson(userId, lessonId); if (record == null) { StudyRecord newRecord = new StudyRecord(); newRecord.setUserId(userId); newRecord.setCourseId(courseId); newRecord.setLessonId(lessonId); newRecord.setProgress(progress); newRecord.setStatus(0); recordMapper.insert(newRecord); } else { record.setProgress(progress); if (progress >= 90) { // 假设播放到90%算完成 record.setStatus(1); } recordMapper.updateById(record); } }

注意这里判断“是否完成”的标准。不同平台的策略不一样，有的以看完 90% 为完成，有的要求看完 95%。这个阈值你自己定，但建议写成常量并在文档里说明，避免答辩被追问时一时答不上来。

还有一个细节容易被忽略：续播功能。用户在课时页里刷新或者重新进入，前端应该请求一下“查询该用户在某课时的学习进度”的接口，拿到上一次的播放秒数，然后把视频的currentTime设置到那个位置。这样用户体验才完整——我上次看到 12 分 30 秒，下次进来不应该从头开始播。

4. 调试、运行与常见问题排查实录

4.1 拿到源码后怎么快速跑起来

很多同学拿到项目压缩包后的第一反应是双击 IDEA 打开，然后直接点运行，结果报一堆红色错误，整个人就慌了。跑这类项目的正确顺序是固定的，按照下面的步骤来基本能一次通过。

第一步，先看有没有sql或database目录。这一步千万别跳过，也不要自己手动建表。把 SQL 脚本在 Navicat 或命令行里执行，一个在线学习平台的完整库通常包含 8 到 12 张表。执行完查看表是否都建出来了。第二步，下载项目依赖。在 IDEA 里打开项目后，等待右下角 Maven 依赖导入完成；如果网络不佳，部分依赖下载失败，观察 pom.xml 文件里是否有报错，有的话配一下阿里云镜像仓库。第三步，改数据库连接配置。打开application.yml，把数据库地址、账号、密码改成自己本机的值。第四步，启动项目。观察控制台日志，看到Tomcat started on port(s): 8080就算启动成功。第五步，用接口测试工具先调一个公开接口，比如课程列表接口，确认返回数据正常。

如果项目分了前后端，前端是单独的 Vue 项目，那还要先执行npm install装依赖，再执行npm run dev启动前端服务。前后端联调时要注意接口地址配置，跨域问题一般通过后端加@CrossOrigin或者配置 CorsFilter 解决。

4.2 高频问题速查表

我把这几年帮人排查项目中遇到的问题整理成一张速查表，按出现频率排了个序：

我重点提醒一下数据库字符集的问题。建库的时候最好用 utf8mb4，而不是 utf8。因为 utf8 在 MySQL 里最多只有 3 个字节，而 emoji 表情需要 4 个字节，用户昵称或公告内容里一旦出现 emoji，直接报Incorrect string value错误。这是非常常见但百度一下就能解决的问题，熟练的话一分钟就能搞定。

4.3 那些源码里不会写的避坑经验

最后分享几个只有实际动手跑过才会总结出来的经验。

第一个是关于资源目录的遗漏。项目如果使用了静态资源，比如图片、JS、CSS 放在src/main/resources/static下，SpringBoot 默认会映射到根路径。但是如果你配置了虚拟路径映射，比如把/video/**和/upload/**映射到了外部目录，要小心别把静态资源的默认映射覆盖掉。如果你发觉项目首页打开了但样式全丢了，八成就是资源映射的锅。

第二个是 MyBatis 的resultType返回值问题。多表关联查询时，如果返回的结果需要包含两个表的字段，直接在 Mapper 里写resultType="map"是最省事的方式。但要注意，数据库字段是下划线风格，比如create_time，Java 实体类字段是createTime。如果开了 MyBatis 的驼峰映射，默认情况下从 map 里取 key 还是下划线风格，这里容易踩坑。我的建议是多表查询时直接写 VO 类，通过as别名把字段名和 Java 属性对齐，避免 map 取值时各种奇怪的问题。

第三个是事务问题。购买课程、扣减余额、生成学习记录这一系列操作，如果涉及多张表的更新，必须要在 Service 方法上加@Transactional。不加事务的情况下，一旦中途操作失败，会出现用户付了钱却没买到课的数据不一致问题。我还见过一些同学把@Transactional加到 Controller 方法上的，这虽然能生效，但不符合分层规范，答辩时容易被老师追问，建议统一放在 Service 实现类的方法上。

第四个是我个人认为最实用的一个习惯：上线前把MyBatis的 SQL 日志打开。在配置文件里加上configuration.log-impl: org.apache.ibatis.logging.stdout.StdOutImpl，这样控制台会输出每条 SQL 语句和参数。排查“为什么查出来是空”、“为什么多了一条数据”这类问题的时候，看 SQL 永远比看代码更快。

这套项目我前后帮人排查过不下十次，给我的整体感觉是：业务量不大，但涉及的技术点覆盖面非常广，从框架整合、数据库设计、拦截器、文件上传到前后端联调全都能练到。你把它完整跑通、看懂、能改，再去面试实习生或者初级 Java 岗位，至少能跟面试官聊上二十分钟不冷场。

现在每届毕业生做相似课题的不在少数，但真正去把每一张表的设计意图、每一个接口的前后逻辑、每一个异常场景都搞明白的人其实不多。大多数人的问题不在于代码写不出来，而在于拿到一个项目后不知道怎么去消化它。如果你能把这套平台的用户角色链路、课程发布链路、学习记录链路这三条主线全部梳理清楚，再在老师面前从头到尾演示一遍，这个项目对你来说就算真正吃透了。