基于Java+MySQL的SSM网上作业批改系统实战

简介这套网上作业批改系统源码包面向Java Web课程设计、毕业设计参考及入门练手人群围绕作业批改与教学资料管理场景提供一套较完整的管理端实现。系统强调操作简便与友好提示管理员可完成班级、教师、学生、公告、留言、资料及管理员自身信息管理包含录入、查询、删除、打印等常用操作并兼顾基本安全控制便于理解权限与数据维护流程。压缩包共265个文件约1.93MB主要由JSP页面、Java源码与class文件、SQL数据库脚本、JavaScript/CSS及图片素材、jar依赖和doc/docx说明文档构成前后端页面、业务代码与建库脚本相对齐全适合对照学习Servlet分层处理、页面交互和数据库表结构。目前已有1615人学习下载可作为课程项目搭建、功能扩展、二次开发和代码阅读的参考样本也可作为课程设计选题与答辩演示的基础版本。1. 网上作业批改系统Java MySQL 做一套能真正跑起来的教学工具带学生做课程设计时最常被问到的不是“怎么用框架”而是“老师收完作业之后后面那些事能不能自动处理”。一个班几十份代码或文档人工看一遍都很费劲更别说打分、写评语、统计成绩、退回重做。这个基于 Java MySQL 的网上作业批改系统解决的正是这类从发布作业到给出分数之间的流程问题教师发布作业、学生提交、系统记录批改结果、学生查看反馈整条链路都放在一个 Web 后台里完成。它适合三类人正在找 Java Web 课程设计题目的学生、想给小型培训机构搭一套内部作业管理的开发者以及想拿一个结构干净、体量可控的 SSMSpring SpringMVC MyBatis项目练手的后端新手。技术栈没有追新JDK 8 加 MySQL 5.7/8.0 就能起步前端是 JSP 或静态页配合少量 JS追求的是“看得懂、改得动、答辩讲得清”。2. 技术选型与目录结构一个 SSM 项目到底由哪几层拼起来2.1 为什么是 SSM 而不是 Spring Boot这个项目的典型形态是传统 SSM 分层架构Maven 管理依赖Tomcat 作为 Web 容器MySQL 存业务数据。选择 SSM 的理由很实在一是它把控制层、业务层、持久层拆得分明初学者能清楚看到一次请求在Controller → Service → Mapper → 数据库之间怎么流转二是各组件配置都以 XML 形式显式暴露出了问题能顺着配置文件一处处排查不像全注解加自动装配那样“黑匣子”感太重。实际部署时常见做法是把项目打成 WAR 包放进 Tomcat 的webapps目录启动开发阶段则在 IDE 里配置本地 Tomcat 直接跑。数据库连接信息写在jdbc.properties或applicationContext.xml中连接池一般用 Druid 或 C3P0中小体量下两者都够用。提示如果你本地是 JDK 17 及以上编译时容易遇到javax.*包找不到的问题因为老版 SSM 仍依赖 Java EE 命名空间。稳妥做法是单独装一个 JDK 8 作为项目 SDK别硬升级。2.2 目录结构与各层职责一个典型的 Maven Web 工程目录大致如下assignment-system/ ├── pom.xml └── src/main/ ├── java/com/example/assignment/ │ ├── controller/ # 控制层接收请求、返回视图或数据 │ ├── service/ # 业务层批改逻辑、成绩统计 │ │ └── impl/ │ ├── mapper/ # 持久层接口对应 XML 映射文件 │ ├── entity/ # 实体类User、Assignment、Submission、Score │ └── util/ # 工具类文件上传、日期格式化、分页 ├── resources/ │ ├── mapper/ # MyBatis 的 SQL 映射 XML │ ├── jdbc.properties # 数据库连接配置 │ ├── applicationContext.xml │ └── spring-mvc.xml └── webapp/ ├── WEB-INF/ │ ├── web.xml # 前端控制器与编码过滤器 │ └── views/ # JSP 页面 └── static/ # css、js、上传文件目录entity包里最核心的四张表对应实体用户表存学生和教师账号作业表记录标题、截止时间、满分提交表保存学生上传的文件路径和提交时间批改表则存分数、评语和批改人。这几张表之间的关系决定了后面所有业务逻辑的走向。2.3 请求处理链路一段典型的 Controller 代码长这样负责学生提交作业Controller RequestMapping(/submission) public class SubmissionController { Autowired private SubmissionService submissionService; /** * 学生提交作业 * param assignmentId 作业ID * param file 上传的作业文件 * param session 当前登录会话用于取学生ID */ PostMapping(/submit) public String submit(RequestParam(assignmentId) Long assignmentId, RequestParam(file) MultipartFile file, HttpSession session, RedirectAttributes ra) { User user (User) session.getAttribute(loginUser); if (user null) { return redirect:/login; // 未登录直接踢回登录页 } if (file null || file.isEmpty()) { ra.addFlashAttribute(msg, 请选择要提交的文件); return redirect:/assignment/detail?id assignmentId; } boolean ok submissionService.saveSubmission( assignmentId, user.getId(), file); ra.addFlashAttribute(msg, ok ? 提交成功 : 提交失败请重试); return redirect:/assignment/detail?id assignmentId; } }这段代码里几个点值得留意。RequestParam(file)必须和表单里的enctypemultipart/form-data配合否则文件对象永远是空。RedirectAttributes的作用是重定向之后还能把提示消息带过去避免用户刷新页面时重复提交这也是这个项目里最常被忽略的一处细节。业务判断全部下沉到SubmissionServiceController 只负责参数校验和视图跳转。对应的 Service 实现会先检查截止时间再落库Service public class SubmissionServiceImpl implements SubmissionService { Autowired private SubmissionMapper submissionMapper; Autowired private AssignmentMapper assignmentMapper; Override public boolean saveSubmission(Long assignmentId, Long studentId, MultipartFile file) { Assignment assignment assignmentMapper.findById(assignmentId); if (assignment null) { return false; } // 截止时间之后退回是否允许迟交由作业配置决定 if (new Date().after(assignment.getDeadline()) !assignment.getAllowLate()) { return false; } String relativePath FileUtil.save(file, upload/submission); Submission submission new Submission(); submission.setAssignmentId(assignmentId); submission.setStudentId(studentId); submission.setFilePath(relativePath); submission.setStatus(UNGRADED); // 初始为待批改 submission.setSubmitTime(new Date()); return submissionMapper.insert(submission) 0; } }allowLate字段是一个很实用的设计不同老师对迟交的态度不一样把“是否允许迟交”做成作业维度的开关比在代码里写死更灵活。status用字符串常量而非数字方便后续页面直接显示代价是数据库多占一点空间在教学项目里完全可接受。3. 批改模块拆解分数、评语和状态流转怎么落地3.1 批改表的设计与状态流转批改是这个系统的核心。学生在截止前提交教师在后台看到“待批改”列表逐个打开写分数和评语提交后学生端立即可见。这套流转依赖submission表的status字段UNGRADED表示已提交待批改GRADED表示已批改RETURNED表示打回要求重做。状态只允许按这三条路径变化避免出现“批改完成后又被退回却分数还在”的脏数据。CREATE TABLE submission ( id BIGINT PRIMARY KEY AUTO_INCREMENT, assignment_id BIGINT NOT NULL COMMENT 作业ID, student_id BIGINT NOT NULL COMMENT 学生ID, file_path VARCHAR(255) NOT NULL COMMENT 上传文件相对路径, submit_time DATETIME NOT NULL, score DECIMAL(5,1) DEFAULT NULL, comment TEXT DEFAULT NULL, grader_id BIGINT DEFAULT NULL COMMENT 批改教师ID, grade_time DATETIME DEFAULT NULL, status VARCHAR(20) NOT NULL DEFAULT UNGRADED );这里没有把批改记录单独拆成一张表原因在于一个学生针对同一份作业通常只有一份有效提交拆表会引入额外的关联查询对这个体量的系统并不划算。如果要做“多次提交、保留历史版本”那就得改成提交历史表加最新提交视图代码复杂度直接翻倍不建议新手一上来就这么干。3.2 批改接口与成绩校验教师批改的 Controller 接口如下PostMapping(/grade) public String grade(RequestParam(submissionId) Long submissionId, RequestParam(score) Double score, RequestParam(comment) String comment, RequestParam(status) String status, HttpSession session, RedirectAttributes ra) { User teacher (User) session.getAttribute(loginUser); if (teacher null || !TEACHER.equals(teacher.getRole())) { return redirect:/login; } // 分数必须落在 0 到作业满分之间 Submission sub submissionService.findById(submissionId); Assignment assignment assignmentService.findById(sub.getAssignmentId()); if (score 0 || score assignment.getFullScore()) { ra.addFlashAttribute(msg, 分数超出范围); return redirect:/grade/list; } boolean ok gradingService.grade(submissionId, teacher.getId(), score, comment, status); ra.addFlashAttribute(msg, ok ? 批改完成 : 操作失败); return redirect:/grade/list; }我把分数范围校验放在 Controller 里而不是丢给数据库或前端是有血泪经验的。前端做一层max限制很容易被绕过数据库用CHECK约束在 MySQL 5.7 又不生效最后还得靠后端代码守住这道线。status由前端传入是因为老师可能选了“打回重做”这时候分数允许为空业务含义和正常批改不同。3.3 学生端查看反馈与成绩统计学生端最常用的是“我的作业”列表展示提交状态、分数和评语。这里通常要做一个按作业聚合的查询统计每个学生的已批改数量、平均分、最高分select idstatByStudent resultTypemap SELECT s.student_id, COUNT(s.id) AS total, SUM(CASE WHEN s.status GRADED THEN 1 ELSE 0 END) AS graded, ROUND(AVG(s.score), 2) AS avgScore, MAX(s.score) AS maxScore FROM submission s WHERE s.assignment_id #{assignmentId} GROUP BY s.student_id /select这段 SQL 的写法是教学项目里最常用的“一条语句出全部统计”。SUM(CASE WHEN ...)是经典的计数技巧比写两次查询简单得多。ROUND(AVG(...), 2)保留两位小数防止页面上出现一长串浮点数。参数assignmentId用占位符而非拼接顺带规避了 SQL 注入。4. 本地部署与联调从导入工程到第一个页面能打开4.1 环境准备与数据库初始化跑这个项目前需要把环境摆齐JDK 8、Maven 3.6 以上、MySQL 5.7 或 8.0、Tomcat 8.5 或 9。MySQL 版本要注意驱动包区分5.x 用com.mysql.jdbc.Driver8.x 用com.mysql.cj.jdbc.Driver并在连接串里带上时区参数。# 建库并导入表结构与初始数据 mysql -u root -p -e CREATE DATABASE assignment_db DEFAULT CHARSET utf8mb4; mysql -u root -p assignment_db docs/schema.sql mysql -u root -p assignment_db docs/data.sqlutf8mb4这一步不能省评语里经常出现中文标点甚至表情符号用utf8会在插入时报截断错误。data.sql一般包含一个教师账号和一个学生账号密码用明文或简单 MD5首次登录后可自行修改。4.2 配置修改与启动数据库配置通常集中在jdbc.propertiesjdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/assignment_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password你的密码serverTimezone不写容易遇到The server time zone value ... is unrecognized的报错本质是驱动和数据库时区对不上。useSSLfalse只是本地调试省事线上环境要按实际情况调整。启动方式有两种。IDE 里配置本地 Tomcat把项目 Deployment 加进去访问http://localhost:8080/assignment-system/login或者命令行mvn clean package打出 WAR丢进 Tomcat 的webapps目录。两种方式效果一样前者改代码热部署快后者更接近真实部署。注意上传文件的目录要提前建好并保证 Tomcat 进程有写权限。Windows 上一般不会卡Linux 下用chmod给一下写权限否则提交作业时后台日志会报FileNotFoundException前端却只提示“提交失败”排查时容易绕远路。4.3 登录跳转与拦截器联调登录成功后通常靠一个拦截器把未登录用户挡在业务页面之外public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object user request.getSession().getAttribute(loginUser); if (user null) { response.sendRedirect(request.getContextPath() /login); return false; // 中断请求不再进入 Controller } return true; } }拦截器要在spring-mvc.xml里注册并排除登录、静态资源等路径。常见翻车点是拦截了/static/**导致页面样式全丢或者忘了request.getContextPath()部署到带上下文的路径下跳转地址就错了。联调阶段建议先把拦截器注释掉跑一遍确认业务链路通了再开回来比一上来就排查 404 高效得多。5. 常见问题排查五个最容易被卡住的坑5.1 提交后数据库有记录但页面显示空白现象学生提交作业成功数据库submission表能查到记录但列表页不显示。原因多半是查询 SQL 里用了INNER JOIN user而学生账号的关联字段为空或者 MyBatis 映射的下划线字段没开驼峰转换。解决在mybatis-config.xml里打开mapUnderscoreToCamelCasetrue并检查关联字段是否在插入时赋了值。5.2 中文评语存进数据库变成问号现象教师输入中文评语保存后查出来是一串???。原因是数据库或表的字符集不是utf8mb4或者 JDBC 连接串没带characterEncodingutf8。解决统一把库、表、连接三处的字符集对齐已建好的表可以用ALTER TABLE submission CONVERT TO CHARACTER SET utf8mb4;修。5.3 上传大文件直接报 500现象小文件能传几十兆的作业一提交就 500。原因是 Spring 的MultipartResolver默认大小限制偏小。解决在spring-mvc.xml中给CommonsMultipartResolver配置maxUploadSize比如设成5242880050MB同时检查 Tomcat 的server.xml里Connector是否也有大小限制。5.4 批改后学生端不刷新现象老师批改完成学生刷新页面还是显示“待批改”。原因是列表查询走了缓存或者前端 AJAX 请求带了缓存头。解决先确认数据库status已经更新再检查页面查询是否用了旧值必要时给请求加时间戳参数或者设置Cache-Control: no-store。5.5 WAR 包部署后 404现象IDE 里一切正常打成 WAR 放进 Tomcat 后访问全是 404。原因是web.xml里的DispatcherServlet映射路径和访问路径对不上或者打包时WEB-INF/lib缺依赖。解决检查maven-war-plugin配置、确认spring-mvc.xml被正确加载日志里通常会有No mapping found的线索顺着看即可。6. 二次开发改造从“能跑”到“敢改”的三步走接手这种项目我一般不建议一上来就动核心批改逻辑先做三件低风险但收益明显的改造。第一步是把文件存储从本地目录换成可配置的存储路径。现在很多代码里写死了upload/submission迁移服务器就得改代码。可以抽一个FileStorage接口本地实现和对象存储实现各一份配置文件里指定用哪个。表里只存相对路径或文件 key页面通过一个下载接口读取而不是直接暴露物理路径顺带解决权限问题。public interface FileStorage { String save(MultipartFile file, String bizType); InputStream load(String key); } // 配置文件中注入具体实现Controller 只依赖接口 Autowired private FileStorage fileStorage;第二步是给批改操作加一条操作日志。教学项目往往忽略审计但真到多人使用谁在什么时候改了分数、改前改后是多少这些信息很重要。可以在gradingService.grade()方法前后各取一次旧值和新值写入grade_log表字段包括操作人、提交ID、旧分数、新分数、时间。改动量很小却能省掉后面无数“分数怎么变了”的扯皮。第三步是把状态流转收拢到一个方法里统一判断。现在UNGRADED → GRADED → RETURNED的合法路径散落在各个 Controller 里加一种新状态比如“申诉中”就得全局找。抽一个SubmissionStatusMachine用枚举加switch定义允许的迁移非法迁移直接抛业务异常。验证方法是写几个单元测试把合法和非法路径都覆盖一遍跑通了再上线。改造点改动范围风险建议优先级文件存储抽象util controller低高批改操作日志service 一张新表低高状态机收拢service 核心逻辑中中最后固定一套验证习惯每改一处先用教师账号完整走一遍“发布作业 → 学生提交 → 批改 → 学生查看”的流程再检查数据库里status、score、grade_time三个字段是否符合预期。从那以后我每次动这类项目的批改逻辑都强制先把这条链路手动跑一遍不看日志不放心。希望这套拆解能帮到你把这份源码真正跑成自己手里的东西。本文还有配套的精品资源点击获取