每年到了三四月份后台私信里的高频问题就变成了“毕设到底选什么题”。今天我把一个问得最多、也最稳妥的题目彻底讲透基于Spring Boot的在线教育平台。这是一个典型的Java Web全栈开发项目技术栈集中在Spring Boot框架、MyBatis持久层、MySQL数据库再加上Vue前端做前后端分离配套内容包含完整源码、毕业论文文档大家都习惯叫LW、部署说明和演示视频属于一套“交付就能用、答辩能讲清”的完整毕设方案。这个项目解决的核心问题是它把在线学习场景中的用户管理、课程展示、视频播放、题库测试和管理后台等真实业务模块全部走通覆盖了Java Web开发中大部分核心知识点同时又没有复杂到做不完。适合正在准备Java课程设计、毕业设计的同学也适合想系统梳理Spring Boot开发流程的初级开发者。下面我不讲虚的直接按真实开发顺序把这个项目的每个环节拆开说。1. 项目整体设计与需求拆解1.1 在线教育平台为什么适合做毕设毕设选题有一个潜规则难度要适中业务要完整演示要有亮点。在线教育平台恰好满足这三条。从业务完整性上看它天然包含三类角色——学生、教师、管理员这决定了系统必须做权限控制课程、章节、视频这些核心数据构成典型的一对多关系正好用数据库设计体现再加上在线测试、学习进度、后台统计这些业务既有基础增删改查又有统计聚合这种稍微进阶的内容答辩时不会因为“全是CRUD”而被追问到没话说。从技术覆盖度上看这个题目能把Spring Boot框架的自动配置原理、MyBatis-Plus的持久层操作、拦截器与认证鉴权、文件上传、接口设计、前后端联调这些知识点一次全部覆盖。我常跟学员说做完这个项目Spring Boot相关的高频问题里至少有一半你能用自己的代码讲出来。1.2 功能清单怎么定边界怎么控制很多同学一上来就把功能表列得跟大型电商平台一样庞大这是毕设第一大忌。我建议按下面这个范围控制功能边界。学生端核心功能注册登录、个人信息维护浏览课程列表、搜索课程查看课程详情与章节列表在线播放教学视频在线答题、查看测试成绩查看个人学习进度与课程收藏教师端核心功能课程管理发布、编辑、上下架章节与课时管理上传视频、课件题库管理与试卷组卷查看学生学习数据管理端核心功能用户管理禁用、启用、角色分配课程分类管理公告管理数据统计用户数、课程数、访问量注意在线支付、直播互动、真实转码推流这类功能毕设阶段建议直接砍掉。这类功能要么涉及第三方支付资质要么需要流媒体服务器技术复杂度高、答辩收益低做了反而容易把自己绕进去。边界控制的核心思路是每个模块都必须能演示出完整的业务闭环。比如课程模块不是只有增删改查而是从课程发布、章节维护、前端展示、播放学习再到后台统计观看次数形成一条能讲清楚的业务链路。这比多堆十几个孤立的CRUD页面有用得多。2. 技术选型与架构设计2.1 前后端分离方案Spring Boot Vue这一套我实测下来最稳的组合是后端Spring Boot 2.7.x MyBatis-Plus MySQL 8.0 Maven前端Vue 2 Element UI Axios如果基础好也可以用Vue 3 Element Plus认证JWT 拦截器部署后端打成jar包前端打成dist目录用Nginx托管选Spring Boot 2.7.x而不是3.x是有原因的。Spring Boot 3.x要求JDK 17而且部分旧版本的MyBatis-Plus、连接池组件兼容性有坑很多同学的电脑装的还是JDK 8毕设环境能少折腾就少折腾。2.7.x的资料最全遇到问题搜一下基本都有答案。MyBatis-Plus比原生MyBatis多了一个很大的优势内置分页插件和通用CRUD方法。对毕设来说大部分单表操作不需要手写SQLBaseMapper自带的insert、selectById、selectPage就能覆盖能省下大量调试时间。注意网上经常搜到“mybatis的分页插件的用法 springboot”这类问题这里我提前说明MyBatis-Plus的分页插件必须通过配置类注册PaginationInnerInterceptor否则selectPage分页不生效这是新手必踩的坑后面排坑部分我还会细说。2.2 数据库设计在线学习平台的表怎么建数据库设计我建议按业务域拆分核心表可以分为用户域、课程域、测试域、日志域四块。用户域三张表user用户基本信息、role角色、user_role用户角色关联也可以简化成在user表里加一个role_type字段。毕设阶段用字段区分角色完全够用能少两张表就少两张。课程域是重点四张表course课程主表字段包含course_name、cover_url、category_id、teacher_id、introduction、status等course_category课程分类表course_chapter章节表通过course_id关联课程course_video课时表通过chapter_id关联章节包含video_url、duration、video_name等这里注意课程、章节、课时是典型的三层树形结构外键关系必须清晰不然前端做课程详情页的时候拿不到完整的数据链。测试域两张表question_bank题目表字段包括question_type单选/判断、question_content、option_a/b/c/d、answer、analysisexam_record测试记录表记录学生每次答题的成绩情况。日志域一张表study_log学习记录表记录学生观看某个视频的时间、完成状态这既是学习进度模块的数据基础也是后台统计数据的主要来源。2.3 分层架构与代码组织整个后端工程严格按Spring Boot的经典分层来组织com.example.education ├── controller接口层接收前端请求 ├── service业务逻辑层接口实现类 ├── mapper持久层继承BaseMapper ├── entity数据库实体类 ├── dto数据传输对象接收前端参数 ├── config配置类拦截器、跨域、分页插件 ├── utils工具类JWT、MD5、文件处理 └── common统一返回结果、异常处理、常量这个分层最大的好处是职责清晰。controller只做参数接收和返回service只做业务逻辑mapper只管SQL。答辩时老师问你“某个业务具体在哪一层处理”你能清楚回答这就是很大的加分项。同时建议在common包下定义统一的返回结果类Resultpublic class ResultT { private Integer code; private String message; private T data; // 省略构造函数与getter/setter public static T ResultT success(T data) { ... } public static T ResultT error(Integer code, String message) { ... } }前后端接口统一返回{code, message, data}结构前端Axios拦截器里就能统一处理错误提示不用每个接口单独写异常判断这是实际开发中很实用的习惯。3. 核心模块实现与实操细节3.1 用户认证与权限控制JWT 拦截器在线教育平台的角色区分非常明确学生、教师、管理员的权限差异很大所以认证鉴权是第一优先级。我用的是JWT方案整体流程是用户登录成功后后端根据用户ID和角色生成Token返回给前端前端把Token存在localStorage里每次请求在Authorization头带上后端写一个拦截器统一解析Token并把用户信息放入请求上下文。核心拦截器代码逻辑大概是这样public class JwtInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token request.getHeader(Authorization); if (StringUtils.isBlank(token)) { throw new BusinessException(401, 未登录或登录已过期); } // 解析token把用户信息放到request属性中 UserInfo userInfo JwtUtil.parseToken(token); request.setAttribute(userInfo, userInfo); return true; } }这里要提醒几个实操细节。Token过期时间建议设置为2小时学生用户会一直用设太短必然出现“明明刚登录过怎么又失效了”的体验问题。另外密码存储必须用MD5加盐或BCrypt加密千万不能明文存库。论文里写上数据库密码加密方案评审印象分会高不少。3.2 课程管理与视频资源的上传与访问课程管理模块是核心中的核心。教师端发布课程时涉及课程封面图片上传和视频文件上传两个操作。文件上传这一块Spring Boot用MultipartFile接收文件然后保存到本地磁盘。毕设阶段不必引入FastDFS、MinIO这些分布式存储本地上传完全够用。需要注意静态资源映射。把图片、视频保存到本地磁盘后前端怎么访问必须配置资源映射把物理路径映射成URLConfiguration public class WebConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceLocations(file: uploadPath); } }我见过太多同学把文件存到本地后前端img标签死活显示不出图片就是漏了这一步。另外Spring Boot默认上传文件大小限制是1MB上传视频、课件时一定会报MaxUploadSizeExceededException必须在application.yml里配置spring: servlet: multipart: max-file-size: 500MB max-request-size: 500MB视频播放建议直接用HTML5的video标签传入视频URL毕设阶段不需要额外做视频转码。如果老师想看更专业的效果可以考虑接入第三方视频点播服务拿播放地址但不要把转码逻辑写在自己系统里这个复杂度不是毕设需要承担的。实操心得上传目录建议固定为项目外的绝对路径比如/data/upload/。如果默认上传到项目相对路径下重新打包部署后上传的文件会全部丢失录制演示视频时最容易翻车。3.3 在线测试与题库模块在线测试模块是答辩时最能突出工作量的一块。核心流程是教师维护题库单选题、判断题设置试卷学生进入考试按顺序答题提交后后端判分保存成绩记录。一题一题判分效率低更专业的做法是批量判分。提交时前端把所有题目的答案组装成一个数组传给后端后端一次查询题库答案逐题比对public Integer calculateScore(ListUserAnswer answers) { ListInteger questionIds answers.stream() .map(UserAnswer::getQuestionId).collect(Collectors.toList()); ListQuestionBank questions questionBankMapper.selectBatchIds(questionIds); MapInteger, QuestionBank questionMap questions.stream() .collect(Collectors.toMap(QuestionBank::getId, q - q)); int score 0; for (UserAnswer answer : answers) { QuestionBank q questionMap.get(answer.getQuestionId()); if (q.getAnswer().equals(answer.getAnswer())) { score q.getScore(); } } return score; }这个模块要注意两点一是题目答案不能在下发试卷时返回给前端否则学生用浏览器控制台就能看到答案正确做法是只返回题干和选项判分在后端完成二是试卷必须做单次提交限制后端要校验该学生是否已有该试卷的测试记录防止重复提交导致成绩重复。3.4 后台管理与数据统计管理后台本质上是对核心业务数据的可视化操作。用户管理、课程分类管理都是常规CRUD不展开说。真正值得花时间的是数据统计模块。我建议用ECharts做三张核心图表用户增长趋势折线图、课程访问量排行柱状图、分类课程数量饼图。后端接口用GROUP BY聚合查询SELECT DATE(create_time) as date, COUNT(*) as cnt FROM user GROUP BY DATE(create_time) ORDER BY date前端把返回的数据灌进ECharts的series里就能出图。这三张图表足以在演示视频里形成“系统很完整”的观感而且实现成本很低。实操心得统计接口返回的时间字段建议直接返回格式化好的字符串不要甩一个Date对象给前端。Java后端默认时区和JSON序列化格式不一致经常出现数据库里的时间传给前端差8个小时的问题直接在SQL或service层用SimpleDateFormat格式化能少踩一半时间坑。4. 部署上线与毕设材料整理4.1 本地环境配置与启动步骤一套干净的本地运行环境是毕设交付的基础。我按步骤整理一遍安装JDK 8、配置环境变量确保java -version能正常输出安装Maven 3.6.x以上版本配置阿里云镜像加速依赖下载安装MySQL 8.0创建数据库导入项目提供的SQL脚本修改application.yml中的数据库连接信息前端项目执行npm install安装依赖先后端再前端启动后端访问http://localhost:8080前端访问对应端口这里面最容易出的问题是前端依赖安装慢或安装失败。解决方案是使用npm的镜像源npm config set registry https://registry.npmmirror.com。如果个别依赖版本冲突删除node_modules和package-lock.json后重新install。4.2 项目打包与服务器部署页面级的演示用本地运行就够但如果要录制演示视频或提供给老师远程访问就需要部署到服务器。后端打包用命令mvn clean package -DskipTests生成的jar包放到服务器执行nohup java -jar education-platform.jar log.out 21 用nohup让它后台运行。前端打包用npm run build生成的dist目录放到Nginx的html目录下。Nginx的核心配置是反向代理把前端的/api请求转发到后端服务的8080端口server { listen 80; server_name your-domain.com; location / { root /usr/share/nginx/html; index index.html; } location /api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }这里有一个很关键的坑proxy_pass http://127.0.0.1:8080/;结尾的斜杠会去掉/api前缀如果前端请求的是/api/course/list后端实际收到的会是/course/list。如果后端接口没有/api前缀这个配置正好如果有配置也要对应调整。这个细节搞不清楚部署后接口全部404属于高频问题。4.3 论文文档LW与演示视频毕设交付包里大家习惯说的“LW”指的就是毕业论文和设计文档。我见过不少代码写得不错但论文质量拉胯的同学最终成绩不理想。论文写作有几个实用建议。第一论文结构按软件工程标准来。摘要、需求分析、系统设计、数据库设计、系统实现、系统测试、总结这个顺序不能乱。需求分析章节要画用例图系统设计章节要画系统架构图、功能结构图用Word自带的画布或draw.io画不要用网上截图。第二数据库设计章节必须要有ER图和建表语句说明。把核心表的字段、类型、约束讲清楚这段是老师重点检查的部分。第三系统测试章节要有测试用例表包含测试编号、测试模块、操作步骤、预期结果、实际结果、是否通过。这个表格很能体现工程思维。演示视频的录制我用的是OBS或EV录屏按顺序演示登录、学生端浏览课程、播放视频、在线测试、教师端管理课程、管理后台统计图表。录制前先把要演示的路径写成脚本控制节奏在8到12分钟左右声音要清晰不要边录边想。5. 常见问题与排坑实录5.1 MyBatis-Plus分页不生效与依赖冲突这是搜索热度极高的问题“mybatis的分页插件的用法 springboot”。症状表现为分页接口返回了所有数据或者分页参数不起作用。原因几乎都是没有注册分页插件。MyBatis-Plus从3.4.0版本开始分页功能需要手动配置MybatisPlusInterceptorConfiguration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }配好后在Service层直接调用baseMapper.selectPage(new Page(pageNum, pageSize), queryWrapper)即可。很多同学页面能出数据但分页失效就是因为漏了这个配置类。另一个高频问题是依赖版本冲突。典型情况是项目里同时引入druid和spring-boot-starter-jdbc的默认连接池或者MyBatis-Plus版本和Spring Boot版本不匹配。解决思路是统一用spring-boot-dependencies管理的版本尽量少显式指定第三方版本。5.2 跨域、时间格式与序列化问题前后端分离后前端访问后端接口报跨域错误这是必经之路。解决方案是在后端写一个CORS配置类Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOriginPatterns(*) .allowedMethods(GET, POST, PUT, DELETE) .allowedHeaders(*) .allowCredentials(true) .maxAge(3600); } }注意如果项目同时使用了拦截器要确保拦截器在preHandle阶段放行OPTIONS预检请求否则跨域配置会被拦截器挡住。时间格式问题前面提到过最常见的表现是前端拿到的日期是2024-05-01T08:00:00.00000:00这种带时区格式。解决方法是加全局时间格式配置或者在实体类的日期字段上加JsonFormat(pattern yyyy-MM-dd HH:mm:ss, timezone GMT8)。加注解的方式更直观推荐使用。5.3 文件上传失败与图片视频找不到上传有两个高频问题一是上传超过大小限制报错解决办法前面已经给了配置二是上传成功但前端无法访问。第二种情况大部分是资源映射没配置或者上传路径中带有中文、空格导致URL编码异常。建议把上传目录固定为项目外的绝对路径避免重打jar包后上传的文件丢失。这个问题很隐蔽默认上传到项目相对路径下重新部署后文件全没了学生录演示视频的时候最容易翻车。另外补充一个关于安全过滤的细节。整体项目中可以加一层简单的XSS过滤核心是过滤请求参数中的script等危险标签避免存储型XSS。在Spring Boot里建议用Filter或拦截器统一处理在参数进入业务逻辑之前完成过滤不要在每个Controller里重复写。如果你涉及到上传PDF这类带内容的文件先确认过滤逻辑不会误伤正常业务字段尽量使用成熟方案过滤越靠前效果越好。5.4 端口冲突、数据库连接失败等环境坑我整理一个排查速查表按优先级从上往下查现象常见原因解决方案后端启动失败端口被占用查找占用进程并kill或修改server.port启动报ClassNotFoundException依赖未完整引入执行mvn clean package重新构建数据库连接失败数据库名/密码错误检查application.yml的url、username、password报Communications link failureMySQL未启动或端口不对启动MySQL服务检查3306端口前端页面白屏接口地址配置错误检查前端请求模块的baseURL是否指向后端npm run build失败Node版本过高或依赖缺失使用Node 14/16版本重装依赖这些坑我在带学员的过程中几乎每个都遇过而且基本都是开发环境初始化阶段一次踩光的。建议按“先环境、后代码、再联调”的顺序推进环境不通的时候不要急着写业务代码否则问题只会叠加。最后说点实在的。我带过的学员里真正把该项目做完做透的人后来无论是面试Java岗位还是做其他课题底子都会明显扎实很多。这个项目最大的价值不在于代码复制出来能跑而在于你亲手把一个在线教育平台的前后端链路打通了一遍从数据库建模、接口设计、权限控制到文件上传、部署发布、论文整理每一步踩过的坑都是你自己的经验。如果你时间紧张我的建议是优先保证核心链路能顺畅演示注册登录、课程查看、视频播放、在线测试、后台统计这五个环节串起来就是一条完整的业务闭环答辩足够用了。功能可以少但演示不能断任何一环卡住都会直接影响整体印象分。另外一个实用的扩展方向是在基础版本上把视频学习进度和课程收藏做细做深这类小功能投入小、演示效果明显能让答辩老师觉得你有深入思考。做毕设最怕的不是代码难而是只停留在“能跑”的阶段多问自己一句“为什么这样做”你的收获会完全不一样。