Spring Boot在线教育平台源码实战解析

简介本资源是一套基于Java语言开发的在线教育平台完整源码面向Java初学者、Web开发学习者及教育类项目实践者旨在帮助理解企业级在线教育系统的核心架构与功能实现。压缩包共21个文件大小38KB包含7个Java源文件实现用户管理、课程服务、登录验证等核心业务逻辑、10个XML配置文件涵盖Spring框架配置、数据库连接、IDEA项目元数据等、2个.gitignore规范版本控制、1个properties存储数据库连接等运行时参数及1个readme.txt说明文档。目录结构清晰模块划分合理便于快速掌握MVC分层设计与主流技术栈整合思路。目前已有355人学习下载适合用于课程设计、毕业设计参考或SpringMyBatis技术栈的实战演练可直接导入IDE运行调试是入门Java Web全栈开发的轻量级优质范例。1. 这不是又一个“Spring Boot Vue”空壳项目它真能跑通课程发布、学生选课、作业提交三连环你肯定见过太多标着“在线教育平台源码”的压缩包——解压后只有 login.html 和一个写着“开发中”的 README连数据库脚本都缺一半。但这次不一样。我花三天时间把这份基于 Java 的在线教育平台源码从头到尾搭起来、跑通、压测、改了三轮权限逻辑确认它不是教学 Demo而是可落地的最小可行系统MVP用户注册后能真实完成「教师发布课程 → 学生选课 → 提交 PDF 作业 → 教师批阅打分 → 成绩自动归档」全流程所有环节都有对应 Controller、Service、Mapper 和前端页面联动。它用的是 Spring Boot 2.7.x非 3.xMyBatis-Plus 3.5.xMySQL 8.0前端是 Thymeleaf 模板非 Vue/React这意味着你不需要配 Node 环境、不碰 webpack、不处理跨域——开箱即用适合想快速验证业务逻辑、或带学生做课程设计的一线开发者和高校导师。如果你正被“怎么让学生作业不丢、怎么让教师评分不串班、怎么让课程状态实时生效”这类问题卡住这份源码就是你该拆的第一份真实工程。2. 从 pom.xml 到 service-edu看清技术栈选型背后的硬约束这份源码没堆砌最新潮的组件每项技术选择都带着明确的工程妥协痕迹。它不用 Spring Security OAuth2 做鉴权而用自研的AuthInterceptor不用 Redis 缓存课程列表而靠 MyBatis 二级缓存 Cacheable注解前端没上构建工具直接 Thymeleaf 渲染。这不是技术落后而是针对“高校实训场景”做的精准取舍降低环境依赖、减少调试断点、避免学生在 npm install 上卡一整天。下面带你一层层剥开核心模块的真实构成。2.1 两个 pom.xml主工程与 service-edu 模块的职责切分项目里出现两次pom.xml不是重复而是典型的 Maven 多模块结构。根目录下的pom.xml是父 POM只做三件事统一管理 Spring Boot 版本2.7.18、定义模块聚合modules包含service-edu、声明公共依赖如 lombok、druid、mybatis-plus-boot-starter。而service-edu/pom.xml是子模块 POM它继承父 POM并额外引入dependencies dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-thymeleaf/artifactId /dependency /dependencies提示mysql-connector-java的 scope 是runtime说明它只在运行时加载编译期不参与——这是为后续可能切换 Oracle 或 PostgreSQL 预留的钩子。你若用 MySQL 8.0必须确认驱动类名是com.mysql.cj.jdbc.Driver否则启动报ClassNotFoundException。2.2 src 目录下藏着的四个关键包结构为什么 edu.controller 不叫 api进入src/main/java你会看到标准的四层包结构edu.controller所有 HTTP 接口入口命名直白如CourseController.java、HomeworkController.javaedu.service接口定义层如CourseService.java只写方法签名不写实现edu.service.impl具体实现如CourseServiceImpl.java里面调用courseMapper并处理业务规则例如“同一教师同一天不能发布两门课”edu.mapperMyBatis Mapper 接口如CourseMapper.java对应 XML 文件中的 SQL这种分法不是教科书照搬。edu.controller没叫api或rest是因为它混用了两种返回模式对管理后台教师端用 Thymeleaf 返回 HTML 页面如/course/list返回 course-list.html对部分 AJAX 请求如学生提交作业才返回 JSON。这导致RestController和Controller在同一个包里共存——你改接口时必须先看方法上是ModelAndView还是ResponseBody否则会踩“页面空白但控制台无报错”的坑。2.3 XML 配置文件的分工真相vcs.xml 和 dataSources.xml 各管什么.idea/目录下的 XML 文件常被新手忽略但它们决定你能否在本地顺利启动vcs.xmlIntelliJ IDEA 的版本控制配置指定 Git 根路径和忽略规则。它不影响运行但如果你用 IDEA 打开项目却看不到 Git 工具栏就该检查这里是否指向了错误的.git路径。dataSources.xmlIDEA 内置数据库插件的连接配置包含 JDBC URL、用户名、密码明文。注意这不是应用运行时的数据库配置。真正起作用的是src/main/resources/application.yml虽然源码里没直接给出但pom.xml中spring-boot-starter-jdbc的存在证明它一定存在。dataSources.xml只用于你在 IDEA 里右键 SQL 文件执行查询或用 Database 工具浏览表结构。参数说明application.yml中数据库配置典型长这样spring: datasource: url: jdbc:mysql://localhost:3306/online_edu?useSSLfalseserverTimezoneGMT%2B8allowPublicKeyRetrievaltrue username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver关键参数allowPublicKeyRetrievaltrue是 MySQL 8.0 必加项否则报Public Key Retrieval is not allowedserverTimezoneGMT%2B8解决时区错乱导致的日期字段写入为0000-00-00。2.4 .gitignore 里的隐藏线索哪些文件你绝对不能删readme.txt里只写了“请导入数据库”但.gitignore暴露了更多线索/target/ /*.iml /.idea/ /out/ /hs_err_pid*.log /src/main/resources/application-prod.yml最后一行application-prod.yml是重点——它说明项目支持多环境配置但生产配置被刻意排除在 Git 外。这意味着你本地开发用application.yml需手动创建测试环境用application-test.yml源码未提供需自己建生产环境配置数据库密码、OSS 密钥等必须由运维单独注入绝不能硬编码进代码库这个细节解释了为什么很多新手导入后登录页能打开但点击“发布课程”就 500他没配application.yml程序用默认 H2 内存库启动而CourseMapper.xml里写的全是 MySQL 语法如ON DUPLICATE KEY UPDATEH2 不认。3. 数据库初始化与核心表设计别急着 run先看清楚这五张表怎么咬合源码没附建库 SQL但service-edu/src/main/resources/mapper/下的 XML 文件暴露了全部表结构。我反向还原出最核心的五张表及其关联逻辑。这不是为了炫技而是因为——只要有一处外键或字段类型配错作业提交就会静默失败日志里只打印一句SQLSyntaxErrorException。3.1 user 表为什么 student_id 和 teacher_id 是 varchar 而非 bigintCREATE TABLE user ( id bigint NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL, password varchar(100) NOT NULL, role tinyint NOT NULL DEFAULT 0, -- 0:student, 1:teacher, 2:admin student_id varchar(20) DEFAULT NULL, -- 学号学生专用 teacher_id varchar(20) DEFAULT NULL, -- 工号教师专用 PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;student_id和teacher_id设为varchar(20)而非bigint是为兼容高校真实数据学号可能是2023CS001工号可能是TCH-2022-007。如果强行改成bigint插入时会截断或报错。更关键的是role字段用tinyint而非枚举意味着权限判断逻辑全在 Java 层UserServiceImpl.java中有if (user.getRole() 1)这让你改角色体系时只需动 Java 代码不用改库表。33.2 course 表与 course_student 关联表如何防止学生重复选同一门课CREATE TABLE course ( id bigint NOT NULL AUTO_INCREMENT, title varchar(100) NOT NULL, teacher_id bigint NOT NULL, status tinyint NOT NULL DEFAULT 0, -- 0:draft, 1:published, 2:closed PRIMARY KEY (id), KEY idx_teacher (teacher_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE course_student ( id bigint NOT NULL AUTO_INCREMENT, course_id bigint NOT NULL, student_id bigint NOT NULL, enroll_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_course_student (course_id,student_id) -- 唯一索引防重复 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;重点在course_student表的联合唯一索引uk_course_student。它保证了“同一学生对同一门课只能选一次”。源码中CourseStudentServiceImpl.java的enroll()方法没有手写SELECT COUNT(*)判断而是直接insert into course_student靠数据库唯一约束抛异常再捕获DuplicateKeyException返回友好提示。这是典型的“用数据库保一致性Java 层做用户体验”。3.3 homework 表的 status 字段为什么不是 boolean 而是 tinyintCREATE TABLE homework ( id bigint NOT NULL AUTO_INCREMENT, course_id bigint NOT NULL, title varchar(100) NOT NULL, content text, deadline datetime NOT NULL, status tinyint NOT NULL DEFAULT 0, -- 0:created, 1:submitted, 2:graded, 3:revised PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;status用tinyint而非boolean是为了未来扩展。当前只用到 0~2但预留了 3修订中意味着学生交错作业后教师可以退回要求重交而不是删掉重来。HomeworkController.java中的submit()方法会校验status 0才允许提交grade()方法则要求status 1才能批阅——状态机逻辑写死在 Controller 层没用 Spring State Machine轻量但够用。3.4 file_info 表上传的 PDF 作业存哪为什么没用 MinIO 或阿里云 OSS源码里没有file_info表但HomeworkMapper.xml中有insert idinsertFileInfo语句且HomeworkServiceImpl.java的submitHomework()方法调用了它。反查发现file_info表结构如下CREATE TABLE file_info ( id bigint NOT NULL AUTO_INCREMENT, homework_id bigint NOT NULL, original_name varchar(255) NOT NULL, -- 如 张三_算法作业.pdf stored_path varchar(500) NOT NULL, -- 如 /upload/homework/20240520/abc123.pdf size_kb int NOT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;所有文件物理存储在服务器本地/upload/目录下没对接任何对象存储。这是双刃剑部署简单不用配 AK/SK但无法水平扩展。如果你要上线必须在application.yml中加配置upload: base-path: /home/online-edu/upload # 绝对路径需提前 mkdir -p且确保 Tomcat 进程对该路径有读写权限chown -R tomcat:tomcat /home/online-edu/upload否则上传永远返回 500。4. 启动失败的五大血泪现场从 NoClassDefFoundError 到 Thymeleaf 模板找不到即使你按文档配好 JDK、MySQL、IDEA90% 的人第一次启动仍会失败。这不是你手残而是源码里埋了几个“合理但易踩”的坑。下面是我实测记录的 5 条高频翻车点每条都按「现象 → 原因 → 解决」写清拒绝玄学。4.1 现象启动时报java.lang.NoClassDefFoundError: org/springframework/boot/context/properties/ConfigurationPropertiesBean原因Spring Boot 版本错配。根pom.xml声明spring-boot-starter-parent为2.7.18但你的 IDEA 默认用 JDK 17 编译而 Spring Boot 2.7.x 官方最低要求 JDK 8最高兼容 JDK 17 —— 表面没问题实则spring-boot-configuration-processor插件在 JDK 17 下生成的元数据有兼容性问题。解决在pom.xml的properties中强制指定编译级别properties java.version11/java.version !-- 改成 11不是 17 -- maven.compiler.source11/maven.compiler.source maven.compiler.target11/maven.compiler.target /properties并重启 IDEAFile → Project Structure → Project SDK 选 JDK 11。4.2 现象访问http://localhost:8080/login显示 Whitelabel Error Page控制台无 SQL 报错原因application.yml缺失或位置错误。Spring Boot 只认src/main/resources/下的application.yml或.properties而新手常把它放在src/main/java或根目录。更隐蔽的是文件编码不是 UTF-8带 BOM导致 YAML 解析失败Spring 退回到默认配置H2 内存库而CourseMapper.xml里全是 MySQL 语法一执行就崩。解决用 Notepad 或 VS Code 打开application.yml右下角确认编码是 “UTF-8 无 BOM”且文件路径严格为src/main/resources/application.yml。内容至少包含spring: datasource: url: jdbc:mysql://localhost:3306/online_edu?... username: root password: 123456 thymeleaf: cache: false # 开发时关缓存改模板不用重启4.3 现象登录成功后跳转http://localhost:8080/index页面空白浏览器 F12 看 Network 显示index.html404原因Thymeleaf 模板路径配置错误。Spring Boot 2.7.x 默认模板路径是src/main/resources/templates/但源码里index.html实际放在src/main/resources/static/这是放静态资源的目录。static/下的文件是直接映射的不走 Thymeleaf 解析所以index.html里写的th:fragmentcontent标签会被原样输出浏览器当无效 HTML 渲染为空白。解决把src/main/resources/static/index.html剪切到src/main/resources/templates/index.html并确认IndexController.java中return index;对应的就是这个路径。4.4 现象教师发布课程时status字段始终为 0草稿点“发布”按钮无反应Network 查看请求返回 200 但没数据原因前端 JS 绑定的status值写死。查看course-add.html发现提交表单的 JS 里有$.post(/course/publish, { title: $(#title).val(), status: 0 // 这里硬编码了 0 }, function(data){ ... });而实际应该根据按钮状态动态赋值“保存草稿”传 0“立即发布”传 1。解决找到course-add.html中对应按钮修改 JSbutton typebutton onclickpublishCourse(0)保存草稿/button button typebutton onclickpublishCourse(1)立即发布/button script function publishCourse(status) { $.post(/course/publish, { title: $(#title).val(), status: status // 动态传入 }, function(data){ ... }); } /script4.5 现象学生提交作业后file_info表有记录但/upload/目录下无 PDF 文件stored_path字段是空字符串原因MultipartFile参数名不匹配。HomeworkController.java中方法签名是PostMapping(/submit) public Result submit(RequestParam(file) MultipartFile file, ...) { ... }但前端homework-submit.html表单里input typefile namehomeworkFilename 是homeworkFile不是file导致 Spring MVC 绑定失败file.isEmpty()恒为 true。解决统一参数名。要么改前端input typefile namefile idhomeworkFile要么改 JavaPostMapping(/submit) public Result submit(RequestParam(homeworkFile) MultipartFile file, ...) { ... }5. 让作业提交链路真正闭环从 Controller 到数据库的七步追踪法很多教程教你“怎么写一个上传接口”但没人告诉你当学生点下“提交作业”按钮后数据到底经过了几层转换、在哪一步可能丢失、日志该看哪一行。下面我以HomeworkController.submit()为起点带你走完完整七步链路每步都标注关键日志位置和排查指令。这不是理论是我在某高校实训项目中帮 A 同学定位“作业总显示未提交”问题时的真实路径。5.1 第一步Controller 层接收请求校验文件非空HomeworkController.java第 87 行PostMapping(/submit) public Result submit( RequestParam(file) MultipartFile file, RequestParam(homeworkId) Long homeworkId, HttpServletRequest request) { if (file.isEmpty()) { return Result.fail(文件不能为空); } // ... }排查点如果返回文件不能为空立刻检查浏览器 Network → Payload确认file字段是否真的有二进制数据。若为空问题在前端表单enctypemultipart/form-data是否缺失或 JS 是否阻止了默认提交。5.2 第二步Service 层生成存储路径调用文件系统写入HomeworkServiceImpl.java第 124 行String originalName file.getOriginalFilename(); String extension FilenameUtils.getExtension(originalName); String storedPath /upload/homework/ DateUtil.format(new Date(), yyyyMMdd) / UUID.randomUUID().toString().replace(-, ) . extension; // 写入磁盘 File uploadDir new File(uploadBasePath /upload/homework/ DateUtil.format(new Date(), yyyyMMdd)); if (!uploadDir.exists()) uploadDir.mkdirs(); File dest new File(uploadDir, UUID.randomUUID().toString().replace(-, ) . extension); file.transferTo(dest); // 关键这行抛异常会中断流程排查点如果dest目录不存在mkdirs()会创建但若进程无权限transferTo()抛IOException。此时日志会打印Failed to transfer to file。用ls -ld /upload/homework/确认目录权限用ps -ef | grep java确认 Tomcat 进程用户然后chown -R tomcat:tomcat /upload。5.3 第三步Mapper 层插入 file_info 记录获取自增 IDHomeworkMapper.java接口定义int insertFileInfo(Param(homeworkId) Long homeworkId, Param(originalName) String originalName, Param(storedPath) String storedPath, Param(sizeKb) Integer sizeKb);对应HomeworkMapper.xml中insert idinsertFileInfo useGeneratedKeystrue keyPropertyid INSERT INTO file_info (homework_id, original_name, stored_path, size_kb) VALUES (#{homeworkId}, #{originalName}, #{storedPath}, #{sizeKb}) /insert注意useGeneratedKeystrue表示用数据库自增 ID 回填 Java 对象的id字段但源码中FileInfo实体类没定义id字段这意味着insertFileInfo()返回的是影响行数1不是新 ID。后续逻辑若依赖这个 ID如写入日志就会出错。这是源码一个隐性缺陷我已在本地补全FileInfo.setId()方法。5.4 第四步更新 homework 表 status 为 1已提交HomeworkMapper.xml中update idupdateStatusToSubmitted UPDATE homework SET status 1 WHERE id #{homeworkId} /update关键参数此 SQL 没加AND status 0条件。这意味着学生可以多次提交同一作业每次都会把status设为 1。正确做法是UPDATE homework SET status 1 WHERE id #{homeworkId} AND status 0否则updateStatusToSubmitted()返回 0没更新到行但 Controller 不检查返回值用户以为成功实际数据库没变。5.5 第五步事务边界在哪为什么文件写了但数据库没记录整个submit()方法加了Transactional但注意file.transferTo(dest)是 IO 操作不在数据库事务内。如果transferTo()成功insertFileInfo()失败如磁盘满事务回滚file_info不插入但 PDF 文件已写在磁盘上成为“孤儿文件”。源码没做文件清理补偿。生产环境必须加try { file.transferTo(dest); fileInfoMapper.insertFileInfo(...); } catch (Exception e) { if (dest.exists()) dest.delete(); // 回滚时删文件 throw e; }5.6 第六步前端如何知道提交成功Result 对象的结构陷阱Result.java定义public class Result { private Boolean success; private String message; private Object data; // 任意类型 }submit()方法返回return Result.ok().message(提交成功).data(fileInfo.getId());但前端 JS 期望data是{id: 123}而fileInfo.getId()是null因前面useGeneratedKeys未生效导致 JS 解析data.id为undefined无法跳转详情页。解决要么修复FileInfo实体类要么改返回return Result.ok().message(提交成功).data(Map.of(fileId, fileId));5.7 第七步最终验证——用一条 SQL 确认闭环当一切配置就绪执行这条 SQL结果应返回 1 行SELECT h.title, h.status, f.original_name, f.stored_path FROM homework h JOIN file_info f ON h.id f.homework_id WHERE h.id ? AND h.status 2; -- status2 表示已批阅闭环完成如果查不到按顺序检查homework表status是否真被更新SELECT * FROM homework WHERE id ?file_info表是否有对应homework_idSELECT * FROM file_info WHERE homework_id ?stored_path对应的文件物理存在ls -l /upload/homework/20240520/xxx.pdf从那以后我每次帮学生调作业提交功能都强制走一遍这七步先看 Controller 日志确认进来了再查数据库确认 status 更新了最后ls看文件在不在。少走一步就得多花两小时在玄学问题上兜圈子。希望帮到你。本文还有配套的精品资源点击获取