1. 项目背景与核心价值
作为一名经历过无数次深夜收作业的助教，我深知传统作业管理方式的痛点：邮箱被PDF塞爆、微信群文件过期、Excel表格版本混乱。这套基于SpringBoot的在线作业系统，正是为了解决这些真实场景中的问题而生。
它的核心价值在于将"布置-提交-批改-反馈"全流程数字化。教师端采用富文本编辑器布置作业，支持附件上传和截止日期设置；学生通过浏览器一键提交，系统自动归档并触发批阅流程；批改结果实时反馈，所有历史记录永久可追溯。我在某高校计算机系实际部署后，单学期减少纸质作业打印量超过12000页，助教批改效率提升40%。
2. 技术架构设计解析
2.1 为什么选择SpringBoot全栈方案
SpringBoot的自动配置特性让我们能快速搭建起包含Web层、业务层和数据访问层的完整应用。实测从零开始到基础功能上线仅需3人日，这得益于：
- 内嵌Tomcat省去服务器配置
- Starter依赖自动管理JAR包版本
- Actuator提供实时健康监测
特别提醒：在pom.xml中务必锁定spring-boot-starter-parent版本（推荐2.7.18），避免后续依赖冲突。我们曾因未指定版本导致Redis连接池异常。
2.2 数据库选型与优化
MySQL 8.0作为主数据库，其JSON类型字段完美适配作业批注存储需求。关键表结构设计：
sql复制CREATE TABLE `assignment` (
`id` BIGINT PRIMARY KEY AUTO_INCREMENT,
`title` VARCHAR(255) NOT NULL,
`content` LONGTEXT,
`attachments` JSON COMMENT 'OSS存储路径',
`deadline` DATETIME,
`course_id` BIGINT
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
踩坑记录：早期使用VARCHAR存储附件列表，在批量查询时出现JSON解析错误。改用原生JSON类型后，配合MyBatis-Plus的@TableField(typeHandler = FastjsonTypeHandler.class)完美解决。
3. 核心功能实现细节
3.1 作业提交的防重复设计
采用"用户ID+作业ID"复合唯一索引：
java复制@TableField(unique = true)
private String submissionKey; // 格式：userId_assignmentId
配合Redis分布式锁防止网络延迟导致的重复提交：
java复制public boolean submitAssignment(AssignmentDTO dto) {
String lockKey = "submit:" + dto.getUserId();
try {
if (redisTemplate.opsForValue().setIfAbsent(lockKey, "1", 30, TimeUnit.SECONDS)) {
return assignmentService.save(dto);
}
throw new BusinessException("操作过于频繁");
} finally {
redisTemplate.delete(lockKey);
}
}
3.2 智能批阅的实现路径
基于NLP的简单批阅流程：
- 使用HanLP进行关键词提取
- 与教师提供的参考答案进行相似度计算
- 生成初步评分建议（需教师确认）
java复制public class SmartGrader {
public static double scoreAnswer(String stdAnswer, String studentAnswer) {
List<String> stdWords = HanLP.extractKeyword(stdAnswer, 10);
List<String> stuWords = HanLP.extractKeyword(studentAnswer, 10);
return CosineSimilarity.compute(stdWords, stuWords);
}
}
实测准确率约65%，适合作为初筛工具。我们后来增加了代码作业的AST比对功能，对编程题目的匹配度提升到82%。
4. 生产环境部署要点
4.1 文件存储方案对比
| 方案 | 成本 | 性能 | 适用场景 |
|---|---|---|---|
| 本地存储 | 低 | 中等 | 小型内部系统 |
| MinIO集群 | 中 | 高 | 需要S3兼容接口 |
| 阿里云OSS | 按量计费 | 极高 | 公有云部署 |
我们最终选择MinIO自建存储，关键配置：
yaml复制minio:
endpoint: http://minio-cluster
accessKey: ${MINIO_ACCESS_KEY}
secretKey: ${MINIO_SECRET_KEY}
bucket: assignments
4.2 高并发场景优化
当300+学生同时提交时，原始方案出现数据库连接池耗尽。通过以下措施解决：
- 引入HikariCP替换默认连接池
- 文件上传改为异步处理
- 添加消息队列削峰
java复制@Async
public void asyncUpload(File file) {
// OSS上传逻辑
}
@RabbitListener(queues = "assignment.submit")
public void processSubmission(SubmissionMessage message) {
// 数据库写入逻辑
}
5. 扩展功能开发建议
5.1 查重系统集成
通过SimHash算法实现文本相似度检测：
java复制public class PlagiarismChecker {
public static boolean checkSimilarity(String text1, String text2, int threshold) {
return SimHash.hammingDistance(
SimHash.compute(text1),
SimHash.compute(text2)
) < threshold;
}
}
5.2 移动端适配方案
采用响应式布局+微信小程序双路线：
- 前端使用Element Plus的Layout组件
- 小程序通过uni-app编译多端代码
实测表明：移动端提交占比从20%提升至58%后，我们增加了拍照上传答案的功能，这对数学公式等特殊内容特别友好。
6. 安全防护实践
6.1 防XSS攻击方案
作业内容展示层采用双重过滤：
- 后端使用Jsoup清理HTML标签
- 前端用vue-dompurify-html渲染
java复制public String sanitizeContent(String raw) {
return Jsoup.clean(raw,
Safelist.basicWithImages()
.addTags("code", "pre")
);
}
6.2 权限控制设计
基于RBAC模型扩展教学场景特有角色：
java复制@PreAuthorize("hasRole('TEACHER') or
(hasRole('TA') and @permService.checkCourseAccess(#courseId))")
public void gradeAssignment(Long assignmentId) {
// 批改逻辑
}
遇到的实际问题：助教（TA）权限需要细化到具体课程，我们通过自定义权限注解实现。
7. 监控与运维
7.1 健康检查配置
SpringBoot Actuator增强配置：
yaml复制management:
endpoints:
web:
exposure:
include: health,info,metrics
endpoint:
health:
show-details: always
group:
db:
include: db,redis
配合Prometheus+Grafana实现可视化监控，特别关注：
- 作业提交峰值时段（通常21:00-23:00）
- 批改操作响应时间（预警阈值500ms）
7.2 日志收集方案
采用ELK栈处理业务日志，关键日志标记：
java复制@Slf4j
public class AssignmentService {
public void downloadAssignment(Long id) {
log.info("[DOWNLOAD] assignmentId={}, ip={}",
id, RequestContext.getIp());
}
}
日志查询技巧：通过Kibana的"assignmentId:123 AND [DOWNLOAD]"语法快速定位特定作业的下载记录。
8. 项目演进方向
当前系统在以下方面还有提升空间：
- 使用Apache POI实现Excel作业的自动解析
- 集成Jupyter Notebook支持编程作业实时运行
- 基于Spring Cloud构建微服务版本
我在二次开发时发现，添加作业模板功能后教师满意度提升明显。通过Thymeleaf动态生成Word模板，教师可以快速创建标准格式的作业要求。