简介基于SpringBoot的课程作业管理系统设计与实现面向高校毕业设计、课程设计场景适合Java初学者及需要快速搭建管理系统的学生。系统围绕学生课程、课程管理、学生管理、教师管理等核心模块展开采用B/S架构结合SpringBoot、MySQL和Vue前端技术覆盖需求分析、数据库设计、系统详细设计、功能测试等完整开发流程。压缩包共477个文件以Java后端源码、Vue前端组件、XML配置和SQL脚本为主体附论文文档、答辩PPT、启动脚本及页面备份文件整体19.03MB目录结构按论文章节划分便于学习检索。目前已有60人学习下载。读者可从源码中理解三类角色的权限设计与业务交互逻辑论文文档则提供可直接参考的规范写作范式答辩PPT辅助梳理系统亮点适合用于课程设计答辩准备或作为SpringBoot项目实战入门的完整案例。1. 课程作业管理系统为什么值得细拆的 SpringBoot 课设每年毕业季都能见到同一个场景答辩老师问“你的课程作业管理系统里教师和学生是同一个角色还是两套表”台下学生支支吾吾答不上来。这套基于 SpringBoot 的课程作业管理系统包含完整源码、毕业论文和答辩 PPT业务上覆盖了学生课程、课程管理、学生管理、教师管理四条主线正好是课设里最经典的“用户 业务 文件”组合。适合 SpringBoot 刚入门、想拿一套能跑通的作业管理系统做二次开发的读者也适合正在准备答辩演示的人。本文按我平时拆项目的习惯把项目结构、数据库关系、核心模块代码和实际踩过的坑逐个过一遍。2. SpringBoot 技术选型与分层架构为什么这套组合不容易翻车2.1 技术栈选择SpringBoot MyBatis-Plus MySQL 的道理这份资源用的是 SpringBoot 单体架构没有引入微服务和消息队列。对课程设计这个体量来说SpringBoot 自带的内嵌 Tomcat 让部署变成“一个 jar 包跑起来”这是它比传统 SSM 省心的关键点。持久层用 MyBatis-Plus 的话单表 CRUD 不需要写 XMLBaseMapper 直接自带增删改查——课设场景下大部分页面其实就是单表操作只有成绩查询、作业列表需要连表用 MyBatis-Plus 能把代码量压到很低的水平。数据库用 MySQL 5.7 或 8.0 都可以。我一般建议用 8.0因为驱动和 SpringBoot 2.7 的兼容性更好而且 8.0 的时区处理比 5.7 严格能逼你在连接串里把 serverTimezone 写明白避免后面对时间字段踩坑。前端这块资源里用的是服务端渲染方案也就是 Thymeleaf 模板引擎加 Bootstrap页面由后端直接返回 HTML。这个选择的好处是不需要考虑跨域不需要单独起一个 Vue 的 dev server演示的时候点开浏览器就能看到完整效果。如果答辩老师问“为什么不前后端分离”可以这样答单体应用在数据量小、用户并发低的课设场景下服务端渲染的开发和调试成本更低SpringBoot 的接口层仍然保留了 RESTful 风格后续想拆成前后端分离Controller 层可以直接复用。这个回答能展示你对架构取舍有思考而不是只会背概念。2.2 三层架构与模块划分controller/service/mapper 的边界拿到源码第一件事不是按 F5 运行而是先看包结构。这套项目的包结构大致是这样的controller 层放 REST 接口service 层放业务逻辑mapper 层放数据库操作entity 里放和表结构一一对应的实体类。还有一个 config 包里面是拦截器、文件上传配置和 MyBatis-Plus 的分页配置common 包放返回结果封装类 Result 以及一些工具方法。业务边界划分我能给出的建议是Controller 只做三件事——接收参数、调用 Service、封装 Result 返回。Service 做业务判断比如作业发布时间是否早于截止时间、学生是否已经提交过、教师是否有权修改某个作业。Mapper 不做任何 if 判断只负责数据读写。很多课设代码翻车的点在于把业务判断写进 Controller导致一个接口几百行答辩时根本讲不清。实际项目里作业提交这个动作涉及三个表的操作插入 submission 记录、更新 homework 表的提交人数、记录操作日志。如果不分层这三步会挤在一个方法里后面想加“超过截止时间不允许提交”的判断就要到处找代码。分层之后你可以在 service 层加一个 checkDeadline() 方法逻辑清晰答辩时也方便按方法名逐段讲。2.3 工程结构与配置文件先看这几个关键位置资源里的 application.yml 是启动入口配置。重点看三个配置块数据源、文件上传大小、MyBatis-Plus 的逻辑删除与驼峰映射。数据源里的 url 需要改成你自己的数据库地址和库名username/password 改成本地 MySQL 的账号密码。很多下载完源码跑不起来的案例十有八九是这里没改或者数据库里的 SQL 脚本没执行。文件上传配置在 SpringBoot 里默认值很保守单文件默认最大 1MB。作业系统里学生提交的 Word 文档或压缩包大概率超过这个大小所以需要在配置里把 max-file-size 和 max-request-size 调大一般设为 10MB 或 20MB。MyBatis-Plus 的配置里map-underscore-to-camel-case 默认是 true这个保持默认即可表字段 user_name 能自动映射到实体属性 userName。然后注意启动类上的 MapperScan 注解它指定 mapper 接口所在的包路径。如果新建了子包但忘记加扫描范围运行时会报 Invalid bound statement (not found)这个错误很常见记住它和包路径强相关。检查完这三处配置项目基本能启动如果还起不来优先看控制台里第一个异常而不是盯着最后的报错行。3. 数据库设计五张核心表与 ER 关系建表 SQL 直接抄3.1 用户-课程-作业的三级关系模型很多课程设计喜欢把学生和教师拆成两张表再建一张管理员表三张表之间几乎没有关联完全靠代码里 if 判断。这套系统的表结构是另一种思路用一张 user 表加 role 字段区分学生、教师、管理员。这样做的收益很明显登录接口只需要查一次表权限判断在拦截器里做而学生管理和教师管理本身也只是对同一张表按角色过滤。课程和学生的关系是典型的多对多一个学生选多门课一门课有多个学生所以需要中间表 student_course。作业表 homework 挂在 course 下面一门课可以发布多个作业。提交表 submission 是整张 ER 图的核心交集它关联 student、homework、teacher评分人三个维度。资源里给的建表 SQL 是经过筛选的删掉了审计字段保留了课设答辩够用的核心字段。关系模型定下来之后建表顺序也就明确了先建 user 表再建 course 表然后建立中间表最后建 homework 和 submission 表。外键在主键建立之后再考虑。我的习惯是把建表 SQL 单独执行而不是直接 source 整个文件分步执行过程中能发现哪些字段类型定得不合理。3.2 核心表结构与建表 SQL下面这份 SQL 是这套系统的核心五表。字段类型和注释按通用课设标准给出你拿到手之后直接替换数据库名执行即可。CREATE DATABASE IF NOT EXISTS course_homework DEFAULT CHARACTER SET utf8mb4; USE course_homework; CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录账号, password VARCHAR(100) NOT NULL COMMENT 登录密码建议存MD5或BCrypt, real_name VARCHAR(50) COMMENT 真实姓名, role TINYINT NOT NULL DEFAULT 2 COMMENT 1管理员 2教师 3学生, email VARCHAR(100), created_at DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT用户表学生教师管理员同表; CREATE TABLE course ( id INT PRIMARY KEY AUTO_INCREMENT, course_name VARCHAR(100) NOT NULL, course_code VARCHAR(50) NOT NULL UNIQUE COMMENT 课程编号, teacher_id INT NOT NULL COMMENT 授课教师id关联user.id, credit DECIMAL(3,1) DEFAULT 2.0, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_teacher (teacher_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT课程表; CREATE TABLE student_course ( id INT PRIMARY KEY AUTO_INCREMENT, student_id INT NOT NULL, course_id INT NOT NULL, selected_at DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_stu_course (student_id, course_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT选课中间表多对多关系; CREATE TABLE homework ( id INT PRIMARY KEY AUTO_INCREMENT, course_id INT NOT NULL, title VARCHAR(200) NOT NULL COMMENT 作业标题, content TEXT COMMENT 作业要求描述, deadline DATETIME NOT NULL COMMENT 截止时间, allow_resubmit TINYINT DEFAULT 1 COMMENT 是否允许重复提交, created_at DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT作业表; CREATE TABLE submission ( id INT PRIMARY KEY AUTO_INCREMENT, homework_id INT NOT NULL, student_id INT NOT NULL, file_name VARCHAR(255) COMMENT 原始文件名, file_path VARCHAR(255) COMMENT 服务器存储路径, submit_time DATETIME NOT NULL, score DECIMAL(5,2) COMMENT 得分为空表示未批改, comment VARCHAR(500) COMMENT 教师评语, status TINYINT DEFAULT 0 COMMENT 0已提交 1已批改, UNIQUE KEY uk_homework_student (homework_id, student_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT作业提交表;字段说明里重点看两个位置。第一个是 submission 表上的唯一索引 uk_homework_studenthomework_id, student_id它保证一个学生对同一份作业只能存在一条提交记录——如果不加这个索引代码里得先用 select 判断再 insert并发情况下容易产生重复提交加了索引后直接用 INSERT ON DUPLICATE KEY UPDATE 即可。第二个是 role 字段用 TINYINT 而不是字符串这样数据库层面更省空间代码里用常量区分三种角色答辩时可以解释为什么不用 MySQL 的枚举类型——枚举扩展性差新增一个角色类型就必须改表结构。3.3 外键到底要不要加课设场景下的取舍外键是答辩高频问题。资源里大概率没有加物理外键只有普通索引和逻辑关联。这个设计和生产环境里的习惯是一致的物理外键会带来插入时的额外检查开销删父表数据时还会被子表引用卡住在分库分表场景下根本没有物理外键可用。课程设计系统里各表通过 id 字段逻辑关联由 Service 层保证引用完整性这是现在的通行做法。如果论文里写了“通过外键维护数据一致性”但数据库里却没有任何 FOREIGN KEY答辩时被问到就会很尴尬。建议论文里改为“通过逻辑外键 应用层校验保证数据一致性”这句话既能体现对数据库设计的理解也和代码的实际实现保持一致。唯一考虑加物理外键的地方是 student_course 的 (student_id, course_id)但也不推荐原因同上。选课和删除课程时要注意级联策略。一般做法是删除课程前先删除 student_course 中间表记录再删 homework 和 submission 关联记录最后删 course。如果直接 DELETE FROM course WHERE id残留的选课记录会让列表查询出空引用前端页面直接白屏。这个顺序问题在避坑章节会再展开一次但建表时心里要有数。4. 核心业务模块落地登录鉴权、作业发布、提交与评分4.1 登录鉴权拦截器 Session两段代码搞定课程设计项目的登录鉴权不需要上 Spring SecurityJWT 也不建议——那会让答辩复杂度上升而且一旦被追问 token 过期策略和刷新机制很容易露怯。用拦截器加 Session 是代码量最小、答辩最好讲的方式。核心思路是用户登录成功后把 user 对象放进 Session写一个 HandlerInterceptor 拦截非登录请求发现 Session 里没有用户就重定向到登录页。Component public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 放行登录接口本身和静态资源 String uri request.getRequestURI(); if (uri.startsWith(/login) || uri.startsWith(/static) || uri.startsWith(/css) || uri.startsWith(/js)) { return true; } HttpSession session request.getSession(); Object user session.getAttribute(loginUser); if (user null) { // 未登录重定向到登录页 response.sendRedirect(/login); return false; } return true; } }逻辑说明preHandle 在 Controller 方法执行前调用返回 false 时请求流程被截断不会进入业务代码。注意静态资源放行如果不放行登录页加载的 CSS、JS 全会被拦下来页面样式全丢这是新手最容易忽略的。配置类里要用 addInterceptors 注册拦截器并且通过 excludePathPatterns 放行登录接口。拦截器注册写在 WebMvcConfigurer 的实现类里如果同时配置了 CORS注意 MvcConfig 不要继承 WebMvcConfigurationSupport 而是实现 WebMvcConfigurer前一种写法会覆盖 SpringBoot 的默认 MVC 配置导致静态资源映射失效。4.2 作业发布教师端的业务校验与权限归属教师发布作业这个功能看着简单实际包含三个校验点登录身份必须是教师角色、截止时间必须晚于当前时间、作业标题不能为空。第三个校验容易被忽略可能一键清空了表单。代码逻辑集中在 Service 层是一个标准的“参数校验 → 业务校验 → 落库”流程。下面这段代码演示了作业发布的核心逻辑。public Result createHomework(HomeworkDTO dto, Long teacherId) { // 1. 校验截止时间必须晚于当前时间 if (dto.getDeadline() null || dto.getDeadline().isBefore(LocalDateTime.now())) { return Result.error(截止时间不能早于当前时间); } // 2. 校验课程归属教师只能给自己教的课程发布作业 Course course courseMapper.selectById(dto.getCourseId()); if (course null || !course.getTeacherId().equals(teacherId)) { return Result.error(无权为这门课程发布作业); } // 3. 封装实体并落库 Homework homework new Homework(); BeanUtils.copyProperties(dto, homework); homework.setCreatedAt(LocalDateTime.now()); homeworkMapper.insert(homework); return Result.success(homework.getId()); }参数说明dto 是前端传来的作业对象deadline 用 LocalDateTime 类型接收这样比 String 直接比较更可靠——字符串比较日期是靠格式化串的巧合LocalDateTime.isBefore() 则无歧义。teacherId 从 Session 里拿不从表单里读否则学生伪造表单可以给任何课程发作业这是权限设计里最常见的安全漏洞。还有一点作业发布之后通常需要一个“编辑”功能。如果要改截止时间并重新开放提交入口则要注意状态变化已提交过的 submission 记录是否保留、是否可以重新提交。最简单的做法是编辑只允许修改 deadline 和 title不动 submission 表如果要修改已经批改的作业内容需要先确认成绩是否已公布。这套系统的参数校验严格程度由你自己控制但起码不能把“校验课程归属”这一步省掉。4.3 学生提交作业文件上传、去重与截止校验提交作业是这套系统里最容易出问题的模块。学生端提交涉及文件上传后端要面对文件名乱码、文件大小超限、重复提交三个问题。先看接收文件的 Controller 代码这里的 MultipartFile 对象是 SpringMVC 自动封装好的。PostMapping(/submit) public Result submitHomework(RequestParam(homeworkId) Long homeworkId, RequestParam(file) MultipartFile file, HttpSession session) { // 从 Session 获取当前登录学生 User user (User) session.getAttribute(loginUser); Homework homework homeworkMapper.selectById(homeworkId); // 1. 截止时间校验已过期的作业不允许提交 if (homework.getDeadline().isBefore(LocalDateTime.now())) { return Result.error(提交已截止); } // 2. 文件名校验防止空文件名和路径穿越 String originalFilename file.getOriginalFilename(); if (originalFilename null || originalFilename.contains(..)) { return Result.error(文件名不合法); } // 3. 生成存储文件名避免中文覆盖和重名 String ext originalFilename.substring(originalFilename.lastIndexOf(.)); String storedName UUID.randomUUID().toString().replace(-, ) ext; String saveDir /uploads/homework/ homeworkId /; File dir new File(saveDir); if (!dir.exists()) { dir.mkdirs(); } try { file.transferTo(new File(saveDir storedName)); } catch (IOException e) { return Result.error(文件保存失败); } // 4. upsert 提交记录一个学生一份作业只有一条记录 Submission submission new Submission(); submission.setHomeworkId(homeworkId); submission.setStudentId(user.getId()); submission.setFileName(originalFilename); submission.setFilePath(saveDir storedName); submission.setSubmitTime(LocalDateTime.now()); submission.setStatus(0); // 利用唯一索引做幂等已存在则更新不存在则插入 submissionMapper.insertOrUpdate(submission); return Result.success(提交成功); }逻辑说明第 2 步检查文件名里的 ..是为了防止用户上传文件名构造路径穿越。第 3 步用 UUID 重命名文件是必须的——中文文件名在 Windows 和 Linux 环境下存储行为不一样直接用原名保存后期迁移服务器或导出成绩时会遇到乱码。第 4 步的 insertOrUpdate 依赖建表时定义的那个唯一键 (homework_id, student_id)它保证了同一学生对同一作业不会生成两条记录。这里有一个容易被忽略的参数文件大小限制。SpringBoot 默认单文件最大 1MB学生交一个 Word 文档加上几张截图就超了。需要在 application.yml 里把 spring.servlet.multipart.max-file-size 改成 20MB。很多学生演示系统时在本地能传文件部署到服务器就报 MaxUploadSizeExceededException原因就是没考虑服务器上配置文件默认值。4.4 成绩评分与导出教师打分 成绩表导出教师给作业评分的模块相对简单核心是更新 submission 表的 score、comment、status 三个字段。需要注意的地方是评分前要校验当前登录用户是否是这份作业所属课程的教师。这个校验不能只在前端做后端 Service 里必须再查一遍课程表确认归属。成绩导出是答辩演示的加分项。常见方案是用 Apache POI 生成 xlsx 文件。导出逻辑是根据 homeworkId 查出所有提交记录连表查出学生姓名和学号写入 Workbook通过 HttpServletResponse 输出流返回给浏览器。这里有个关键点response 头里设置文件名时要用 URLEncoder.encode 处理中文否则浏览器下载的文件名会是乱码。代码片段如下。response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); String fileName URLEncoder.encode(homework.getTitle() 成绩.xlsx, UTF-8); response.setHeader(Content-Disposition, attachment; filename\ fileName \); // 后续通过 response.getOutputStream() 写入 workbook参数说明Content-Disposition 后面的 filename 写成带引号的字符串是为了兼容不同浏览器对空格和特殊字符的解析差异。URLEncoder.encode 会把中文转成百分号编码浏览器收到后会做解码这样导出的 Excel 文件名在 Chrome、Edge、Firefox 下都不会乱码。如果省略这一步接口测试工具里能拿到数据但用户浏览器下载时文件名叫“%E4%BD%9C%E4%B8%9A.xlsx”非常劝退。5. 避坑课程设计里最常踩的五个坑每个都有后悔药5.1 文件名乱码与中文路径问题现象学生上传“作业最终版.docx”管理端下载和 Excel 导出时文件名变成乱码更严重的是保存到服务器后目录里出现一串看不懂的字符。原因浏览器提交的文件名是 UTF-8 编码服务器接收时吃到了 ISO-8859-1 或 GBK导致中文全部错位。另外直接用 originalFilename 作为存储名在不同操作系统下中文文件名处理规则不一致Windows 上能存的字符 Linux 上不一定能存。解决存储文件名一律采用 UUID 重命名原始文件名只保留在数据库 submission 表的 file_name 字段里。下载回给用户时从数据库取原始文件名再通过 URLEncoder.encode 编码写入响应头。这个方法能同时解决存储乱码和下载乱码两个环节从根上避开中文路径问题。5.2 时间比较和 MySQL 时区“玄学”现象学生明明在截止时间之前提交后端却提示“提交已截止”或者后台看到的截止时间比设定的晚 8 小时。原因MySQL 的 serverTimezone 没有正确配置。JDBC 连接串里如果不带 serverTimezoneAsia/Shanghai驱动会使用服务器默认时区经常和本地东八区不一致。Java 端用 LocalDateTime 和数据库 DATETIME 映射时读写时区处理不当就会出现偏移。解决在 jdbc url 的末尾加上 serverTimezoneAsia/ShanghaiuseUnicodetruecharacterEncodingutf8。数据库连接配置好后在代码里不要混用 Date、Timestamp、LocalDateTime统一用 LocalDateTime。答辩时时间字段出现偏差非常尴尬我一般建议在演示前先执行 SELECT NOW() 对比一下当前时间是否和本机一致。5.3 MyBatis-Plus 自动填充失效现象insert 之后实体里设置了 created_at 字段但数据库里这个值一直是 NULL或者 createTime 没有被自动填入。原因MyBatis-Plus 的自动填充不是开了配置就能用它是通过 MetaObjectHandler 类实现的。实体字段上需要加 TableField(fill FieldFill.INSERT) 注解同时要有一个 Bean 把它注册到 Spring 容器里。课设代码里往往只写了实体注解忘了实现 MetaObjectHandler填充当然不会生效。解决新建一个 MyMetaObjectHandler implements MetaObjectHandler在 insertFill 里面通过 this.strictInsertFill(metaObject, createdAt, LocalDateTime.class, LocalDateTime.now()) 赋值另外在 updateFill 里处理 updated_at。这个坑很容易演示出来新增一条作业数据库里 created_at 为空答辩老师一眼就能看出数据完整性问题。5.4 文件上传大小超限报 MaxUploadSizeExceededException现象本地开发时上传大文件正常部署到服务器后一点“提交”就直接报错错误信息是 MaxUploadSizeExceededException而且没有进入 Controller 打印日志。原因SpringBoot 的 multipart 默认配置是单文件 1MB、总请求 10MB。本地能传是因为本地没有经过额外限制服务器上传出错可能是两端各有一层限制比如 Nginx 默认 client_max_body_size 也是 1MB。解决先检查 application.yml 里的 multipart 配置把 max-file-size 提高到 20MB再检查部署环境里 Nginx 的 client_max_body_size。注意这个错误不在业务代码里属于容器层拦截所以 try/catch 放在 Controller 里捕获不到。全局异常处理器里要单独加一个异常类型让它弹出友好的提示而不是让页面直接白屏。5.5 论文截图和源码对不上现象答辩时老师照着论文里的系统截图演示发现界面功能和源码实现不一致或者论文里写了“支持批量导入学生”源码里根本没有这个接口。原因论文写完后才发现代码有问题改了代码忘了同步论文或者论文是从别的资料里改出来的截图是原作者的代码早就不是那套了。解决拿到这份资源之后把论文里的功能列表整理成一张 Excel 表每一项去源码里找到对应的 Controller 接口或页面入口。找不到的功能要么在源码里补一个最小实现要么从论文里删掉。答辩老师最反感的就是文档和代码不一致这一条注意一下能避免很多不愉快。6. 答辩与验证把“跑通了”变成“讲得清”6.1 答辩前必须跑通的三个演示路径演示不能照着功能清单一个个点而是按业务路径走管理员登录创建课程并分配教师教师登录发布作业学生登录选课提交作业教师评分。这三条路径必须完整跑通且每一步的操作结果能在界面上看到数据变化。建议提前准备一组演示数据课程名称、学生姓名、提交的文件都用真实的不要用 test1、test2 这类名称。6.2 PPT 里放什么PPT 控制在 10 页以内。核心页面是四张系统架构图浏览器-Controller-Service-Mapper-MySQL、数据库 ER 图五张表的关系、教师端作业发布页面截图、学生端提交页面截图。答辩时间通常只有 5 分钟PPT 角色是提词器重点是讲清楚角色权限和作业提交流程而不是念代码。这四张图能覆盖 80% 的提问场景。6.3 论文的关键章节怎么对应源码论文里“系统设计”章节要对照源码里的数据库建表 SQL 来写类图对照 controller/service 层的类名来画。有一个技巧作业提交模块的时序图绘制顺序正好对应 submissionMapper.insertOrUpdate 的执行过程从学生发起请求到 Controller 接收、Service 校验、Mapper 落库最后返回结果。答辩时如果被问“核心功能怎么实现的”就把这段时序讲出来比背概念更有说服力。从那以后我每次拆完一套课设源码都会强制自己把论文功能列表和源码接口逐项对一遍确认无遗漏再结束。希望帮到你。本文还有配套的精品资源点击获取
