尧图网页设计 
简介本资源为基于Spring Boot框架与MySQL数据库的教学辅助平台完整项目资料面向教育机构管理人员、教师、学生及需要完成同类课程设计或毕业设计的开发者。项目采用B/S架构涵盖管理员、教师、学生三类角色包含个人中心、学生管理、教师管理、课程信息管理、科目分类管理、班级分类管理、课程作业管理及交流论坛等核心模块可帮助读者理解权限管理、数据验证与前后端分离的实现思路。压缩包共805个文件约18.86MB以Java源码、Vue组件、JavaScript脚本、HTML页面、CSS样式及SVG、GIF、JPG等静态资源为主另含SQL数据库脚本、XML配置、Maven构建文件与项目说明文档目录结构清晰便于按模块查阅与二次开发。目前已有36人学习下载适合作为教学辅助平台信息化管理的参考案例也可用于课程设计、毕业设计及项目实战练习。1. 教学辅助平台为什么总在“能跑”和“能用”之间翻车很多做教育信息化的团队都有过这种经历用 Spring Boot 搭一个教学辅助平台本地跑通只要两天交给老师试用却撑不过一周。课程资源传上去乱码、学生提交的作业在数据库里对不上号、论文里写的“智能推荐”到了真实班级里推的全是无关内容。问题不在 Spring Boot 本身而在于教学场景对数据一致性、角色权限和资源生命周期的要求远比一个 CRUD 后台复杂。这个标题指向的是一套完整的毕业设计级交付物Spring Boot 后端、教学辅助平台业务、项目源码、论文、数据库脚本和文档说明。它适合两类人——正在做教育信息化选题的学生需要一套能讲清架构、能跑通流程、能写进论文的参考实现以及刚接手校园系统维护的初级开发想搞清楚教学平台的数据模型和权限边界到底该怎么划。接下来我会按“业务怎么拆 → 库表怎么建 → 接口怎么写 → 坑怎么避”的顺序把一套可复现的方案讲透。2. 教学辅助平台的业务边界与角色拆解2.1 先定角色再谈功能教师、学生、管理员的三条主线教学辅助平台最容易犯的错是把“教务管理”和“教学辅助”混在一起。教务管的是排课、学籍、考试安排教学辅助管的是课程资源、作业提交、答疑互动、学习进度。这两者的数据模型和权限粒度完全不同。我一般会把角色收敛到三个管理员负责用户和课程元数据教师负责课程内容与作业批改学生负责学习和提交。三条主线的核心动作可以这样拆管理员创建院系、专业、班级导入用户分配课程归属。不碰具体教学内容。教师建课程、传资源、布置作业、批改、发布通知、查看班级学习统计。学生选课、看资源、交作业、看批改结果、参与讨论。提示如果选题要求里出现“排课”“成绩单打印”这类词建议单独开一个教务模块不要和教学辅助混在同一套权限表里否则后期论文里的 E-R 图会非常难画。2.2 功能模块的优先级排序哪些必须做哪些可以砍毕业设计周期通常只有 8 到 12 周功能贪多必翻车。按“论文能写、演示能跑、代码能讲”三个标准我建议的优先级是优先级模块理由P0用户与角色权限所有功能的基础论文必写P0课程管理平台的核心对象P0资源上传与下载教学辅助最直观的体现P1作业发布与提交能体现业务流程闭环P1通知公告实现简单演示效果好P2讨论区/答疑加分项但并发和内容审核要考虑P2学习统计论文里可以写“数据分析”但别吹成 AI砍掉“智能推荐”“情感分析”这类词除非你真的有标注数据和可解释的算法。答辩老师问一句“推荐依据是什么”答不上来比不做还减分。2.3 技术选型Spring Boot MyBatis 还是 JPA标题里只写了 Spring Boot但数据库访问层必须选一个。教学辅助平台的数据关系比较规整——用户、课程、作业、提交记录表间关联明确查询以多条件分页为主。这种场景下 MyBatis 的 XML 映射更直观论文里贴 SQL 也方便解释。如果选 JPA实体关联和懒加载在答辩时容易被追问“N1 问题怎么解决”。MyBatis 虽然要手写 SQL但每一步都可控。我一般会这样配# application.yml 关键配置 spring: datasource: url: jdbc:mysql://localhost:3306/edu_platform?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 50MB max-request-size: 100MB mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.edu.entity configuration: map-underscore-to-camel-case: truemap-underscore-to-camel-case一定要开否则数据库的create_time映射到实体createTime会失败这是血泪经验。max-file-size根据实际资源类型调整如果允许传视频建议单独走对象存储不要塞进数据库。3. 数据库设计从 E-R 图到可执行的建表脚本3.1 核心表结构与字段取舍教学辅助平台的库表不用多但字段要经得起追问。下面是我常用的六张核心表-- 用户表不拆教师表和学生表用 role 区分 CREATE TABLE sys_user ( id BIGINT NOT NULL AUTO_INCREMENT, username VARCHAR(50) NOT NULL COMMENT 登录名, password VARCHAR(100) NOT NULL COMMENT BCrypt加密, real_name VARCHAR(50) DEFAULT NULL, role TINYINT NOT NULL COMMENT 1管理员 2教师 3学生, class_id BIGINT DEFAULT NULL COMMENT 学生所属班级, status TINYINT DEFAULT 1 COMMENT 1正常 0禁用, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 课程表 CREATE TABLE course ( id BIGINT NOT NULL AUTO_INCREMENT, course_name VARCHAR(100) NOT NULL, teacher_id BIGINT NOT NULL, cover_url VARCHAR(255) DEFAULT NULL, description TEXT, status TINYINT DEFAULT 1 COMMENT 1进行中 0已结课, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, 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, join_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_course_student (course_id, student_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 资源表 CREATE TABLE resource ( id BIGINT NOT NULL AUTO_INCREMENT, course_id BIGINT NOT NULL, file_name VARCHAR(200) NOT NULL, file_path VARCHAR(500) NOT NULL, file_size BIGINT DEFAULT 0, uploader_id BIGINT NOT NULL, download_count INT DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_course (course_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 作业表 CREATE TABLE homework ( id BIGINT NOT NULL AUTO_INCREMENT, course_id BIGINT NOT NULL, title VARCHAR(200) NOT NULL, content TEXT, deadline DATETIME NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_course (course_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 作业提交表 CREATE TABLE homework_submit ( id BIGINT NOT NULL AUTO_INCREMENT, homework_id BIGINT NOT NULL, student_id BIGINT NOT NULL, file_path VARCHAR(500) DEFAULT NULL, content TEXT, score DECIMAL(5,2) DEFAULT NULL, comment VARCHAR(500) DEFAULT NULL, submit_time DATETIME DEFAULT CURRENT_TIMESTAMP, status TINYINT DEFAULT 0 COMMENT 0未批改 1已批改, PRIMARY KEY (id), UNIQUE KEY uk_homework_student (homework_id, student_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;几个关键取舍用户表不拆教师和学生用role字段区分减少关联查询选课关系用独立表方便统计和扩展作业提交表加唯一索引防止同一学生重复提交同一作业。utf8mb4是必须的否则学生姓名里的生僻字会变问号。3.2 索引与约束哪些字段必须加哪些加了反而拖慢教学辅助平台的查询热点很明确按课程查资源、按学生查作业、按教师查课程。所以course_id、student_id、teacher_id这三个外键字段必须加普通索引。但不要给status这种低基数字段单独加索引选择性太差MySQL 优化器大概率不走。唯一约束比索引更重要。course_student表的(course_id, student_id)唯一键能防止重复选课homework_submit表的(homework_id, student_id)唯一键能防止重复提交。这两个约束在业务层也要做校验但数据库层是最后一道防线。注意如果论文里要写“数据库优化”别只写“加了索引”。要写清楚加了哪个索引、为什么加、用EXPLAIN验证前后扫描行数的变化。没有验证数据的优化描述答辩时容易被问住。3.3 初始化数据与测试数据分离建表脚本和初始化数据要分开。schema.sql只建表data.sql只插测试数据。测试数据至少包含1 个管理员、2 个教师、10 个学生、3 门课程、每门课 5 条资源、2 次作业、若干提交记录。这样演示时每个页面都有内容不会出现空列表。-- data.sql 片段密码统一为 123456 的 BCrypt 值 INSERT INTO sys_user (username, password, real_name, role) VALUES (admin, $2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKIUi, 系统管理员, 1), (teacher1, $2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKIUi, 张老师, 2), (student1, $2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKIUi, 李同学, 3);BCrypt 值不要自己编用BCryptPasswordEncoder生成一次复制进去。我见过有人直接写明文密码答辩时被问“安全性怎么保证”场面很尴尬。4. 接口实现从登录鉴权到文件上传的完整链路4.1 登录与 JWT 鉴权的最小实现教学辅助平台的接口分两类公开的登录接口和需要鉴权的业务接口。用 Spring Security 配 JWT 是常见做法但配置类容易写臃肿。我一般会拆成三个部分SecurityConfig管过滤链JwtUtil管令牌生成和解析JwtFilter管请求拦截。// JwtUtil 核心方法 public String generateToken(Long userId, String username, Integer role) { MapString, Object claims new HashMap(); claims.put(userId, userId); claims.put(username, username); claims.put(role, role); return Jwts.builder() .setClaims(claims) .setSubject(username) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() 86400000)) // 24小时 .signWith(SignatureAlgorithm.HS256, SECRET) .compact(); } public Claims parseToken(String token) { return Jwts.parser() .setSigningKey(SECRET) .parseClaimsJws(token) .getBody(); }SECRET不要硬编码在代码里放到application.yml里用Value注入。过期时间根据演示场景设24 小时足够太短会导致演示中途掉线太长不符合安全规范。4.2 课程与资源的 CRUD 接口课程接口的核心是分页查询和权限过滤。教师只能看自己创建的课程学生只能看自己选的课程管理员看全部。这个逻辑不要写在 Controller 里放到 Service 层用role判断。// CourseService 分页查询片段 public PageInfoCourseVO listCourses(Integer pageNum, Integer pageSize, Long userId, Integer role) { PageHelper.startPage(pageNum, pageSize); ListCourseVO list; if (role 1) { list courseMapper.selectAll(); } else if (role 2) { list courseMapper.selectByTeacherId(userId); } else { list courseMapper.selectByStudentId(userId); } return new PageInfo(list); }PageHelper的startPage必须紧挨着查询语句中间不要插其他数据库操作否则分页会乱。这是 MyBatis 分页最常见的坑。资源上传接口要注意文件存储路径。不要存在项目根目录下否则重新部署就丢了。我一般会在application.yml里配一个绝对路径file: upload-path: /data/edu-platform/upload/// 文件上传核心逻辑 public String uploadFile(MultipartFile file, Long courseId, Long uploaderId) { String originalName file.getOriginalFilename(); String suffix originalName.substring(originalName.lastIndexOf(.)); String newName UUID.randomUUID().toString() suffix; File dest new File(uploadPath newName); if (!dest.getParentFile().exists()) { dest.getParentFile().mkdirs(); } file.transferTo(dest); // 保存记录到 resource 表 Resource resource new Resource(); resource.setCourseId(courseId); resource.setFileName(originalName); resource.setFilePath(newName); resource.setFileSize(file.getSize()); resource.setUploaderId(uploaderId); resourceMapper.insert(resource); return newName; }文件名用 UUID 重命名避免中文名和特殊字符导致的路径问题。原始文件名存数据库下载时再还原。4.3 作业提交与批改的状态流转作业模块的状态流转是论文里能写出东西的地方。学生提交后状态为“未批改”教师批改后变为“已批改”同时记录分数和评语。这里要注意并发两个学生同时提交同一份作业唯一索引会拦住第二个但前端要给出友好提示。// 提交作业 public void submitHomework(Long homeworkId, Long studentId, MultipartFile file, String content) { HomeworkSubmit exist submitMapper.selectByHomeworkAndStudent(homeworkId, studentId); if (exist ! null) { throw new BusinessException(您已提交过该作业请勿重复提交); } // 检查截止时间 Homework homework homeworkMapper.selectById(homeworkId); if (new Date().after(homework.getDeadline())) { throw new BusinessException(已超过截止时间); } // 保存文件和记录... }截止时间判断要在服务端做前端的时间校验可以被绕过。BusinessException配合全局异常处理器返回统一格式前端好处理。5. 避坑与排查教学辅助平台落地时最容易翻车的五件事5.1 中文乱码从数据库到前端的三层排查现象资源文件名、课程描述里的中文显示为问号或乱码。原因数据库字符集不是utf8mb4或者 JDBC 连接串没加characterEncodingutf8或者前端请求头没带charsetUTF-8。解决建库时指定CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci连接串加useUnicodetruecharacterEncodingutf8Spring Boot 配置spring.http.encoding.forcetrue。三层都查一遍缺一不可。5.2 文件上传后无法下载路径拼接的常见错误现象上传成功数据库有记录但下载接口返回 404 或空文件。原因存储路径用了相对路径或者file_path存的是完整路径但下载时又拼了一次上传目录。解决数据库只存文件名下载时用uploadPath fileName拼接。如果用了 Nginx 做静态资源代理要确保alias或root指向正确。我一般会在下载接口里加日志打印最终拼接的绝对路径一眼就能看出问题。5.3 分页查询总数不对PageHelper 的线程安全问题现象第一页总数正确翻到第二页总数变了或者多个用户同时查询时总数串了。原因PageHelper.startPage把分页参数放到了 ThreadLocal 里如果查询语句执行前有别的数据库操作或者用了异步分页参数会被消费掉或错乱。解决startPage之后立刻执行查询中间不要插任何 Mapper 调用。如果用了CompletableFuture做异步查询分页参数不会传递需要手动处理。5.4 权限越界学生能访问教师接口现象用学生账号的 token 能调用教师才能用的批改接口。原因只在 Controller 方法上加了PreAuthorize但没在 SecurityConfig 里开启方法级注解或者 JWT 里的 role 字段没被正确解析。解决EnableGlobalMethodSecurity(prePostEnabled true)必须加JwtFilter 里解析出 role 后要放到SecurityContext的Authentication里接口上写PreAuthorize(hasRole(TEACHER))。注意hasRole会自动加ROLE_前缀数据库里存的 role 值要对应上。5.5 数据库连接池耗尽演示时的突发并发现象答辩演示时多个老师同时点系统卡死日志报Connection is not available。原因HikariCP 默认最大连接数是 10演示环境够用但如果有人写了循环里查数据库的代码连接会被迅速占满。解决检查代码里有没有在 for 循环里调 Mapper 的情况改成批量查询。application.yml里适当调大maximum-pool-size但不要超过数据库的max_connections。演示前重启一次应用确保连接池是干净的。6. 论文与文档的写法让代码之外的部分也经得起看6.1 论文结构怎么对应代码模块毕业设计的论文不是代码说明书但必须和代码对得上。我一般建议按这个映射来写论文章节对应代码/文档需求分析功能模块图、用例图系统设计E-R 图、架构图、接口清单详细实现核心类图、关键代码片段测试测试用例表、接口测试截图数据库设计建表脚本、字段说明表关键代码片段不要贴整个类贴核心方法配上注释说明。截图要清晰接口测试用 Postman 或 Swagger 的响应截图不要用控制台日志截图。6.2 文档说明里必须写清楚的三个参数文档说明不是 README 的复制。它要能让一个没接触过项目的人跑起来。必须写清楚数据库连接参数地址、端口、库名、用户名密码、文件上传路径绝对路径以及需要手动创建的目录、启动端口和访问地址。这三个参数缺一个别人就得多花半小时排查。# 启动命令示例 mvn clean package -DskipTests java -jar target/edu-platform-1.0.jar --spring.profiles.activedev如果用了dev和prod多环境配置文档里要说明默认激活哪个以及怎么切换。不要假设读者知道--spring.profiles.active的用法。6.3 源码打包与数据库脚本的交付习惯源码打包前把target目录、.idea目录、*.iml文件删掉只留src、pom.xml、sql脚本和文档。数据库脚本按schema.sql和data.sql分开文件名不要用中文。如果论文里引用了某个版本的依赖pom.xml里要锁死版本号不要用LATEST。我自己的习惯是交付前在一台干净的机器上从零开始按文档走一遍。建库、导数据、改配置、启动、登录、走一遍核心流程。这一步能发现 90% 的“在我电脑上能跑”问题。希望帮到你。本文还有配套的精品资源点击获取 Spring Boot教学辅助平台实战：从数据库设计到接口实现与避坑指南
简介本资源为基于Spring Boot框架与MySQL数据库的教学辅助平台完整项目资料面向教育机构管理人员、教师、学生及需要完成同类课程设计或毕业设计的开发者。项目采用B/S架构涵盖管理员、教师、学生三类角色包含个人中心、学生管理、教师管理、课程信息管理、科目分类管理、班级分类管理、课程作业管理及交流论坛等核心模块可帮助读者理解权限管理、数据验证与前后端分离的实现思路。压缩包共805个文件约18.86MB以Java源码、Vue组件、JavaScript脚本、HTML页面、CSS样式及SVG、GIF、JPG等静态资源为主另含SQL数据库脚本、XML配置、Maven构建文件与项目说明文档目录结构清晰便于按模块查阅与二次开发。目前已有36人学习下载适合作为教学辅助平台信息化管理的参考案例也可用于课程设计、毕业设计及项目实战练习。1. 教学辅助平台为什么总在“能跑”和“能用”之间翻车很多做教育信息化的团队都有过这种经历用 Spring Boot 搭一个教学辅助平台本地跑通只要两天交给老师试用却撑不过一周。课程资源传上去乱码、学生提交的作业在数据库里对不上号、论文里写的“智能推荐”到了真实班级里推的全是无关内容。问题不在 Spring Boot 本身而在于教学场景对数据一致性、角色权限和资源生命周期的要求远比一个 CRUD 后台复杂。这个标题指向的是一套完整的毕业设计级交付物Spring Boot 后端、教学辅助平台业务、项目源码、论文、数据库脚本和文档说明。它适合两类人——正在做教育信息化选题的学生需要一套能讲清架构、能跑通流程、能写进论文的参考实现以及刚接手校园系统维护的初级开发想搞清楚教学平台的数据模型和权限边界到底该怎么划。接下来我会按“业务怎么拆 → 库表怎么建 → 接口怎么写 → 坑怎么避”的顺序把一套可复现的方案讲透。2. 教学辅助平台的业务边界与角色拆解2.1 先定角色再谈功能教师、学生、管理员的三条主线教学辅助平台最容易犯的错是把“教务管理”和“教学辅助”混在一起。教务管的是排课、学籍、考试安排教学辅助管的是课程资源、作业提交、答疑互动、学习进度。这两者的数据模型和权限粒度完全不同。我一般会把角色收敛到三个管理员负责用户和课程元数据教师负责课程内容与作业批改学生负责学习和提交。三条主线的核心动作可以这样拆管理员创建院系、专业、班级导入用户分配课程归属。不碰具体教学内容。教师建课程、传资源、布置作业、批改、发布通知、查看班级学习统计。学生选课、看资源、交作业、看批改结果、参与讨论。提示如果选题要求里出现“排课”“成绩单打印”这类词建议单独开一个教务模块不要和教学辅助混在同一套权限表里否则后期论文里的 E-R 图会非常难画。2.2 功能模块的优先级排序哪些必须做哪些可以砍毕业设计周期通常只有 8 到 12 周功能贪多必翻车。按“论文能写、演示能跑、代码能讲”三个标准我建议的优先级是优先级模块理由P0用户与角色权限所有功能的基础论文必写P0课程管理平台的核心对象P0资源上传与下载教学辅助最直观的体现P1作业发布与提交能体现业务流程闭环P1通知公告实现简单演示效果好P2讨论区/答疑加分项但并发和内容审核要考虑P2学习统计论文里可以写“数据分析”但别吹成 AI砍掉“智能推荐”“情感分析”这类词除非你真的有标注数据和可解释的算法。答辩老师问一句“推荐依据是什么”答不上来比不做还减分。2.3 技术选型Spring Boot MyBatis 还是 JPA标题里只写了 Spring Boot但数据库访问层必须选一个。教学辅助平台的数据关系比较规整——用户、课程、作业、提交记录表间关联明确查询以多条件分页为主。这种场景下 MyBatis 的 XML 映射更直观论文里贴 SQL 也方便解释。如果选 JPA实体关联和懒加载在答辩时容易被追问“N1 问题怎么解决”。MyBatis 虽然要手写 SQL但每一步都可控。我一般会这样配# application.yml 关键配置 spring: datasource: url: jdbc:mysql://localhost:3306/edu_platform?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 50MB max-request-size: 100MB mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.edu.entity configuration: map-underscore-to-camel-case: truemap-underscore-to-camel-case一定要开否则数据库的create_time映射到实体createTime会失败这是血泪经验。max-file-size根据实际资源类型调整如果允许传视频建议单独走对象存储不要塞进数据库。3. 数据库设计从 E-R 图到可执行的建表脚本3.1 核心表结构与字段取舍教学辅助平台的库表不用多但字段要经得起追问。下面是我常用的六张核心表-- 用户表不拆教师表和学生表用 role 区分 CREATE TABLE sys_user ( id BIGINT NOT NULL AUTO_INCREMENT, username VARCHAR(50) NOT NULL COMMENT 登录名, password VARCHAR(100) NOT NULL COMMENT BCrypt加密, real_name VARCHAR(50) DEFAULT NULL, role TINYINT NOT NULL COMMENT 1管理员 2教师 3学生, class_id BIGINT DEFAULT NULL COMMENT 学生所属班级, status TINYINT DEFAULT 1 COMMENT 1正常 0禁用, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 课程表 CREATE TABLE course ( id BIGINT NOT NULL AUTO_INCREMENT, course_name VARCHAR(100) NOT NULL, teacher_id BIGINT NOT NULL, cover_url VARCHAR(255) DEFAULT NULL, description TEXT, status TINYINT DEFAULT 1 COMMENT 1进行中 0已结课, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, 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, join_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_course_student (course_id, student_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 资源表 CREATE TABLE resource ( id BIGINT NOT NULL AUTO_INCREMENT, course_id BIGINT NOT NULL, file_name VARCHAR(200) NOT NULL, file_path VARCHAR(500) NOT NULL, file_size BIGINT DEFAULT 0, uploader_id BIGINT NOT NULL, download_count INT DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_course (course_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 作业表 CREATE TABLE homework ( id BIGINT NOT NULL AUTO_INCREMENT, course_id BIGINT NOT NULL, title VARCHAR(200) NOT NULL, content TEXT, deadline DATETIME NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_course (course_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 作业提交表 CREATE TABLE homework_submit ( id BIGINT NOT NULL AUTO_INCREMENT, homework_id BIGINT NOT NULL, student_id BIGINT NOT NULL, file_path VARCHAR(500) DEFAULT NULL, content TEXT, score DECIMAL(5,2) DEFAULT NULL, comment VARCHAR(500) DEFAULT NULL, submit_time DATETIME DEFAULT CURRENT_TIMESTAMP, status TINYINT DEFAULT 0 COMMENT 0未批改 1已批改, PRIMARY KEY (id), UNIQUE KEY uk_homework_student (homework_id, student_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;几个关键取舍用户表不拆教师和学生用role字段区分减少关联查询选课关系用独立表方便统计和扩展作业提交表加唯一索引防止同一学生重复提交同一作业。utf8mb4是必须的否则学生姓名里的生僻字会变问号。3.2 索引与约束哪些字段必须加哪些加了反而拖慢教学辅助平台的查询热点很明确按课程查资源、按学生查作业、按教师查课程。所以course_id、student_id、teacher_id这三个外键字段必须加普通索引。但不要给status这种低基数字段单独加索引选择性太差MySQL 优化器大概率不走。唯一约束比索引更重要。course_student表的(course_id, student_id)唯一键能防止重复选课homework_submit表的(homework_id, student_id)唯一键能防止重复提交。这两个约束在业务层也要做校验但数据库层是最后一道防线。注意如果论文里要写“数据库优化”别只写“加了索引”。要写清楚加了哪个索引、为什么加、用EXPLAIN验证前后扫描行数的变化。没有验证数据的优化描述答辩时容易被问住。3.3 初始化数据与测试数据分离建表脚本和初始化数据要分开。schema.sql只建表data.sql只插测试数据。测试数据至少包含1 个管理员、2 个教师、10 个学生、3 门课程、每门课 5 条资源、2 次作业、若干提交记录。这样演示时每个页面都有内容不会出现空列表。-- data.sql 片段密码统一为 123456 的 BCrypt 值 INSERT INTO sys_user (username, password, real_name, role) VALUES (admin, $2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKIUi, 系统管理员, 1), (teacher1, $2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKIUi, 张老师, 2), (student1, $2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKIUi, 李同学, 3);BCrypt 值不要自己编用BCryptPasswordEncoder生成一次复制进去。我见过有人直接写明文密码答辩时被问“安全性怎么保证”场面很尴尬。4. 接口实现从登录鉴权到文件上传的完整链路4.1 登录与 JWT 鉴权的最小实现教学辅助平台的接口分两类公开的登录接口和需要鉴权的业务接口。用 Spring Security 配 JWT 是常见做法但配置类容易写臃肿。我一般会拆成三个部分SecurityConfig管过滤链JwtUtil管令牌生成和解析JwtFilter管请求拦截。// JwtUtil 核心方法 public String generateToken(Long userId, String username, Integer role) { MapString, Object claims new HashMap(); claims.put(userId, userId); claims.put(username, username); claims.put(role, role); return Jwts.builder() .setClaims(claims) .setSubject(username) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() 86400000)) // 24小时 .signWith(SignatureAlgorithm.HS256, SECRET) .compact(); } public Claims parseToken(String token) { return Jwts.parser() .setSigningKey(SECRET) .parseClaimsJws(token) .getBody(); }SECRET不要硬编码在代码里放到application.yml里用Value注入。过期时间根据演示场景设24 小时足够太短会导致演示中途掉线太长不符合安全规范。4.2 课程与资源的 CRUD 接口课程接口的核心是分页查询和权限过滤。教师只能看自己创建的课程学生只能看自己选的课程管理员看全部。这个逻辑不要写在 Controller 里放到 Service 层用role判断。// CourseService 分页查询片段 public PageInfoCourseVO listCourses(Integer pageNum, Integer pageSize, Long userId, Integer role) { PageHelper.startPage(pageNum, pageSize); ListCourseVO list; if (role 1) { list courseMapper.selectAll(); } else if (role 2) { list courseMapper.selectByTeacherId(userId); } else { list courseMapper.selectByStudentId(userId); } return new PageInfo(list); }PageHelper的startPage必须紧挨着查询语句中间不要插其他数据库操作否则分页会乱。这是 MyBatis 分页最常见的坑。资源上传接口要注意文件存储路径。不要存在项目根目录下否则重新部署就丢了。我一般会在application.yml里配一个绝对路径file: upload-path: /data/edu-platform/upload/// 文件上传核心逻辑 public String uploadFile(MultipartFile file, Long courseId, Long uploaderId) { String originalName file.getOriginalFilename(); String suffix originalName.substring(originalName.lastIndexOf(.)); String newName UUID.randomUUID().toString() suffix; File dest new File(uploadPath newName); if (!dest.getParentFile().exists()) { dest.getParentFile().mkdirs(); } file.transferTo(dest); // 保存记录到 resource 表 Resource resource new Resource(); resource.setCourseId(courseId); resource.setFileName(originalName); resource.setFilePath(newName); resource.setFileSize(file.getSize()); resource.setUploaderId(uploaderId); resourceMapper.insert(resource); return newName; }文件名用 UUID 重命名避免中文名和特殊字符导致的路径问题。原始文件名存数据库下载时再还原。4.3 作业提交与批改的状态流转作业模块的状态流转是论文里能写出东西的地方。学生提交后状态为“未批改”教师批改后变为“已批改”同时记录分数和评语。这里要注意并发两个学生同时提交同一份作业唯一索引会拦住第二个但前端要给出友好提示。// 提交作业 public void submitHomework(Long homeworkId, Long studentId, MultipartFile file, String content) { HomeworkSubmit exist submitMapper.selectByHomeworkAndStudent(homeworkId, studentId); if (exist ! null) { throw new BusinessException(您已提交过该作业请勿重复提交); } // 检查截止时间 Homework homework homeworkMapper.selectById(homeworkId); if (new Date().after(homework.getDeadline())) { throw new BusinessException(已超过截止时间); } // 保存文件和记录... }截止时间判断要在服务端做前端的时间校验可以被绕过。BusinessException配合全局异常处理器返回统一格式前端好处理。5. 避坑与排查教学辅助平台落地时最容易翻车的五件事5.1 中文乱码从数据库到前端的三层排查现象资源文件名、课程描述里的中文显示为问号或乱码。原因数据库字符集不是utf8mb4或者 JDBC 连接串没加characterEncodingutf8或者前端请求头没带charsetUTF-8。解决建库时指定CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci连接串加useUnicodetruecharacterEncodingutf8Spring Boot 配置spring.http.encoding.forcetrue。三层都查一遍缺一不可。5.2 文件上传后无法下载路径拼接的常见错误现象上传成功数据库有记录但下载接口返回 404 或空文件。原因存储路径用了相对路径或者file_path存的是完整路径但下载时又拼了一次上传目录。解决数据库只存文件名下载时用uploadPath fileName拼接。如果用了 Nginx 做静态资源代理要确保alias或root指向正确。我一般会在下载接口里加日志打印最终拼接的绝对路径一眼就能看出问题。5.3 分页查询总数不对PageHelper 的线程安全问题现象第一页总数正确翻到第二页总数变了或者多个用户同时查询时总数串了。原因PageHelper.startPage把分页参数放到了 ThreadLocal 里如果查询语句执行前有别的数据库操作或者用了异步分页参数会被消费掉或错乱。解决startPage之后立刻执行查询中间不要插任何 Mapper 调用。如果用了CompletableFuture做异步查询分页参数不会传递需要手动处理。5.4 权限越界学生能访问教师接口现象用学生账号的 token 能调用教师才能用的批改接口。原因只在 Controller 方法上加了PreAuthorize但没在 SecurityConfig 里开启方法级注解或者 JWT 里的 role 字段没被正确解析。解决EnableGlobalMethodSecurity(prePostEnabled true)必须加JwtFilter 里解析出 role 后要放到SecurityContext的Authentication里接口上写PreAuthorize(hasRole(TEACHER))。注意hasRole会自动加ROLE_前缀数据库里存的 role 值要对应上。5.5 数据库连接池耗尽演示时的突发并发现象答辩演示时多个老师同时点系统卡死日志报Connection is not available。原因HikariCP 默认最大连接数是 10演示环境够用但如果有人写了循环里查数据库的代码连接会被迅速占满。解决检查代码里有没有在 for 循环里调 Mapper 的情况改成批量查询。application.yml里适当调大maximum-pool-size但不要超过数据库的max_connections。演示前重启一次应用确保连接池是干净的。6. 论文与文档的写法让代码之外的部分也经得起看6.1 论文结构怎么对应代码模块毕业设计的论文不是代码说明书但必须和代码对得上。我一般建议按这个映射来写论文章节对应代码/文档需求分析功能模块图、用例图系统设计E-R 图、架构图、接口清单详细实现核心类图、关键代码片段测试测试用例表、接口测试截图数据库设计建表脚本、字段说明表关键代码片段不要贴整个类贴核心方法配上注释说明。截图要清晰接口测试用 Postman 或 Swagger 的响应截图不要用控制台日志截图。6.2 文档说明里必须写清楚的三个参数文档说明不是 README 的复制。它要能让一个没接触过项目的人跑起来。必须写清楚数据库连接参数地址、端口、库名、用户名密码、文件上传路径绝对路径以及需要手动创建的目录、启动端口和访问地址。这三个参数缺一个别人就得多花半小时排查。# 启动命令示例 mvn clean package -DskipTests java -jar target/edu-platform-1.0.jar --spring.profiles.activedev如果用了dev和prod多环境配置文档里要说明默认激活哪个以及怎么切换。不要假设读者知道--spring.profiles.active的用法。6.3 源码打包与数据库脚本的交付习惯源码打包前把target目录、.idea目录、*.iml文件删掉只留src、pom.xml、sql脚本和文档。数据库脚本按schema.sql和data.sql分开文件名不要用中文。如果论文里引用了某个版本的依赖pom.xml里要锁死版本号不要用LATEST。我自己的习惯是交付前在一台干净的机器上从零开始按文档走一遍。建库、导数据、改配置、启动、登录、走一遍核心流程。这一步能发现 90% 的“在我电脑上能跑”问题。希望帮到你。本文还有配套的精品资源点击获取