Spring Boot教师工作量管理系统：从业务建模到编码实现

Spring Boot教师工作量管理系统这个题目，光看名字可能觉得就是个普通的CRUD项目。但我把整个业务逻辑捋了一遍之后发现，这里面的工作量核算规则、权限分级、数据统计这几个模块，恰恰是绝大多数毕设和实习项目里最容易被忽略、但最能体现项目深度的部分。这篇文章就把我的完整设计思路和编码过程分享出来，包括数据库表怎么设计、课时折算规则怎么写、遇到过的几个让人头大的坑，希望能给正在做类似管理系统的同学一些参考。

1. 先想清楚做什么：教师工作量管理的核心业务拆解

1.1 需求层面：这个系统到底要解决什么问题

先别急着写代码，咱们先站在使用者的角度想想。教师工作量管理，本质上要回答三个问题：某个老师这学期上了多少课？折合成标准课时是多少？全院的课时总量和超课时情况怎么样？

在很多高校里，教师工作量直接跟绩效奖金挂钩，所以核算必须精确、透明、可追溯。传统做法是用Excel表格，教务处收上来几十个老师的填报数据，再人工核对课程表、调课记录、职称系数，工作量非常大还容易出错。这个系统的核心价值，就是把“教师填报 -> 教研室初审 -> 教务终审 -> 工作量汇总统计”这条链路搬到线上，每一步都有记录，每一笔数据都可追溯。

1.2 角色权限：三类用户，三种视角

我做过好几个管理类项目，权限设计这块几乎是必考项。这个系统我用的是三种角色的权限模型：

• 教师（普通用户）：可以查看自己的工作量明细、在线填报课时、查看审核状态。注意，教师只能看自己的数据，不能看到全院的数据。
• 教研室主任（审核角色）：可以查看所辖教研室所有教师的工作量数据，进行初审。一个主任可以管多个教研室吗？可以，所以我用中间表维护用户和教研室的关系，而不是在用户表里简单存一个department_id。
• 系统管理员（教务处）：拥有全部权限，包括教师信息维护、课程信息维护、折算系数配置、最终审核、统计报表导出。

这个权限模型在实现上用Spring Security + JWT就搞定了。核心是自定义一个@RequireRole注解加拦截器，比在Controller每个方法里手写if判断要优雅得多，后期加新接口也不会漏权限控制。

2. 技术选型与项目骨架搭建：为什么是Spring Boot + MyBatis Plus

2.1 技术栈的合理性分析

这个项目我选型的核心逻辑只有一条——毕业设计/课程设计场景下，稳定压倒一切，熟悉度优先。Spring Boot 2.7 + MyBatis Plus 3.5 + MySQL 8.0 + Redis，这套组合在管理类项目中几乎是无脑最优解：

• Spring Boot：自动装配极大减少配置工作量。你不需要像SSH（Spring + Struts + Hibernate）时代那样写一堆XML配置文件，一个@SpringBootApplication注解就搞定启动。
• MyBatis Plus：单表CRUD不用写SQL，BaseMapper提供现成的selectById、insert、updateById方法，分页插件一加，连Page对象都是现成的。对于工作量明细查询这种高频、条件组合多的场景，用LambdaQueryWrapper可以非常优雅地拼条件，不用手动写<if>标签。
• Redis：不是必需的，但我加了。用途有两个：一是存储JWT的token黑名单（用户退出登录后强制token失效），二是缓存登录用户的菜单权限和折算系数配置。

2.2 核心依赖的版本选择

<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.18</version> </parent> <dependencies> <!-- Web --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- MyBatis Plus（注意是3.5.3.1，兼容Spring Boot 2.x） --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.3.1</version> </dependency> <!-- MySQL --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.33</version> </dependency> <!-- Redis --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-redis</artifactId> </dependency> <!-- JWT --> <dependency> <groupId>io.jsonwebtoken</groupId> <artifactId>jjwt-api</artifactId> <version>0.11.5</version> </dependency> <!-- 参数校验 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-validation</artifactId> </dependency> <!-- Lombok，减少getter/setter --> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency> </dependencies>

版本这块我要特别提醒一句：不要盲目追求最新版。比如Spring Boot 3.x，虽然是趋势，但它的javax.*包迁移到了jakarta.*，很多老教程的写法直接不能用。MyBatis Plus也有对应适配问题。我做毕设的核心目标是“顺利跑通+论文写得出来”，选2.7系列是最稳妥的，网上资料最多，踩坑成本最低。

2.3 配置文件的写法与注意事项

application.yml这个文件看起来简单，但里面藏了不少细节：

server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/teacher_workload?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true username: root password: 123456 redis: host: localhost port: 6379 database: 0 jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: Asia/Shanghai mybatis-plus: configuration: map-underscore-to-camel-case: true # 下划线自动转驼峰 log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 开发阶段打印SQL global-config: db-config: logic-delete-field: deleted # 全局逻辑删除（很重要，防止误删数据） logic-delete-value: 1 logic-not-delete-value: 0

这里有个非常隐蔽的坑：MySQL 8.0的驱动URL必须加serverTimezone参数，否则会报时间时区错误。另外allowPublicKeyRetrieval=true是为了解决MySQL 8.0使用caching_sha2_password认证时的Public Key Retrieval异常，不加的话在第一次连接时会报错。

再强调一下逻辑删除。工作量数据是跟绩效挂钩的，物理删除一条记录意味着这条记录彻底消失，审计时说不清楚。用逻辑删除字段，数据还在数据库里，只是查询时被自动过滤了，后期查历史记录也有据可循。

3. 数据库设计：工作量管理系统的地基

3.1 核心表结构设计

数据库设计是判断一个管理类项目水平的分水岭。我见过太多项目把所有业务逻辑都塞进一张大表里，最后查询统计的时候SQL写得像天书。这个项目我拆了六张核心表：

1. sys_user—— 用户表，字段包括id、username、password（BCrypt加密）、name、role（1教师/2主任/3管理员）、department_id、title（职称，影响折算系数）
2. sys_department—— 教研室表
3. course_info—— 课程表，重点字段是course_type（理论课/实验课/体育课），因为不同类型的课程折算系数不同
4. workload_record—— 工作量记录表，核心业务表，重点说明见下
5. workload_coefficient—— 折算系数配置表
6. workload_statistics—— 月度/学期汇总表，冗余存储统计结果，避免每次打开报表都实时算一遍

工作量记录表的结构是这样的：

CREATE TABLE `workload_record` ( `id` BIGINT PRIMARY KEY AUTO_INCREMENT, `user_id` BIGINT NOT NULL COMMENT '教师ID', `course_id` BIGINT NOT NULL COMMENT '课程ID', `semester` VARCHAR(20) NOT NULL COMMENT '学期，如2024-2025-1', `class_hours` DECIMAL(5,2) NOT NULL COMMENT '实际上课课时', `coefficient` DECIMAL(4,2) NOT NULL DEFAULT 1.00 COMMENT '折算系数', `workload_hours` DECIMAL(6,2) NOT NULL COMMENT '折算后工作量', `status` TINYINT NOT NULL DEFAULT 0 COMMENT '0草稿 1待审核 2通过 3驳回', `audit_user_id` BIGINT COMMENT '审核人ID', `audit_time` DATETIME COMMENT '审核时间', `audit_comment` VARCHAR(255) COMMENT '审核意见', `create_time` DATETIME NOT NULL, `update_time` DATETIME NOT NULL, `deleted` TINYINT DEFAULT 0, INDEX idx_user_semester (`user_id`, `semester`), INDEX idx_status (`status`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

3.2 工作量折算规则的数据化存储

教师工作量不是简单的上课节数，不同课程类型、不同职称的老师折算方式不同，这是这个项目最核心的业务规则。常见的折算方式：

这些系数不能写死在代码里，因为不同学院的规则可能有差异。我单设计了一张workload_coefficient表，用key-value的形式存这些配置，管理员可以在前端页面修改。代码如下：

@Service public class CoefficientService { @Autowired private CoefficientMapper coefficientMapper; @Autowired private RedisTemplate<String, Object> redisTemplate; private static final String COEFF_KEY = "workload:coefficient"; /** * 获取工作量折算系数 * 规则：workload = classHours * courseTypeCoefficient * titleCoefficient */ public BigDecimal getCoefficient(String courseType, String title) { if (courseType == null || title == null) { return BigDecimal.ONE; } // 先查缓存，没有则查DB String key = COEFF_KEY + ":" + courseType + ":" + title; Object cached = redisTemplate.opsForValue().get(key); if (cached != null) { return (BigDecimal) cached; } Coefficient coeff = coefficientMapper.selectOne( new LambdaQueryWrapper<Coefficient>() .eq(Coefficient::getCourseType, courseType) .eq(Coefficient::getTitle, title) ); BigDecimal result = coeff != null ? coeff.getCoefficient() : BigDecimal.ONE; redisTemplate.opsForValue().set(key, result, 24, TimeUnit.HOURS); return result; } }

这里用Redis缓存的原因很朴素：系数表数据量小、变化频率极低，但被调用的次数极高（每一笔工作量记录都要查）。每次都打MySQL浪费资源，缓存到Redis里减轻数据库压力。不过要注意，管理员改了系数配置后，必须同步删除缓存，否则教师看到的数据还是旧系数。这是我的一个教训，后文会细说。

4. 实操过程与核心环节实现

4.1 登录认证与JWT Token的实现

管理类系统的登录认证，我推荐Spring Security + JWT的组合。核心逻辑很简单：用户登录成功后，服务端生成一个token返回给前端，前端每次请求都带着这个token在Header里，后端拦截器校验token合法性和有效期。

JWT工具类的关键代码：

@Component public class JwtUtils { @Value("${jwt.secret}") private String secret; @Value("${jwt.expiration}") private Long expiration; public String generateToken(Long userId, String username, Integer role) { return Jwts.builder() .setSubject(username) .claim("userId", userId) .claim("role", role) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() + expiration)) .signWith(SignatureAlgorithm.HS256, secret) .compact(); } public Claims parseToken(String token) { return Jwts.parser() .setSigningKey(secret) .parseClaimsJws(token) .getBody(); } }

这里有个细节：JWT的payload里不要放敏感信息，比如密码，因为JWT只是Base64编码，不是加密，任何人拿到token解码就能看到内容。放userId、username、role这些就足够了。

自定义token拦截器时，有两点容易踩坑：

第一，白名单配置。登录接口、swagger文档、静态资源不能拦截，否则还没登录就被拦截了，整个系统跑不通。我在WebMvcConfigurer里配置了excludePathPatterns。

第二，跨域问题。如果前端是Vue单独部署在8081端口，后端是8080，必然有跨域。我的做法是写一个CorsFilter，允许指定来源、指定Header。这个别偷懒，前后端联调时跨域报错能浪费你半天时间。

4.2 工作量录入与审核流程：状态机设计

工作量数据从教师填报到最终生效，中间有多个状态转换。状态机是这个模块最核心的设计，我把状态流转定义清楚：

草稿(0) -> 待审核(1) -> 通过(2) | 驳回(3)

教师可以新建记录，提交后变为“待审核”。主任看到待审核的记录，审核通过则变为“通过”，不通过则驳回并填写意见。被驳回的记录，教师修改后可以重新提交。

一个很关键的细节是：审核通过后教师不能再修改记录。要实现这个逻辑，在Controller的update方法里必须加上状态判断：

@PutMapping("/record/{id}") public Result updateRecord(@PathVariable Long id, @RequestBody WorkloadRecord record) { WorkloadRecord dbRecord = workloadRecordService.getById(id); if (dbRecord == null) { return Result.error("记录不存在"); } if (dbRecord.getStatus() == 2) { return Result.error("记录已审核通过，不能修改"); } // 注意：只允许修改自己的记录，防止越权操作 Long currentUserId = SecurityUtils.getCurrentUserId(); if (!dbRecord.getUserId().equals(currentUserId)) { return Result.error("无权修改他人记录"); } // 重新计算折算工作量 BigDecimal workloadHours = record.getClassHours() .multiply(coefficientService.getCoefficient(record.getCourseType(), record.getTitle())); record.setWorkloadHours(workloadHours); workloadRecordService.updateById(record); return Result.success(); }

这里有个容易被忽略的越权问题：教师修改记录时，必须先判断这条记录是不是自己的。如果不判断，任何一个登录用户传任意id就能改别人的工作量数据，这是严重的安全漏洞。我在实际测试自己项目时就发现过一次，教师A登录后，用接口工具直接传教师B的记录id，居然能改数据，这个bug必须在代码层面堵死。

4.3 报表统计：学期工作量总览的实现逻辑

统计报表是另一个看着简单、实际有坑的模块。需求很简单：以学期为单位，统计每个教师的总工作量、总课时、超课时量（超出额定工作量的部分）。

我的实现方案是：平时不统计，统计时不走单条数据实时求和，而是走SQL聚合查询。写成XML映射文件：

<select id="selectSemesterSummary" resultType="map"> SELECT u.id AS userId, u.name AS teacherName, d.name AS departmentName, SUM(CASE WHEN r.status = 2 THEN r.workload_hours ELSE 0 END) AS totalWorkload, SUM(CASE WHEN r.status = 2 THEN r.class_hours ELSE 0 END) AS totalClassHours, COUNT(CASE WHEN r.status = 2 THEN 1 ELSE NULL END) AS courseCount FROM workload_record r INNER JOIN sys_user u ON r.user_id = u.id LEFT JOIN sys_department d ON u.department_id = d.id WHERE r.semester = #{semester} GROUP BY u.id, u.name, d.name ORDER BY totalWorkload DESC </select>

这里的关键点有两个：

一是只统计status=2（审核通过）的记录。如果老师填了记录但还在审核中，或者被驳回了，这些数据不能进入报表。我最初做的时候没加这个条件，导致报表里出现了还没审核的数据，给教务那边的数据造成了混乱。

二是数组越界和空指针问题。如果某个老师一个学期没有任何工作量记录，LEFT JOIN还能查到，但SUM结果是NULL，不是0。在Java里做数值运算时一定要做null判断，否则BigDecimal.add(null)会直接抛空指针。我的工具方法是：

private BigDecimal safeAdd(BigDecimal source, BigDecimal target) { if (source == null) { return target == null ? BigDecimal.ZERO : target; } return target == null ? source : source.add(target); }

4.4 数据导出：EasyExcel实现报表导出

前面提到教务需要报表，那最好直接在系统里提供导出Excel的功能。我用的阿里EasyExcel，比Apache POI好用太多，内存占用低，写起来代码量少。

关键代码：

public void exportSemesterReport(String semester, HttpServletResponse response) throws IOException { // 查询统计结果 List<Map<String, Object>> dataList = workloadRecordMapper.selectSemesterSummary(semester); // 转换为EasyExcel需要的模型列表 List<SemesterReportVO> reportList = dataList.stream().map(map -> { SemesterReportVO vo = new SemesterReportVO(); vo.setTeacherName(String.valueOf(map.get("teacherName"))); vo.setDepartmentName(String.valueOf(map.get("departmentName"))); vo.setTotalWorkload(map.get("totalWorkload") == null ? BigDecimal.ZERO : (BigDecimal) map.get("totalWorkload")); vo.setTotalClassHours(map.get("totalClassHours") == null ? BigDecimal.ZERO : (BigDecimal) map.get("totalClassHours")); return vo; }).collect(Collectors.toList()); // 写入响应 response.setContentType("application/vnd.ms-excel"); response.setCharacterEncoding("utf-8"); String fileName = URLEncoder.encode(semester + "工作量统计", "UTF-8").replaceAll("\\+", "%20"); response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx"); EasyExcel.write(response.getOutputStream(), SemesterReportVO.class) .sheet("工作量统计") .doWrite(reportList); }

4.5 前端页面的功能对照

如果前端你打算自己写，那按照Vue + Element UI的成熟方案来做基本不会出大问题。核心页面无非就这几个：

前端这边我要强调一个体验细节：工作量填报页面的课时数，最好做成带校验的el-input-number，因为教师可能会填“2.5课时”这种带小数的数据，而且课时必须大于0。后端校验和前端校验都要做，不能只依赖前端，因为接口可以被绕过。后端我用@Validated注解加@DecimalMin(value = "0.5", message = "课时必须大于0.5")来约束参数。

5. 常见问题与排查技巧实录

5.1 MyBatis Plus 分页插件不生效

这是我开发中踩过最大的坑之一，现象是查询接口返回的数据不带分页信息，永远是全量数据。

原因排查： MyBatis Plus的分页需要单独配置一个PaginationInterceptor（3.5.x版本叫MybatisPlusInterceptor），很多人以为引入starter就默认有分页功能，其实没有。

解决办法是在配置类里加一个Bean：

@Configuration public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }

加了之后分页立即生效。这个问题的典型场景是：代码里明明写的page(current, size)，但返回的total是0，或者根本没走SQL的LIMIT子句。

5.2 Redis缓存和数据库数据不一致

前文提到系数配置改动了，但缓存没有同步失效，导致教师端显示的折算系数还是旧的。这个问题的本质是缓存一致性处理不到位。

我的解决方案是双管齐下：

第一，修改操作时主动删缓存。管理员更新系数的接口里，把该系数相关的所有缓存key批量删除：

@PutMapping("/coefficient") public Result updateCoefficient(@RequestBody Coefficient coefficient) { coefficientMapper.updateById(coefficient); // 清除相关缓存 Set<String> keys = redisTemplate.keys(COEFF_KEY + ":" + coefficient.getCourseType() + ":*"); if (keys != null && !keys.isEmpty()) { redisTemplate.delete(keys); } return Result.success(); }

第二，缓存设置过期时间兜底。即使主动删缓存失败，24小时后缓存也会自动过期，重新从数据库加载最新数据。这两个机制叠加，数据不一致的概率就极低了。

5.3 金额和课时用double会出问题

如果你在WorkloadRecord类里用了Double类型存课时数，那么在计算工作量或者做汇总统计时，精度问题会要了你的命。典型的例子：0.1 + 0.2 = 0.30000000000000004。

这个领域数值精度很重要，因为工作量直接跟绩效挂钩，差一分钱都可能被老师投诉。我的原则是：

凡是涉及数值、金额、课时的字段，一律用BigDecimal，数据库用DECIMAL，前端传参用string接收后转换为BigDecimal。

在Java代码中写计算逻辑时，也尽量用multiply、add的方法，而不是*和+。

5.4 登录接口被狂刷：准备加一个简单防刷机制

这是我自己测试时发现的隐患。系统上线后，登录接口如果没有任何防护，可以被脚本暴力尝试密码。我的做法比较简单：

用Redis记录IP维度的登录失败次数，5分钟内失败超过5次就锁定该IP一段时间。核心代码：

String key = "login:fail:" + ipAddr; Integer failCount = (Integer) redisTemplate.opsForValue().get(key); if (failCount != null && failCount >= 5) { return Result.error("登录失败次数过多，请15分钟后再试"); } // 登录失败时 redisTemplate.opsForValue().increment(key); redisTemplate.expire(key, 15, TimeUnit.MINUTES); // 登录成功时删除该key redisTemplate.delete(key);

这里注意：登录成功时一定要把失败计数清掉，否则用户成功登录后，计数还留着，下次再登录可能被误锁。

5.5 Excel导出中文文件名乱码

导出功能做完了，但这个乱码问题折磨了我一个下午。导出文件名带中文，通过Content-Disposition设置时，浏览器解析乱码。

解决办法是用RFC 5987标准格式编码：

String fileName = URLEncoder.encode("教师工作量统计表", "UTF-8") .replaceAll("\\+", "%20"); response.setHeader("Content-disposition", "attachment; filename*=utf-8''" + fileName + ".xlsx");

这个写法注意两个细节：一是URLEncoder.encode产生的+号要手动替换成%20，否则文件名里的空格会变成加号；二是filename*=是RFC 5987新增的写法，必须带utf-8''前缀。老写法只写filename=，对中文支持很差。

6. 项目扩展与后续优化的几个思路

如果做完这个项目你还想继续深入，或者要在答辩时展示更多亮点，有几个扩展方向值得考虑：

第一，对接消息通知。审核操作发生时，通过WebSocket或者短信/邮件模板给教师发送站内通知，让教师第一时间知道工作量被通过或驳回了。这个功能加进来，系统就不是单纯的CRUD了，有了实时交互的感觉。

第二，增加数据导入功能。课程信息和教师信息如果都要手工一条条录，管理员会崩溃。可以做一个Excel批量导入的功能，用EasyExcel解析上传的文件，自动批量插入数据库。但在导入时一定要做重复数据校验和格式校验，否则脏数据容易把系统搞崩。

第三，多学期数据对比分析。报表页面可以做折线图和柱状图，展示教师各学期工作量变化趋势，这个用ECharts就能搞定，视觉效果不错，答辩时能加不少印象分。

关于表单校验、接口幂等性、统一异常处理这些细节，我觉得在管理类项目中虽然看起来不起眼，但实际上都是拉开差距的点。一个健壮的系统不是看功能多豪华，而是看边界情况处理得有多严谨。

我从这个项目中比较深的一个体会是：工作量管理系统的核心并不在于代码本身的复杂度，而在于对业务规则的清晰建模。折算系数、审核状态、统计口径，每一个业务点都会直接决定系统的可用性。业务规则搞清楚了，写代码只是时间问题；业务规则模棱两可，写出来的代码大概率要反复返工。建议准备动手做同类系统的同学，先把业务逻辑画成流程图和状态表，确认无误后再开始写代码。这一步看起来费时间，但能帮你省出后面数倍的时间。