1. 需求分析先行课程作业管理系统到底要解决什么1.1 从真实教务痛点出发梳理核心流程每到期末季总有人被课程设计折磨得够呛。选课程作业和实验管理系统这个题目的同学很多但真正把需求理清楚的没几个。如果不做需求分析直接开写最后做出来的往往是一个看起来什么都能点、实际上到处漏风的半成品。先从最原始的线下场景聊起。一个老师带两三个班每门课布置五次作业、三次实验。作业收上来是Word文档命名从张三-作业1到新建文件夹(2).zip什么都有。老师要下载、解压、改名、逐个批改最后再把成绩录入Excel。学生这边更烦躁——作业文件发到微信群三天过期换了电脑找不到自己的提交记录想看看老师批改意见还得等下次上课。线上系统要解决的就是这几件事老师创建课程并导入学生名单在课程下发布作业或实验任务并设置截止时间学生在截止前上传实验报告和代码文件老师查看提交、下载文件、在线打分填评语学生查看自己的成绩和反馈系统管理员维护用户、课程和基础数据。把这个闭环拆开系统的核心模块就清晰了课程管理模块、作业与实验发布模块、文件提交与存储模块、在线批改与成绩管理模块、用户与权限模块。在动数据库设计之前我建议先把流程图画出来。不要求画得多专业关键是理解数据是怎么流动的教师创建作业后产生一条作业记录学生提交后产生一条提交记录教师批改后产生一条成绩记录。这三条记录串起来就是整个系统的数据主线。1.2 三种角色的功能清单与权限边界课程作业管理系统天然有三种角色不同角色看到的内容和能执行的操作完全不同。管理员的功能集中在基础数据维护用户管理、角色分配、课程信息管理、账号启停用、系统公告发布。教师的功能是业务核心课程信息维护、学生名单导入、作业与实验发布、提交情况查询、待批改列表、打分与评语、成绩导出。注意教师只能看到自己课程的作业和批改不能越权操作别的课程。学生端功能少一些查看我的课程和作业任务清单、提交或重新提交作业文件、查看批改结果和反馈评语。学生只能查自己的成绩不能看到其他人的分数。这里有个很多课程设计容易犯的错只做了登录页面但登录后所有接口都能访问。学生直接调用教师批改接口就能给自己改成绩整个权限设计形同虚设。所以权限控制一定要在系统设计阶段就作为独立模块规划。源码里用角色字段配合接口拦截来处理具体实现我放到权限章节细讲。1.3 非功能性需求并发不高但要稳、要严这类系统的并发量并不高一个学校几千学生同时提交属于极端场景普通本科院校一个课程群几十上百人后端完全抗得住。真正的难度在容错提交文件时网络中断不能导致文件损坏教师误操作批改后要有重新批改的空间截止时间过去后学生不能直接提交但特殊情况要求老师能手动开补交权限。把这三个细节做进去系统就比大多数课设完整。补交开关这个功能答辩时单独拿出来讲老师都会停下来追问几句天然加分。文件重新上传的幂等性也要处理同一学生同一作业重新提交应该覆盖旧提交记录而不是重复追加。2. 技术选型与源码结构为什么我选前后端分离2.1 技术栈全景与选型理由这套源码采用的技术组合是当前Java课程设计的主流阵容后端Spring Boot 3.x MyBatis-Plus MySQL 8前端Vue 3 Element Plus Axios鉴权用Spring Security JWT。选这套组合有充足的理由。Spring Boot是Java生态里做课设的第一选择资料多、示例全、踩坑信息好搜。MyBatis-Plus把单表CRUD工作量砍掉一半条件构造器和分页插件写起来非常顺畅数据访问层的代码量大幅减少。前端Vue 3配合Element Plus组件库表格、表单、上传组件全是现成的界面观感和交互体验比传统JSP页面高一个档次答辩演示效果好。MySQL作为数据库没有争议。对于这种数据量几百上千条的管理系统MySQL的性能和稳定性绰绰有余。2.2 前后端分离还是传统JSP取舍逻辑有人会问做个课程设计而已用JSP Servlet不是更简单确实简单但代价是牺牲体验。JSP时代的前端页面大多是JQuery手写DOM操作写列表要拼接字符串传参刷新页面观感和当代Web应用差距很大。答辩演示时评委看到的是一套像2008年的后台系统。前后端分离虽然要多维护一个Vue项目启动时要同时起两个服务但换来的是开发体验和演示效果的全面升级。更关键的是前后端分离结构可以直接写进论文架构设计和答辩PPT里技术分更高。企业主流开发模式就是这种结构课程设计提前接触没坏处。2.3 拿到源码后先看懂目录再动代码很多同学下载源码的第一步是直接点运行的按钮跑不起来就开始慌。我的建议是反过来先把目录结构看明白知道每个目录放了什么再谈运行。后端项目是标准Maven工程src/main/java/com/xx/edu/ ├── controller/ 接口层前端请求入口 ├── service/ 业务逻辑层核心业务处理 ├── mapper/ MyBatis-Plus数据访问层 ├── entity/ 数据库表对应的实体类 ├── config/ 配置类安全拦截器、跨域配置 └── common/ 统一返回结果、异常处理controller里的接口基本一一对应前端每个操作按钮比如AssignmentController负责作业的增删改查SubmissionController负责提交相关GradeController负责批改打分。实体类对应七张表名字和字段都能对上。前端Vue项目结构src/ ├── views/ 页面组件按角色分文件夹admin/teacher/student ├── api/ 接口请求封装一个页面一个JS文件 ├── router/ 路由配置控制页面跳转 ├── store/ Pinia状态管理存登录用户信息 └── utils/ Axios实例、请求拦截器只要把controller、views、SQL脚本三块看懂系统的完整脉络基本就通了。别被node_modules那些依赖吓到那只是Vue的依赖包和你的业务代码没关系。2.4 软件环境版本核对清单源码是完整可运行的但前提是环境一致。我遇到过太多人卡在版本问题上JDK版本低了启动报错、Node版本过新导致依赖安装失败、MySQL用了5.7但SQL脚本用了8.0的语法。跑之前先检查这几项JDK 17及以上、Maven 3.6、MySQL 8.x、Node.js 16及以上。工具版本确认没问题再往下走。3. 数据库设计七张核心表如何撑起整套系统3.1 用户表与角色标识的设计选择用户表sys_user是整个系统的地基字段包括user_id主键自增username登录名唯一passwordBCrypt加密后的密码不是明文real_name真实姓名用于展示role_id角色标识1管理员、2教师、3学生email/phone联系方式status账号状态1正常、0停用密码加密这一点我特别说明。有些课设资料用MD5存密码虽然比明文好一点但MD5已经算不安全了。Spring Security内置BCrypt加密做起来就是一行代码的事安全性也高几个量级。答辩被问到密码安全问题时直接说BCrypt加盐哈希老师不会追问太多。role_id用一个整数标识角色而不是建独立的角色表是个刻意的取舍。课程设计这种中小项目角色固定只有三种字段方式写起来最简单查询也不用跨表。代码里定义一个常量类统一管理角色值可读性完全没问题。如果较真一点想建角色表和权限表就成了RBAC模型功能更强复杂度也更高课设阶段没必要。3.2 课程表与选课关系中间表方案的正确姿势课程表course保存课程基础信息course_id主键course_name课程名称course_code课程编号teacher_id任课教师关联用户表semester开课学期course_desc课程简介一个教师开多门课、一个学生选多门课这是典型的多对多关系。规范做法是建中间表course_student字段只有course_id和student_user_id两个。网上有些教程图省事在课程表里加一个student_ids字段逗号分隔存多个学生ID。这个方案我强烈不建议碰。答辩时老师随口问一句我想查某学生在所有课程的选课情况怎么写SQL这个方案就答不上来。中间表方案一条SQL就查出来了SELECT c.course_name FROM course c JOIN course_student cs ON c.course_id cs.course_id WHERE cs.student_user_id 某个学生ID教师端添加学生名单时的批量导入本质上就是往中间表批量插入记录。源码里提供了一个批量添加的接口接收学生ID列表循环插入course_student这个在课设中可以直接复用。3.3 作业、提交与成绩三张表如何联动这三张表是整个系统真正的核心需要选一个相对完整的字段集合作业表assignmentassignment_id主键course_id所属课程title作业标题content作业描述支持富文本deadline截止时间attachment_path教师上传的附件模板路径attachment_name附件原始文件名is_allow_resubmit是否允许重新提交is_allow_late是否开启补交提交表submissionsubmission_id主键assignment_id关联作业student_user_id提交学生content提交文字说明file_path提交文件存储路径file_name文件原始名称submit_time提交时间status批改状态0未批改、1已批改成绩表gradegrade_id主键assignment_id、student_user_id定位是哪一门课哪一个学生score分数建议保留一位小数comment评语grade_time批改时间数据流转逻辑教师发布作业插入assignment记录学生提交文件插入submission记录此时status0教师批改打分插入grade记录并把submission.status更新为1。学生端我的成绩页面通过联表查询从assignment拿作业标题、从grade拿分数评语。这里有一个容易踩的坑把分数直接放在submission表里而不单独建grade表。表面上少一张表但已提交未批改和已批改的状态会模糊而且如果是可重新提交的场景新提交会覆盖旧记录分数版本会乱。独立grade表让每次批改都是独立记录逻辑清晰答辩也更好讲。3.4 公告表与文件上传路径的优雅设计notice公告表不复杂notice_id主键、content公告内容、publish_time发布时间、publisher_id发布人。管理员登录后首页展示最新公告这个是系统完整度的加分项。文件路径字段的设计有一个容易被忽略的细节永远只存相对路径不要存绝对路径。例如/upload/2025/06/uuid.docx配合一个统一配置的upload.dir基础路径拼接出完整路径。这样项目部署到新服务器时只需要改配置文件里的路径数据库不用动。答辩时讲一下这个设计意识其他同学还在纠结文件传上去下不来你已经把可移植性考虑清楚了。4. 核心功能实现作业发布、文件提交与在线批改4.1 教师端发布作业的完整链路发布作业是教师端最核心的操作。前端表单包括作业标题、所属课程、内容描述、截止时间、附件上传。后端接收的接口需要同时处理普通字段和MultipartFile文件处理顺序有讲究先保存文件到服务器再组装作业实体写入数据库。文件保存部分的伪代码逻辑public String uploadFile(MultipartFile file) { // 1. 校验文件类型和后缀白名单过滤 // 2. 生成UUID作为新文件名保留原扩展名 String newName UUID.randomUUID().toString() . getExtension(file.getOriginalFilename()); // 3. 写入配置的上传目录用日期分子目录 String path uploadDir / dateStr / newName; file.transferTo(new File(path)); // 4. 返回相对路径存到数据库 return /upload/ dateStr / newName; }UUID重命名这个操作很多人忽略。学生交的文件通常叫新建文档.docx或最终版(2).docx如果直接按原名落盘同名单文件会被覆盖。UUID保证文件名全局唯一真实文件名单独用字段存。下载文件给老师时通过attachment_name还原原名两边都舒服。时间处理上截止时间建议用前端typedatetime-local组件选择传到后端以LocalDateTime接收数据库datetime字段存储。三者的格式转换要统一建议前后端约定成yyyy-MM-dd HH:mm:ss。4.2 学生端提交文件与截止时间校验学生端提交页面的核心组件是Element Plus的el-upload。上传前先验证文件大小和后缀前端做一次提示性校验后端必须再做一次强校验——不能只靠前端拦截。提交接口的逻辑根据assignment_id查询作业记录判断截止时间是否已过如果没有开启补交且当前时间晚于deadline直接返回已超过截止时间查询该学生是否已有提交记录有则更新覆盖没有则新增覆盖提交的实现要注意先删除旧文件记录再写新文件。如果旧文件还留着磁盘会积攒大量垃圾文件。这里的删除不是物理删除旧文件而是把数据库记录替换掉磁盘上留着也无妨课设阶段不用太在意磁盘空间。后端截止时间校验这里我特别提醒一定要放到后端不能只在前端隐藏按钮。学生完全可以跳过前端页面用工具直接调后端接口提交数据。后端不校验等于允许学生无限迟到。4.3 教师批改待批改列表、打分与评语教师端待批改页面的查询逻辑按当前课程的作业列表查出每个作业下所有submission.status 0的提交记录按提交时间排序。用MyBatis-Plus的条件构造器做一两行就搞定。批改提交的关键一步是事务操作插入成绩表记录和更新提交状态。建议加Transactional注解保证原子性中间任何一步失败都能整体回滚不会出现成绩存了但提交状态没改的脏数据。批改这里支持重新批改也很重要。教师在成绩列表页可以点击重新批改修改分数和评语更新grade表记录。有这个功能演示时就不怕操作失误了。4.4 实操中踩过的三个坑第一个坑是上传路径。本地开发时文件传上去了但下载时404。原因往往是target目录和项目源码目录不一致或者访问路径和实际存储路径拼接错误。解决方式是把上传目录配置成绝对磁盘路径写在application.yml里下载时通过配置的路径加数据库相对路径拼接。第二个坑是时间格式。LocalDateTime传给前端默认是ISO格式显示成2025-06-10T12:30:00。在实体类的时间字段上加JsonFormat(pattern yyyy-MM-dd HH:mm:ss)注解前端表格才会显示正常。反过来前端传时间给后端时也容易出格式问题用全局的JacksonConfig配一下统一处理最省事。第三个坑是前端表格字段名不一致。MyBatis-Plus默认开启驼峰映射course_id映射成courseId如果前端绑定的属性名和实体类不一致表格就空白。拿到源码第一件事建议先核对前端调用的字段名和后端返回的数据结构是否一致。5. 权限与安全Spring Security JWT的落地实录5.1 为什么改用了JWT而不是传统Session传统Java Web的登录用HttpSession登录后服务端存一份session浏览器Cookie里放JSESSIONID。这套机制在前后端分离的场景里有两个痛点跨域时Cookie处理麻烦服务端为了保持登录状态要维护大量session。JWT的方案是状态无服务器化用户登录成功后后端用密钥签发一个带用户ID和角色信息的Token返回给前端前端存在localStorage里请求头带上Authorization: Bearer token。后端通过拦截器解析Token取出用户身份和角色。实战中拦截器的伪代码如下public class JwtFilter extends OncePerRequestFilter { // 排除登录接口和静态资源路径 // 从请求头取token解析成功则放行并注入用户上下文 // 解析失败统一返回401 }JWT的过期时间要合理设置。课程设计系统建议设24小时学生一天之内不用重复登录。Token被拦截器解析后把用户信息放到ThreadLocal或SecurityContextHolder里后续Controller可以通过工具类获取当前登录用户比如获取当前学生ID来判断提交权限。5.2 角色权限的注解式控制接口权限控制最方便的方案是方法级注解。发布作业的接口标注PreAuthorize(hasRole(TEACHER))学生的提交接口校验收当前用户和student_user_id一致防止替别人代交。管理员接口加hasRole(ADMIN)限流只有管理员能调用。参数级别的权限控制更要用到当前登录用户的上下文。比如教师只允许查看自己课程的作业列表光加角色注解还不够还要在Service层校验course.teacher_id是否等于当前登录用户ID。这个校验逻辑直接写进业务代码里避免教师越权拿别的课程数据。5.3 文件上传的安全防御文件上传是系统最脆弱的地方我整理了一份安全防御清单后缀白名单只允许doc/docx/pdf/zip/rar/jpg/png等常见类型大小限制单个文件不超过50MB随机命名用UUID重命名不保留用户原始文件名目录隔离上传目录可配成公共目录但禁止执行脚本类型校验不能只靠前端传的文件名判断后端要根据文件头或MIME类型再校验权限校验只有选课学生才能给该课程提交文件避免把系统当公共网盘乱传这些措施课设阶段够用了。答辩时能主动说文件上传做了白名单校验和大小限制安全设计这一项就过了。6. 部署运行与二次开发从源码到答辩演示的全流程6.1 本地环境准备与启动完整步骤一套标准的启动流程跟着做基本不会卡住。第一步安装基础环境JDK 17、Maven 3.6、MySQL 8.x、Node.js 16。建议用带版本的环境不要用太新的预览版。第二步初始化数据库。用Navicat或者MySQL命令行创建数据库名称要与后端配置一致然后导入源码里sql目录下的初始化脚本。脚本里包含表结构和示例数据管理员账号、几个学生、几门课程的测试数据。第三步修改后端配置文件application.yml把数据库用户名密码改成自己本地的。确认端口号8080没有被占用。第四步启动后端。在后端目录下执行mvn spring-boot:run看到Tomcat started on port 8080说明启动成功。第五步配置前端开发环境。在vue项目目录下执行npm install npm run devVite默认端口是5173浏览器访问http://localhost:5173就能看到登录页。第六步登录并且查看前端调试工具Network面板还能发现一个信息前端访问后端接口的URL路径是/api开头的这说明前端有代理配置。如果遇到跨域报错检查后端CORS配置有没有生效。6.2 快速改造把别人的源码变成我的课设拿到源码之后最怕的就是撞车。系统研究过一轮之后我整理了四步改造法可以高效地把源码变成自己的。第一步全局替换系统名称和Logo。在Vue项目里搜索原系统的标题关键词把登录页、侧边栏、首页右上角全部替换掉。Logo换成一张自己生成的图标这些工作半小时能搞定。第二步换掉数据库示例数据和初始化账号。把示例学生和课程的姓名改成自己班级真实姓名或虚拟姓名密码全部重置。第三步改一改界面样式。Element Plus的主题色在自带的CSS变量里改一行整个系统的配色就变了。按钮文字、菜单排序微调一下视觉风格立刻不同。第四步添加一个自己实现的小功能。这是答辩时证明我在原项目基础上有扩展的关键。比较推荐的方向导出成绩Excel表格用Apache POI或者EasyExcel写网上教程很多添加ECharts统计图表展示课程提交率和通过率增加作业提醒邮件发送功能。加一个这样的功能工作量不大但效果好。这四步做完系统的独立性就够了。答辩时重点讲自己扩展的部分不要只念源码已有内容。6.3 答辩演示顺序与常见追问清单演示时建议按这个顺序操作逻辑最顺管理员登录打开用户管理展示账号和角色分配切换到教师账号发布一个新作业上传附件设置截止时间切回学生账号查看刚发布的作业提交一份实验报告切回教师账号打开待批改列表打分写评语切回学生账号查看成绩和评语反馈整个过程控制在五到八分钟最把核心闭环演示完整就行不要在个人简介这类边缘功能上浪费时间。答辩时老师常问的几个问题我提前列出来数据库为什么这样设计作业和成绩为什么要分开表答为了状态清晰提交未批改和已批改要分开成绩保留历史记录文件存在哪里了答统一存在配置的上传目录数据库记录相对路径可移植性强权限怎么控制的答JWT做登录认证注解做接口角色控制业务层做数据级权限校验学生超过截止时间能提交吗答默认不能但教师可以开启补交开关特殊情况可以手动放行如果账号密码怎么保证安全答BCrypt加盐哈希存储不存明文以上这些问题都答顺了基本就不会被难倒。7. 跑通项目之后的一点真心话最后分享一个多年的感受拿到任何源码第一步永远是学会看日志。启动失败时后端控制台会打印一堆异常堆栈绝大多数问题——端口被占、数据库连不上、依赖版本冲突——都能从日志里直接定位。先自己读报错再找解决方案这个习惯比多会一个框架值钱得多。这套课程作业和实验管理系统核心价值不在代码量多大多全而在于业务逻辑闭环发布—提交—批改—反馈环环相扣。做课设时把这条主线捋顺了权限控制做得严一点安全细节考虑多一点演示时把功能在页面上点出来基本就是一份拿得出手的答案。源码就在那里拿到手记得先按文章里说的步骤跑通再花时间改造成自己的版本。折腾的过程踩几个坑总比答辩现场翻车强。