简介一套基于Java开发的作业提交批改系统完整源码包含配套数据库脚本面向高校学生、Java Web开发者及需要搭建在线作业平台的教师。系统覆盖用户注册登录与权限管理、作业发布与提交、文件上传限制、自动与手动批改、成绩统计报表等核心模块涉及Spring Security/Shiro权限控制、Spring MVC请求处理、MyBatis/JPA持久化、NLP或相似度算法辅助批改等关键技术点前端可结合Bootstrap或Vue.js后端兼顾SQL注入/XSS防护与Redis缓存等性能优化并考虑Docker容器化部署。压缩包约17.42MB以Java源码、项目配置及数据库脚本为主目录结构清晰便于按模块阅读和二次开发。已有547人学习下载适合作为课程设计参考或Java Web综合项目练手能直观理解从数据库表设计到前后端交互、安全防护的完整实现路径对掌握企业级开发流程有较高参考价值。1. 拿到 rar 先别急着解压java 作业提交批改系统要过的三道关卡java 作业提交批改系统源码含数据库脚本.rar 这种压缩包十有八九是 Java 课程设计案例源码不是拿来就能跑的商品软件里面特意附带的数据库脚本说明作者希望你先把库建起来再谈业务。围绕它的需求其实很明确学生登录后能看到作业、提交文件教师登录后能发布作业、给分、写评语。真正常翻车的点不在功能而在启动阶段。这套系统的运行链路是 JDK、数据库、Maven 依赖、Web 容器四段接力任何一段版本不对都会让你对着黑匣子干瞪眼。对想拿它复习 java 面试题、准备答辩和二次开发的工程师这篇文章按顺序给出可直接抄的检查步骤和踩坑清单。2. 解压查证三步走目录结构、SQL 落库、Maven 镜像哪一步都不能跳过2.1 先找这三个文件再决定要不要往下走拿到压缩包我一般不会直接“解压到当前文件夹”而是先建一个干净目录比如D:/homework_sys再解压。解压后第一件事不是打开 IDEA是按优先级找这三样东西pom.xml或build.gradle、数据库脚本、README 或课程设计报告。pom.xml决定这个工程的构建方式。过去几年常见的课程设计模板是 Spring Boot MyBatis也有不少老包是 SSMSpring MVC Spring MyBatis配合 JSP 页面。这两种工程的启动方式不同Spring Boot 可以直接运行主类SSM 通常要打成 war 包扔进 Tomcat。你只有先确认这一点后面才不会出现“明明编译过了却不知道怎么启动”的尴尬。数据库脚本的位置不同作者放得很随意有的放在db/homework.sql有的直接放在根目录叫homework_system.sql还有的把它塞进doc文件夹。文件名也可能写得分不清比如init.sql、data.sql。我的建议是把这个文件先复制一份放到db目录改名为hw_backup_原文件名.sql再开始导入。这不是多此一举后续改表结构时这个备份就是后悔药改坏了还能秒回滚。README 或设计文档不是每个包都有但只要有就值得先花五分钟通读一遍。它通常会写清楚默认管理员账号、端口号、JDK 版本要求。没读文档直接开跑遇到账号密码不对再去翻代码那是白折腾。2.2 导入数据库脚本命令行和可视化工具手感不同字符集是共同大坑很多同学习惯用 Navicat 或 DataGrip 双击运行 SQL 文件但我更推荐在终端里用命令行先建库再导入。原因很简单命令行能把字符集问题暴露得明明白白而图形化工具默认字符集往往是继承连接设置的有时候导入成功了页面一查中文全乱码你还不知道是哪一步出了问题。下面是常见做法适用于绝大多数 MySQL 版本# 先建库显式指定字符集再把脚本导入 mysql -uroot -p --default-character-setutf8mb4 -e CREATE DATABASE IF NOT EXISTS homework_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -uroot -p homework_system --default-character-setutf8mb4 D:/homework_sys/homework_system.sql这段命令里做了两件事第一句建库时指定utf8mb4这是 MySQL 8 时代最稳妥的字符集能存 emoji 和生僻字第二句以同样的字符集把 SQL 文件灌进homework_system库。前后字符集一致是避免中文乱码的第一道防线。参数说明--default-character-setutf8mb4要放在-p后面、前面因为它作用于整个客户端会话不单是某一条 SQL。如果脚本里已经写了CREATE TABLE ... ENGINEInnoDB DEFAULT CHARSETutf8mb4那导入时这个参数更多是保证连接层的编码一致如果脚本里没写那连接层和表层的字符集必须都撑住否则表建出来就是 latin1。如果你非要用图形化工具记得在连接属性里手动把 encoding 设为utf8mb4并且导入前在工具里确认已选中目标数据库。Navicat 里有个经典坑只选了连接没选数据库然后直接运行脚本结果表全建到了默认库。导入完可以用show tables;和show create table t_user;验证。2.3 java 环境配置与工程语言等级两个最常见的版本冲突环境方面的坑很少是 JDK 没装而是“装了不止一个 JDK”。这类源码包多数基于 JDK 8 编写如果机器默认 JDK 是 17 或 21老工程直接启动可能会报UnsupportedClassVersionError。先看pom.xml里的配置再决定要不要切 JDK。properties maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target java.version1.8/java.version /properties像这样的配置说明它按 JDK 8 编译。如果你本机只有 JDK 17也不是不能跑但要注意 Spring Boot 2.x 配高版本 JDK 时可能会碰到 Lombok 版本过旧、反射访问受限等兼容问题。最省事的做法是在 IDEA 的 Project Structure 里把 SDK 切到 8如果没装就装一个 JDK 8u202 之后的小版本然后用 IDEA 管理多版本 JDK不要动系统环境变量。Maven 依赖下载这块很多人的体验是“点完运行等半天最后报依赖拉取失败”。这跟网络有直接关系解决办法是给 Maven 配置国内镜像仓库具体做法是修改 Maven 安装目录下的conf/settings.xml在mirrors节点里加一个镜像源。这里不贴具体域名因为不同时段可用性不一样原则就是找个能访问的镜像再把本地仓库localRepository指向一个非系统盘目录避免系统盘爆掉。还有一个容易被忽略的点老工程如果用的是 Tomcat 运行IDEA 里默认会用工程自带的本地 Tomcat版本不对时会出现启动时 ClassNotFound 或版本警告。建议先确认pom.xml里packagingwar/packaging还是jar再选择运行方式。这一点确认对了比后面调半天代码都管用。3. 读懂数据库脚本里的三张核心表批改系统的状态流转就漏不了3.1 用户表、作业表、提交表实体关系和一段建表脚本作业提交批改系统的核心说穿了就是三张表在转人、作业、提交记录。几乎所有这类源码包都会围绕它们做扩展有的多一张班级表有的多一张公告表但骨架不会变。先看一张我整理的表结构概览表名定位关键字段关系说明t_user用户与角色id, username, password, real_name, role, student_no/teacher_norole 区分学生、教师password 通常是 MD5t_homework教师发布的作业id, title, content, deadline, teacher_idteacher_id 指向 t_user.idt_submission学生提交与批改结果id, homework_id, student_id, file_name, status, score, comment, submit_timehomework_id 指向 t_homeworkstudent_id 指向 t_user打开 SQL 脚本后直接搜CREATE TABLE看到这三张表你对整个系统的理解就算成立了。数据库脚本里通常还会带INSERT INTO的初始数据包括管理员账号、演示学生账号别把这些删了后续登录都要靠它们。这段建表脚本是一个很经典的写法很多课程设计会采用近似结构CREATE TABLE t_user ( id int(11) NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL COMMENT 登录名, password varchar(64) NOT NULL COMMENT MD5密码, real_name varchar(30) DEFAULT NULL COMMENT 姓名, role tinyint(4) DEFAULT 1 COMMENT 1学生 2教师 3管理员, student_no varchar(20) DEFAULT NULL COMMENT 学号, teacher_no varchar(20) DEFAULT NULL COMMENT 工号, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT用户表;这里要特别注意两个设计决策。一是role用数字而不是字符串它在 Java 代码里通常对应一个枚举或者一串 if 判断二是学号和工号共用一张表不单独建教师表和学生表。这样做的好处是登录逻辑统一坏处是学生在教师端接口的权限校验就要靠 role而不是靠表名天然隔离。后面做权限拦截器时必须同时判断 role 和访问路径。3.2 submission 表上的四个状态让作业批改有迹可查提交表是整个系统的状态中心它比作业表更能体现系统设计水平。大多数源码包会用一个 status 字段来标记提交记录状态常见的取值我不只见到一种有的是 0 未交、1 已交、2 已批改有的把“重新提交”也单独算一个状态。建议你在拿到脚本后先搜一下status这个字段看注释或代码里的常量定义把状态枚举列全。CREATE TABLE t_submission ( id int(11) NOT NULL AUTO_INCREMENT, homework_id int(11) NOT NULL, student_id int(11) NOT NULL, file_name varchar(255) DEFAULT NULL COMMENT 上传的文件名, file_path varchar(255) DEFAULT NULL COMMENT 存储路径, status tinyint(4) DEFAULT 0 COMMENT 0未提交 1已提交待批改 2已批改, score int(11) DEFAULT NULL COMMENT 成绩, comment varchar(500) DEFAULT NULL COMMENT 教师评语, submit_time datetime DEFAULT NULL, review_time datetime DEFAULT NULL, PRIMARY KEY (id), KEY idx_homework (homework_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT提交批改表;注意这里没有设置UNIQUE KEY (homework_id, student_id)这种设计在课程设计里很常见但其实是隐患。如果不加唯一约束学生连续点两次提交就会插入两条记录教师端看到的就是同一学生提交了多份。实际开发中我会在代码提交前先查一次select count(*) from t_submission where homework_id? and student_id?或者干脆给表加联合唯一索引。加唯一索引的做法更稳代价是重新提交时必须改成ON DUPLICATE KEY UPDATE或者先 delete 再 insert。3.3 角色控制一张 user 表的 role 字段撑起三种权限这套系统里权限控制往往不是靠 Spring Security而是靠一个拦截器加 Session 里的登录用户对象。它的原理很简单用户登录后把用户实体放进 Session拦截器在每次请求进来时从 Session 取用户再判断访问路径和角色是否匹配。看源码时优先找Interceptor或WebConfig类里面通常有这段逻辑// 简化版拦截器按路径前缀区分学生端和教师端 public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 登录放行Session 里没有 user 就跳转登录页 Object user request.getSession().getAttribute(loginUser); if (user null) { response.sendRedirect(/login); return false; } // 从 URI 前缀判断访问方向/teacher/** 只允许教师和管理员访问 String uri request.getRequestURI(); if (uri.startsWith(/teacher/)) { // role 字段1 学生2 教师3 管理员 int role ((User) user).getRole(); if (role ! 2 role ! 3) { response.sendRedirect(/student/index); return false; } } return true; } }这段代码的作用是给请求分层设卡。参数说明就一点startsWith(/teacher/)这种判断方式依赖 URL 命名规范所以如果你改路由名拦截器也要同步改否则会出现“明明登录了却被踢回首页”的玄学问题。读这种源码时重点不是把每一行都看懂而是抓住“登录 → 取 role → 匹配 URL 前缀”这条主线。面试时被问到权限怎么做把这段逻辑讲清楚比背一堆框架配置更有说服力。4. 提交与批改两条业务主链路代码该写在哪、参数该给多大4.1 学生提交作业截止时间校验和文件存储路径的取舍主链路代码里学生提交作业是最容易写坏的地方。常见的错误是只做上传不校验截止时间稍微好一点的做了校验但校验用的是数据库时间而不是服务器时间导致在学生本机改个系统时间就能绕过。下面这段是学生提交作业的一个最小可用写法// 学生提交作业校验作业存在、校验截止时间、落盘文件 public boolean studentSubmit(Integer studentId, Integer homeworkId, MultipartFile file) { Homework hw homeworkMapper.findByPk(homeworkId); if (hw null) { return false; } // 时间判断统一用 new Date()不要信前端传的时间 Date now new Date(); if (hw.getDeadline() ! null now.after(hw.getDeadline())) { return false; } // 文件名加 UUID防止两个学生传同名文件互相覆盖 String originalName file.getOriginalFilename(); String suffix ; if (originalName ! null originalName.contains(.)) { suffix originalName.substring(originalName.lastIndexOf(.)); } String fileName UUID.randomUUID().toString().replace(-, ) _ System.currentTimeMillis() suffix; // 按作业 ID 建子目录避免单个目录文件过多 String path uploadRoot /homework/ homeworkId; File dir new File(path); if (!dir.exists()) { dir.mkdirs(); } File dest new File(dir, fileName); try { file.transferTo(dest); } catch (IOException e) { return false; } // 记录提交数据status 置 1 表示待批改 Submission sub new Submission(); sub.setHomeworkId(homeworkId); sub.setStudentId(studentId); sub.setFileName(fileName); sub.setFilePath(dest.getAbsolutePath()); sub.setSubmitTime(now); sub.setStatus(1); return submissionMapper.insert(sub) 0; }这段代码值得注意的参数是uploadRoot。很多源码包会把它写成绝对路径写死在代码里比如D:/upload这会带来两个问题一是换电脑跑路径不存在上传失败二是部署到 Linux 服务器反斜杠路径直接报错。我一般建议把上传根目录放到application.yml的配置项里通过Value注入并且用相对路径加系统属性拼接file.upload-root${user.dir}/upload这样工程跑起来后上传目录会自动生成在工作目录下换环境不用改代码最多改个配置。4.2 教师批改作业成绩回写要有一点“幂等”意识教师批改的成绩回写逻辑看似简单就是 update 一条记录但有两个高频 bug。第一个是成绩被重复提交页面刷新一次点一次批改score 就被覆盖一次虽然表面上结果一样但 review_time 和审核状态会不断变化答辩时被问到“这条记录为什么审核了三次”你很难解释。第二个是批改时并发问题教师 A 和教师 B 同时打开同一份提交记录后保存的会把先保存的评语覆盖掉。处理方式其实很简单加一个事务并在更新前检查当前状态Transactional public int gradeSubmission(Integer submissionId, Integer teacherId, Integer score, String comment) { // 先按主键查出来只有处于“已提交待批改”状态才能打分 Submission sub submissionMapper.findByPk(submissionId); if (sub null || sub.getStatus() ! 1) { return 0; } // 回写成绩和评语状态改为已批改 Submission update new Submission(); update.setId(submissionId); update.setScore(score); update.setComment(comment); update.setTeacherId(teacherId); update.setReviewTime(new Date()); update.setStatus(2); return submissionMapper.updateByPk(update); }这里的核心在sub.getStatus() ! 1这个判断。它保证了只有待批改的记录能被批改已经批改过的记录再提交这个接口会被直接拒绝。这就是把“幂等”落到了状态上同样的请求发一百次只有第一次生效。如果项目里没有这个判断教师端按钮连续快速点击两次就会出现两条同样内容的批改日志虽然不影响最终成绩但数据表里 review_time 变化会让人不舒服。4.3 作业完成率统计未交名单用左连接别在 Java 内存里过滤教师端首页一般要显示“某个作业还有几个人没交”很多新手拿到这类源码会惊讶地发现统计完成率居然是把所有学生查出来再循环判断有没有提交记录。这种写法数据量小的时候没问题但答辩演示时一旦把表数据导成几百人页面就会明显卡顿。更合理的做法是把筛选下推到 SQL用左连接一次查出来。下面这段是典型实现-- 查询某个作业的未交学生名单 SELECT u.id, u.real_name, u.student_no FROM t_user u LEFT JOIN t_submission s ON s.homework_id 5 AND s.student_id u.id WHERE u.role 1 AND s.id IS NULL;这里的核心技巧是s.id IS NULL。LEFT JOIN 会把没有匹配记录的学生行保留下来此时右边的提交表字段全是 NULL所以IS NULL正好筛出未提交的人。注意ON条件里带了s.homework_id 5这个条件不能挪到WHERE里否则左连接会退化成内连接未交名单就查不出来了。很多人在这个 SQL 上翻过车现象是“明明有人没交查出来却全是已交”。5. 避坑篇启动失败、中文乱码、文件访问 404这五个坑占了九成概率5.1 启动失败怎么解决先分清是编译失败还是运行失败现象IDEA 点运行后控制台报一堆红字但你没耐心看只看到最下面写着Process finished with exit code 1于是截图去群里问“为什么启动失败”。 原因启动失败分两种一种是 Maven 编译失败代码有语法错误或依赖缺失另一种是运行失败端口被占用、数据库连不上、配置文件里的路径不存在。 解决第一步用mvn clean package -DskipTests在终端里单独编译看是否能出 jar 或 war。编译不过问题在依赖或代码编译过了再看启动日志。第二步查端口占用netstat -ano | findstr :8080有进程占用就直接换个端口常见做法是在application.yml里改server.port8081比去杀进程省事。第三步看日志里有没有Caused by绝大多数根因都在它后面那几行。Spring Boot 的启动日志不要只看最后三行要看从哪一行开始出现ERROR。5.2 MySQL 8 与老驱动不匹配连不上数据库现象启动时报CommunicationsException: Communications link failure或者Client does not support authentication protocol requested by server。 原因数据库脚本是给 MySQL 5.x 时代写的配套驱动是mysql-connector-java 5.1.x但本机装的是 MySQL 8.x。MySQL 8 默认的认证插件是caching_sha2_password老驱动不认。 解决两种办法任选。一是升级 Maven 依赖里的驱动坐标改成com.mysql:mysql-connector-j:8.0.x或com.mysql.cj:mysql-connector-j二是不换驱动改数据库用户的认证插件。做课程设计用第一种最省事改完依赖重新加载 Maven 即可。同时注意驱动类名也要改老的是com.mysql.jdbc.Driver新的是com.mysql.cj.jdbc.Driver。5.3 页面上中文全部乱码数据库和页面两层原因要分清现象登录后页面上的作业标题显示成“ä½ä¸ä¸é¢”数据库表里也是同样一串乱码。 原因如果是导入前就乱码说明 SQL 文件本身编码和 MySQL 会话编码不一致常见于用 Windows 记事本打开过 SQL 文件并保存成了 ANSI再用 utf8 终端导入出现乱码很正常。如果数据库表里是正常中文、页面乱码说明是 JSP 或 Controller 返回时的编码问题。 解决数据库层先执行show variables like character%;确认服务端编码是 utf8mb4再用--default-character-setutf8mb4重新导入。应用层Spring Boot 里基本不用配SSM 骨架项目记得在web.xml里加CharacterEncodingFilter且encoding参数设为UTF-8forceEncoding设为true。页面上如果是 JSP在文件头加% page contentTypetext/html;charsetUTF-8 languagejava %。5.4 作业附件上传成功却访问不了静态资源映射根本没配置现象学生端上传文件后显示成功但点下载或预览时 404浏览器的请求路径是http://localhost:8080/upload/homework/1/xxx.pdf后端目录里确实有文件。 原因文件落盘到服务器的本地目录了但 Web 应用没有把/upload/**这个 URL 映射到磁盘目录。很多课程设计工程里没有处理这一步或者只在写死路径的某个类里配了换目录就失效。 解决Spring Boot 里可以加一个配置类映射静态资源Configuration public class WebMvcConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { // 把 /upload/ 开头的请求指向磁盘上的 upload 目录 registry.addResourceHandler(/upload/**) .addResourceLocations(file: uploadRoot /); } }注意addResourceLocations必须以file:开头且以/结尾否则路径拼接会出错。改完重启再访问就能看到文件。5.5 学生重新提交后教师批改的成绩被清空现象教师给学生打了 90 分学生那边又点了“重新提交”成绩和评语全部消失状态变回“已提交待批改”。 原因提交逻辑里只要状态不是已提交就直接插入新记录或更新记录没判断这条记录是否已经批改过。更常见的是重新提交时执行了update t_submission set scorenull, commentnull把旧成绩擦掉了。 解决在重新提交换成 update 语句时不要清空 score 和 comment 字段如果业务上确实允许“批改后再次提交”就把状态回退成待批改并保留原成绩答辩时还能解释成“保留上一次批改痕迹”。我一般会在提交记录表里加一个last_score字段专门存上次批改成绩新成绩等教师再批改时覆盖score这样历史可追溯演示起来也有亮点。6. 答辩和二次开发前最后调整三处改动就能让项目“看起来全新”第一处重置演示数据。把手动测试产生的提交记录和脏数据清掉只保留一个教师账号、三个学生账号、两三条带成绩的提交记录。具体做法是写一个reset_demo.sql用DELETE FROM t_submission;清空提交再用UPDATE t_user SET passworde10adc3949ba59abbe56e057f20f883e WHERE usernameadmin;把密码统一重置为 123456 的 MD5 值。这样答辩现场登录流程不会乱。第二处把状态数字汉化。前端页面里直接显示status1会显得很硬核但不好看在 Controller 返回 Map 时加一个状态文本字段即可statusText映射为“待批改 / 已批改”前端展示用文本提交用数字。这个改动工作量很小但演示时观感提升明显。第三处把截止时间从Date格式统一输出成yyyy-MM-dd HH:mm并在教师端用一个醒目的标识区分“未开始 / 进行中 / 已截止”。判断逻辑很简单当前时间在 deadline 前、作业发布时间后就是进行中。答辩老师最常问的问题就是“这个系统怎么处理超时提交”你把这段逻辑指着讲清楚就稳了。我自己的习惯是在改这些之前先把数据库重新导入一遍用show tables确认没少表再启动系统走一遍“教师发布作业 → 教师批改 → 学生查看成绩”的完整链路。这一步能提前暴露八成问题比临时改代码靠谱得多。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/25 10:19:46 · 阅读 1.2k Java作业提交批改系统源码：解压、部署到跑通的完整避坑指南
简介一套基于Java开发的作业提交批改系统完整源码包含配套数据库脚本面向高校学生、Java Web开发者及需要搭建在线作业平台的教师。系统覆盖用户注册登录与权限管理、作业发布与提交、文件上传限制、自动与手动批改、成绩统计报表等核心模块涉及Spring Security/Shiro权限控制、Spring MVC请求处理、MyBatis/JPA持久化、NLP或相似度算法辅助批改等关键技术点前端可结合Bootstrap或Vue.js后端兼顾SQL注入/XSS防护与Redis缓存等性能优化并考虑Docker容器化部署。压缩包约17.42MB以Java源码、项目配置及数据库脚本为主目录结构清晰便于按模块阅读和二次开发。已有547人学习下载适合作为课程设计参考或Java Web综合项目练手能直观理解从数据库表设计到前后端交互、安全防护的完整实现路径对掌握企业级开发流程有较高参考价值。1. 拿到 rar 先别急着解压java 作业提交批改系统要过的三道关卡java 作业提交批改系统源码含数据库脚本.rar 这种压缩包十有八九是 Java 课程设计案例源码不是拿来就能跑的商品软件里面特意附带的数据库脚本说明作者希望你先把库建起来再谈业务。围绕它的需求其实很明确学生登录后能看到作业、提交文件教师登录后能发布作业、给分、写评语。真正常翻车的点不在功能而在启动阶段。这套系统的运行链路是 JDK、数据库、Maven 依赖、Web 容器四段接力任何一段版本不对都会让你对着黑匣子干瞪眼。对想拿它复习 java 面试题、准备答辩和二次开发的工程师这篇文章按顺序给出可直接抄的检查步骤和踩坑清单。2. 解压查证三步走目录结构、SQL 落库、Maven 镜像哪一步都不能跳过2.1 先找这三个文件再决定要不要往下走拿到压缩包我一般不会直接“解压到当前文件夹”而是先建一个干净目录比如D:/homework_sys再解压。解压后第一件事不是打开 IDEA是按优先级找这三样东西pom.xml或build.gradle、数据库脚本、README 或课程设计报告。pom.xml决定这个工程的构建方式。过去几年常见的课程设计模板是 Spring Boot MyBatis也有不少老包是 SSMSpring MVC Spring MyBatis配合 JSP 页面。这两种工程的启动方式不同Spring Boot 可以直接运行主类SSM 通常要打成 war 包扔进 Tomcat。你只有先确认这一点后面才不会出现“明明编译过了却不知道怎么启动”的尴尬。数据库脚本的位置不同作者放得很随意有的放在db/homework.sql有的直接放在根目录叫homework_system.sql还有的把它塞进doc文件夹。文件名也可能写得分不清比如init.sql、data.sql。我的建议是把这个文件先复制一份放到db目录改名为hw_backup_原文件名.sql再开始导入。这不是多此一举后续改表结构时这个备份就是后悔药改坏了还能秒回滚。README 或设计文档不是每个包都有但只要有就值得先花五分钟通读一遍。它通常会写清楚默认管理员账号、端口号、JDK 版本要求。没读文档直接开跑遇到账号密码不对再去翻代码那是白折腾。2.2 导入数据库脚本命令行和可视化工具手感不同字符集是共同大坑很多同学习惯用 Navicat 或 DataGrip 双击运行 SQL 文件但我更推荐在终端里用命令行先建库再导入。原因很简单命令行能把字符集问题暴露得明明白白而图形化工具默认字符集往往是继承连接设置的有时候导入成功了页面一查中文全乱码你还不知道是哪一步出了问题。下面是常见做法适用于绝大多数 MySQL 版本# 先建库显式指定字符集再把脚本导入 mysql -uroot -p --default-character-setutf8mb4 -e CREATE DATABASE IF NOT EXISTS homework_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -uroot -p homework_system --default-character-setutf8mb4 D:/homework_sys/homework_system.sql这段命令里做了两件事第一句建库时指定utf8mb4这是 MySQL 8 时代最稳妥的字符集能存 emoji 和生僻字第二句以同样的字符集把 SQL 文件灌进homework_system库。前后字符集一致是避免中文乱码的第一道防线。参数说明--default-character-setutf8mb4要放在-p后面、前面因为它作用于整个客户端会话不单是某一条 SQL。如果脚本里已经写了CREATE TABLE ... ENGINEInnoDB DEFAULT CHARSETutf8mb4那导入时这个参数更多是保证连接层的编码一致如果脚本里没写那连接层和表层的字符集必须都撑住否则表建出来就是 latin1。如果你非要用图形化工具记得在连接属性里手动把 encoding 设为utf8mb4并且导入前在工具里确认已选中目标数据库。Navicat 里有个经典坑只选了连接没选数据库然后直接运行脚本结果表全建到了默认库。导入完可以用show tables;和show create table t_user;验证。2.3 java 环境配置与工程语言等级两个最常见的版本冲突环境方面的坑很少是 JDK 没装而是“装了不止一个 JDK”。这类源码包多数基于 JDK 8 编写如果机器默认 JDK 是 17 或 21老工程直接启动可能会报UnsupportedClassVersionError。先看pom.xml里的配置再决定要不要切 JDK。properties maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target java.version1.8/java.version /properties像这样的配置说明它按 JDK 8 编译。如果你本机只有 JDK 17也不是不能跑但要注意 Spring Boot 2.x 配高版本 JDK 时可能会碰到 Lombok 版本过旧、反射访问受限等兼容问题。最省事的做法是在 IDEA 的 Project Structure 里把 SDK 切到 8如果没装就装一个 JDK 8u202 之后的小版本然后用 IDEA 管理多版本 JDK不要动系统环境变量。Maven 依赖下载这块很多人的体验是“点完运行等半天最后报依赖拉取失败”。这跟网络有直接关系解决办法是给 Maven 配置国内镜像仓库具体做法是修改 Maven 安装目录下的conf/settings.xml在mirrors节点里加一个镜像源。这里不贴具体域名因为不同时段可用性不一样原则就是找个能访问的镜像再把本地仓库localRepository指向一个非系统盘目录避免系统盘爆掉。还有一个容易被忽略的点老工程如果用的是 Tomcat 运行IDEA 里默认会用工程自带的本地 Tomcat版本不对时会出现启动时 ClassNotFound 或版本警告。建议先确认pom.xml里packagingwar/packaging还是jar再选择运行方式。这一点确认对了比后面调半天代码都管用。3. 读懂数据库脚本里的三张核心表批改系统的状态流转就漏不了3.1 用户表、作业表、提交表实体关系和一段建表脚本作业提交批改系统的核心说穿了就是三张表在转人、作业、提交记录。几乎所有这类源码包都会围绕它们做扩展有的多一张班级表有的多一张公告表但骨架不会变。先看一张我整理的表结构概览表名定位关键字段关系说明t_user用户与角色id, username, password, real_name, role, student_no/teacher_norole 区分学生、教师password 通常是 MD5t_homework教师发布的作业id, title, content, deadline, teacher_idteacher_id 指向 t_user.idt_submission学生提交与批改结果id, homework_id, student_id, file_name, status, score, comment, submit_timehomework_id 指向 t_homeworkstudent_id 指向 t_user打开 SQL 脚本后直接搜CREATE TABLE看到这三张表你对整个系统的理解就算成立了。数据库脚本里通常还会带INSERT INTO的初始数据包括管理员账号、演示学生账号别把这些删了后续登录都要靠它们。这段建表脚本是一个很经典的写法很多课程设计会采用近似结构CREATE TABLE t_user ( id int(11) NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL COMMENT 登录名, password varchar(64) NOT NULL COMMENT MD5密码, real_name varchar(30) DEFAULT NULL COMMENT 姓名, role tinyint(4) DEFAULT 1 COMMENT 1学生 2教师 3管理员, student_no varchar(20) DEFAULT NULL COMMENT 学号, teacher_no varchar(20) DEFAULT NULL COMMENT 工号, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT用户表;这里要特别注意两个设计决策。一是role用数字而不是字符串它在 Java 代码里通常对应一个枚举或者一串 if 判断二是学号和工号共用一张表不单独建教师表和学生表。这样做的好处是登录逻辑统一坏处是学生在教师端接口的权限校验就要靠 role而不是靠表名天然隔离。后面做权限拦截器时必须同时判断 role 和访问路径。3.2 submission 表上的四个状态让作业批改有迹可查提交表是整个系统的状态中心它比作业表更能体现系统设计水平。大多数源码包会用一个 status 字段来标记提交记录状态常见的取值我不只见到一种有的是 0 未交、1 已交、2 已批改有的把“重新提交”也单独算一个状态。建议你在拿到脚本后先搜一下status这个字段看注释或代码里的常量定义把状态枚举列全。CREATE TABLE t_submission ( id int(11) NOT NULL AUTO_INCREMENT, homework_id int(11) NOT NULL, student_id int(11) NOT NULL, file_name varchar(255) DEFAULT NULL COMMENT 上传的文件名, file_path varchar(255) DEFAULT NULL COMMENT 存储路径, status tinyint(4) DEFAULT 0 COMMENT 0未提交 1已提交待批改 2已批改, score int(11) DEFAULT NULL COMMENT 成绩, comment varchar(500) DEFAULT NULL COMMENT 教师评语, submit_time datetime DEFAULT NULL, review_time datetime DEFAULT NULL, PRIMARY KEY (id), KEY idx_homework (homework_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT提交批改表;注意这里没有设置UNIQUE KEY (homework_id, student_id)这种设计在课程设计里很常见但其实是隐患。如果不加唯一约束学生连续点两次提交就会插入两条记录教师端看到的就是同一学生提交了多份。实际开发中我会在代码提交前先查一次select count(*) from t_submission where homework_id? and student_id?或者干脆给表加联合唯一索引。加唯一索引的做法更稳代价是重新提交时必须改成ON DUPLICATE KEY UPDATE或者先 delete 再 insert。3.3 角色控制一张 user 表的 role 字段撑起三种权限这套系统里权限控制往往不是靠 Spring Security而是靠一个拦截器加 Session 里的登录用户对象。它的原理很简单用户登录后把用户实体放进 Session拦截器在每次请求进来时从 Session 取用户再判断访问路径和角色是否匹配。看源码时优先找Interceptor或WebConfig类里面通常有这段逻辑// 简化版拦截器按路径前缀区分学生端和教师端 public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 登录放行Session 里没有 user 就跳转登录页 Object user request.getSession().getAttribute(loginUser); if (user null) { response.sendRedirect(/login); return false; } // 从 URI 前缀判断访问方向/teacher/** 只允许教师和管理员访问 String uri request.getRequestURI(); if (uri.startsWith(/teacher/)) { // role 字段1 学生2 教师3 管理员 int role ((User) user).getRole(); if (role ! 2 role ! 3) { response.sendRedirect(/student/index); return false; } } return true; } }这段代码的作用是给请求分层设卡。参数说明就一点startsWith(/teacher/)这种判断方式依赖 URL 命名规范所以如果你改路由名拦截器也要同步改否则会出现“明明登录了却被踢回首页”的玄学问题。读这种源码时重点不是把每一行都看懂而是抓住“登录 → 取 role → 匹配 URL 前缀”这条主线。面试时被问到权限怎么做把这段逻辑讲清楚比背一堆框架配置更有说服力。4. 提交与批改两条业务主链路代码该写在哪、参数该给多大4.1 学生提交作业截止时间校验和文件存储路径的取舍主链路代码里学生提交作业是最容易写坏的地方。常见的错误是只做上传不校验截止时间稍微好一点的做了校验但校验用的是数据库时间而不是服务器时间导致在学生本机改个系统时间就能绕过。下面这段是学生提交作业的一个最小可用写法// 学生提交作业校验作业存在、校验截止时间、落盘文件 public boolean studentSubmit(Integer studentId, Integer homeworkId, MultipartFile file) { Homework hw homeworkMapper.findByPk(homeworkId); if (hw null) { return false; } // 时间判断统一用 new Date()不要信前端传的时间 Date now new Date(); if (hw.getDeadline() ! null now.after(hw.getDeadline())) { return false; } // 文件名加 UUID防止两个学生传同名文件互相覆盖 String originalName file.getOriginalFilename(); String suffix ; if (originalName ! null originalName.contains(.)) { suffix originalName.substring(originalName.lastIndexOf(.)); } String fileName UUID.randomUUID().toString().replace(-, ) _ System.currentTimeMillis() suffix; // 按作业 ID 建子目录避免单个目录文件过多 String path uploadRoot /homework/ homeworkId; File dir new File(path); if (!dir.exists()) { dir.mkdirs(); } File dest new File(dir, fileName); try { file.transferTo(dest); } catch (IOException e) { return false; } // 记录提交数据status 置 1 表示待批改 Submission sub new Submission(); sub.setHomeworkId(homeworkId); sub.setStudentId(studentId); sub.setFileName(fileName); sub.setFilePath(dest.getAbsolutePath()); sub.setSubmitTime(now); sub.setStatus(1); return submissionMapper.insert(sub) 0; }这段代码值得注意的参数是uploadRoot。很多源码包会把它写成绝对路径写死在代码里比如D:/upload这会带来两个问题一是换电脑跑路径不存在上传失败二是部署到 Linux 服务器反斜杠路径直接报错。我一般建议把上传根目录放到application.yml的配置项里通过Value注入并且用相对路径加系统属性拼接file.upload-root${user.dir}/upload这样工程跑起来后上传目录会自动生成在工作目录下换环境不用改代码最多改个配置。4.2 教师批改作业成绩回写要有一点“幂等”意识教师批改的成绩回写逻辑看似简单就是 update 一条记录但有两个高频 bug。第一个是成绩被重复提交页面刷新一次点一次批改score 就被覆盖一次虽然表面上结果一样但 review_time 和审核状态会不断变化答辩时被问到“这条记录为什么审核了三次”你很难解释。第二个是批改时并发问题教师 A 和教师 B 同时打开同一份提交记录后保存的会把先保存的评语覆盖掉。处理方式其实很简单加一个事务并在更新前检查当前状态Transactional public int gradeSubmission(Integer submissionId, Integer teacherId, Integer score, String comment) { // 先按主键查出来只有处于“已提交待批改”状态才能打分 Submission sub submissionMapper.findByPk(submissionId); if (sub null || sub.getStatus() ! 1) { return 0; } // 回写成绩和评语状态改为已批改 Submission update new Submission(); update.setId(submissionId); update.setScore(score); update.setComment(comment); update.setTeacherId(teacherId); update.setReviewTime(new Date()); update.setStatus(2); return submissionMapper.updateByPk(update); }这里的核心在sub.getStatus() ! 1这个判断。它保证了只有待批改的记录能被批改已经批改过的记录再提交这个接口会被直接拒绝。这就是把“幂等”落到了状态上同样的请求发一百次只有第一次生效。如果项目里没有这个判断教师端按钮连续快速点击两次就会出现两条同样内容的批改日志虽然不影响最终成绩但数据表里 review_time 变化会让人不舒服。4.3 作业完成率统计未交名单用左连接别在 Java 内存里过滤教师端首页一般要显示“某个作业还有几个人没交”很多新手拿到这类源码会惊讶地发现统计完成率居然是把所有学生查出来再循环判断有没有提交记录。这种写法数据量小的时候没问题但答辩演示时一旦把表数据导成几百人页面就会明显卡顿。更合理的做法是把筛选下推到 SQL用左连接一次查出来。下面这段是典型实现-- 查询某个作业的未交学生名单 SELECT u.id, u.real_name, u.student_no FROM t_user u LEFT JOIN t_submission s ON s.homework_id 5 AND s.student_id u.id WHERE u.role 1 AND s.id IS NULL;这里的核心技巧是s.id IS NULL。LEFT JOIN 会把没有匹配记录的学生行保留下来此时右边的提交表字段全是 NULL所以IS NULL正好筛出未提交的人。注意ON条件里带了s.homework_id 5这个条件不能挪到WHERE里否则左连接会退化成内连接未交名单就查不出来了。很多人在这个 SQL 上翻过车现象是“明明有人没交查出来却全是已交”。5. 避坑篇启动失败、中文乱码、文件访问 404这五个坑占了九成概率5.1 启动失败怎么解决先分清是编译失败还是运行失败现象IDEA 点运行后控制台报一堆红字但你没耐心看只看到最下面写着Process finished with exit code 1于是截图去群里问“为什么启动失败”。 原因启动失败分两种一种是 Maven 编译失败代码有语法错误或依赖缺失另一种是运行失败端口被占用、数据库连不上、配置文件里的路径不存在。 解决第一步用mvn clean package -DskipTests在终端里单独编译看是否能出 jar 或 war。编译不过问题在依赖或代码编译过了再看启动日志。第二步查端口占用netstat -ano | findstr :8080有进程占用就直接换个端口常见做法是在application.yml里改server.port8081比去杀进程省事。第三步看日志里有没有Caused by绝大多数根因都在它后面那几行。Spring Boot 的启动日志不要只看最后三行要看从哪一行开始出现ERROR。5.2 MySQL 8 与老驱动不匹配连不上数据库现象启动时报CommunicationsException: Communications link failure或者Client does not support authentication protocol requested by server。 原因数据库脚本是给 MySQL 5.x 时代写的配套驱动是mysql-connector-java 5.1.x但本机装的是 MySQL 8.x。MySQL 8 默认的认证插件是caching_sha2_password老驱动不认。 解决两种办法任选。一是升级 Maven 依赖里的驱动坐标改成com.mysql:mysql-connector-j:8.0.x或com.mysql.cj:mysql-connector-j二是不换驱动改数据库用户的认证插件。做课程设计用第一种最省事改完依赖重新加载 Maven 即可。同时注意驱动类名也要改老的是com.mysql.jdbc.Driver新的是com.mysql.cj.jdbc.Driver。5.3 页面上中文全部乱码数据库和页面两层原因要分清现象登录后页面上的作业标题显示成“ä½ä¸ä¸é¢”数据库表里也是同样一串乱码。 原因如果是导入前就乱码说明 SQL 文件本身编码和 MySQL 会话编码不一致常见于用 Windows 记事本打开过 SQL 文件并保存成了 ANSI再用 utf8 终端导入出现乱码很正常。如果数据库表里是正常中文、页面乱码说明是 JSP 或 Controller 返回时的编码问题。 解决数据库层先执行show variables like character%;确认服务端编码是 utf8mb4再用--default-character-setutf8mb4重新导入。应用层Spring Boot 里基本不用配SSM 骨架项目记得在web.xml里加CharacterEncodingFilter且encoding参数设为UTF-8forceEncoding设为true。页面上如果是 JSP在文件头加% page contentTypetext/html;charsetUTF-8 languagejava %。5.4 作业附件上传成功却访问不了静态资源映射根本没配置现象学生端上传文件后显示成功但点下载或预览时 404浏览器的请求路径是http://localhost:8080/upload/homework/1/xxx.pdf后端目录里确实有文件。 原因文件落盘到服务器的本地目录了但 Web 应用没有把/upload/**这个 URL 映射到磁盘目录。很多课程设计工程里没有处理这一步或者只在写死路径的某个类里配了换目录就失效。 解决Spring Boot 里可以加一个配置类映射静态资源Configuration public class WebMvcConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { // 把 /upload/ 开头的请求指向磁盘上的 upload 目录 registry.addResourceHandler(/upload/**) .addResourceLocations(file: uploadRoot /); } }注意addResourceLocations必须以file:开头且以/结尾否则路径拼接会出错。改完重启再访问就能看到文件。5.5 学生重新提交后教师批改的成绩被清空现象教师给学生打了 90 分学生那边又点了“重新提交”成绩和评语全部消失状态变回“已提交待批改”。 原因提交逻辑里只要状态不是已提交就直接插入新记录或更新记录没判断这条记录是否已经批改过。更常见的是重新提交时执行了update t_submission set scorenull, commentnull把旧成绩擦掉了。 解决在重新提交换成 update 语句时不要清空 score 和 comment 字段如果业务上确实允许“批改后再次提交”就把状态回退成待批改并保留原成绩答辩时还能解释成“保留上一次批改痕迹”。我一般会在提交记录表里加一个last_score字段专门存上次批改成绩新成绩等教师再批改时覆盖score这样历史可追溯演示起来也有亮点。6. 答辩和二次开发前最后调整三处改动就能让项目“看起来全新”第一处重置演示数据。把手动测试产生的提交记录和脏数据清掉只保留一个教师账号、三个学生账号、两三条带成绩的提交记录。具体做法是写一个reset_demo.sql用DELETE FROM t_submission;清空提交再用UPDATE t_user SET passworde10adc3949ba59abbe56e057f20f883e WHERE usernameadmin;把密码统一重置为 123456 的 MD5 值。这样答辩现场登录流程不会乱。第二处把状态数字汉化。前端页面里直接显示status1会显得很硬核但不好看在 Controller 返回 Map 时加一个状态文本字段即可statusText映射为“待批改 / 已批改”前端展示用文本提交用数字。这个改动工作量很小但演示时观感提升明显。第三处把截止时间从Date格式统一输出成yyyy-MM-dd HH:mm并在教师端用一个醒目的标识区分“未开始 / 进行中 / 已截止”。判断逻辑很简单当前时间在 deadline 前、作业发布时间后就是进行中。答辩老师最常问的问题就是“这个系统怎么处理超时提交”你把这段逻辑指着讲清楚就稳了。我自己的习惯是在改这些之前先把数据库重新导入一遍用show tables确认没少表再启动系统走一遍“教师发布作业 → 教师批改 → 学生查看成绩”的完整链路。这一步能提前暴露八成问题比临时改代码靠谱得多。希望帮到你。本文还有配套的精品资源点击获取