1. 项目概述：为什么选择Spring Boot构建作业管理系统
大学教务管理中最让人头疼的环节之一就是作业管理。我曾在某高校信息化部门工作期间，亲眼目睹老师们用Excel表格收集作业，通过邮件附件来回发送批改版本，最终在成绩录入时出现版本混淆。这种传统方式存在三个致命缺陷：作业版本混乱导致批改错误率高达12%、师生沟通效率低下（平均每个问题需要3.5次邮件往返）、作业数据无法与教务系统联动。
Spring Boot的出现为这类场景提供了完美解决方案。去年我们团队用Spring Boot重构的作业系统，将批改错误率降到0.3%，师生互动响应时间缩短至4小时内。这个框架的自动配置特性让我们仅用两周就完成了基础功能开发，而传统SSH架构至少需要六周。
2. 系统架构设计解析
2.1 技术栈选型决策
核心框架选择Spring Boot 3.1.5版本而非最新的4.x系列，这是经过严格测试后的决定。在兼容性测试中，我们发现4.x对某些国产中间件的支持尚不完善，而3.1.5在信创环境下运行稳定。数据库采用MySQL 8.0而非MongoDB，主要考虑三点：作业数据的关系型特征明显（如学生-课程-作业的多对多关系）、高校IT部门现有MySQL运维能力、事务一致性要求。
前端采用Thymeleaf + Bootstrap 5的组合而非前后端分离架构，这个选择曾引发团队激烈讨论。最终选择服务端渲染方案是因为：1) 学校网络环境对静态资源加载不稳定 2) 需要快速响应教务处格式调整需求 3) 避免跨域问题带来的部署复杂度。
2.2 核心功能模块设计
系统划分为六个关键模块，其交互关系如下图所示（用文字描述）：
- 身份认证模块：处理RBAC权限体系，包含JWT令牌发放
- 作业发布模块：支持富文本编辑、附件上传、DDL设置
- 提交管理模块：包含防抄袭检测、格式校验
- 批改系统模块：集成评语模板、分数计算
- 数据统计模块：生成作业完成率、得分分布等报表
- 消息通知模块：通过WebSocket实现实时提醒
特别要说明的是批改系统的设计细节：我们开发了批注叠加功能，老师可以在学生作业PDF上直接添加批注图层，这些批注会以矢量形式存储，确保在不同设备上显示一致。这个功能使用PDFBox库实现，通过Spring Content管理文档版本。
3. 关键技术实现细节
3.1 安全控制实现方案
采用Spring Security + JWT的组合时，我们踩过一个重要坑点：最初直接将用户权限信息编码在token中，导致权限变更后旧token仍然有效。最终方案是：
- 生成token时包含权限版本号
- 每次请求比对Redis中的最新版本
- 版本不一致时强制重新登录
权限控制代码示例（简化版）：
java复制@PreAuthorize("hasRole('TEACHER') and @accessControl.checkCourseOwnership(#courseId)")
@PostMapping("/assignments")
public ResponseEntity<?> createAssignment(@PathVariable Long courseId,
@Valid @RequestBody AssignmentDTO dto) {
// 实现逻辑
}
这个注解组合实现了双重验证：既检查用户角色是否为教师，又通过自定义方法验证该教师是否确实教授这门课程。
3.2 作业提交防并发处理
当多个TA同时批改同一份作业时，我们采用乐观锁机制防止覆盖问题：
sql复制UPDATE assignment_submission
SET grade = ?, feedback = ?, version = version + 1
WHERE id = ? AND version = ?
前端配合使用WebSocket实时同步批改状态，当检测到版本冲突时，系统会弹出差异对比界面，类似Git的merge conflict解决流程。
4. 性能优化实战记录
4.1 批改高峰期应对策略
期中期末时系统面临严峻挑战：某次期末考试周，系统峰值QPS达到平时20倍。我们通过以下措施保障稳定性：
- 引入HikariCP连接池，配置如下：
yaml复制spring: datasource: hikari: maximum-pool-size: 20 connection-timeout: 30000 idle-timeout: 600000 - 对作业列表接口添加二级缓存（Redis + 本地缓存）
- 使用Spring Batch处理批量成绩导入
4.2 文件存储优化方案
最初使用本地文件存储时遭遇严重问题：某次服务器磁盘故障导致300多份作业丢失。迁移到MinIO集群时，我们特别实现了：
- 分片上传：大文件自动分块传输
- 智能清理：根据课程结束日期自动迁移冷数据到廉价存储
- 哈希校验：所有文件上传时计算SHA-256值
5. 典型问题排查手册
5.1 作业提交异常处理
常见问题1：学生提交的ZIP文件解压失败
- 排查步骤：
- 检查文件头魔数确认真实格式
- 使用Apache Commons Compress进行安全解压
- 设置10MB内存限制防止ZIP炸弹
常见问题2：跨时区提交时间判定错误
- 解决方案：
java复制所有时间判断都基于这个时钟实例@Bean public Clock systemClock() { return Clock.system(ZoneId.of("Asia/Shanghai")); }
5.2 性能问题快速定位
当系统响应变慢时，我们的排查流程：
- 检查Spring Boot Actuator的/metrics端点
- 分析HikariCP连接等待时间
- 使用Arthas监控方法执行耗时
- 特别关注@Async批改任务的线程池状态
6. 部署与运维实践
6.1 信创环境适配要点
在国产化服务器部署时，我们遇到的三个典型问题及解决方案：
- 达梦数据库兼容问题：
- 重写部分NativeQuery为JPQL
- 调整方言配置
properties复制spring.jpa.database-platform=org.hibernate.dialect.DmDialect - 东方通中间件适配：
- 禁用HTTP/2支持
- 调整线程池配置
- 麒麟OS文件权限问题：
- 设置专门的应用程序用户
- 调整Tomcat umask值
6.2 监控体系搭建
采用Prometheus + Grafana的方案，关键监控指标包括：
- 作业提交成功率
- 批改平均耗时
- 并发用户数阈值预警
- 存储空间使用趋势
我们在Grafana中配置了智能预警规则，当批改耗时超过历史平均值的2倍标准差时，自动触发扩容检查。
7. 扩展功能开发建议
对于二期工程，我们规划了三个增值方向：
- 智能批改辅助：集成NLP技术自动检查常见错误
- 学习分析看板：基于作业数据生成个人知识图谱
- 移动端优化：开发PWA应用支持离线批注
特别在移动端适配方面，我们发现老师经常需要在通勤路上批改作业。通过实现Service Worker缓存关键资源，即使在地铁等弱网环境下，批改界面也能保持流畅操作，待网络恢复后自动同步数据。