简介这份教务管理系统源码面向教育机构教务管理员、计算机专业学生及需要课程设计参考的开发者围绕学生信息、课程安排、教师管理、课表编排、考勤统计与报表输出等日常教务任务提供一套结构较完整的简化实现。压缩包共171个文件约4.18MB以41个C#源码文件和5个csproj工程文件为核心配合sln解决方案、resx/resources界面资源、config配置、dll与exe编译产物以及bmp界面截图等便于快速还原项目并理解WinForms桌面端的组织方式。已有1995人学习说明其在课程设计和源码研读场景中具有一定参考价值。读者可据此梳理模块划分、界面与业务逻辑的对应关系分析学生、教师、课程等实体的管理流程并在此基础上进行功能调整或二次开发积累教育信息化项目的实践经验。1. 教务管理系统源码选课高峰期最能暴露问题的那部分它已经写好了教务处每学期开放选课的那两个小时最能看出一个系统写得扎不扎实。后台日志里有人连点二十次提交有余量的课程被刷成负数课表上同一段时间叠着两门课老师那边还收到两条同一时间的排课通知。要自己从零搭一套教务管理系统这些坑一个都躲不掉。这套教务管理系统源码省掉的正是这一步学院、专业、班级的层级数据课程库与开课计划排课时间冲突检测选课并发扣减成绩录入与绩点统计都是能直接跑起来、也能接着往下改的完整链路。它适合两类人一是课程设计或毕设要交一个像样的教务系统二是手里有真实业务要一个能落地的骨架。下面按技术栈、目录、数据库、核心业务、踩坑、二次改造的顺序拆开讲。2. 技术选型与工程结构Spring Boot Vue 是怎么把教务业务拆开的2.1 技术栈取舍为什么教务系统绕不开这几样教务系统的业务特点很明确读多写少但写的时候必须严格选课、成绩录入权限层级复杂学生、教师、院系管理员、教务管理员四类角色各自能看的表都不一样报表类查询多课表、成绩单、班级排名。这三点决定了技术选型的方向。后端用的是 Spring Boot 2.7 MyBatis-Plus MySQL 8 Redis Spring Security JWT。Spring Boot 负责工程骨架和自动配置MyBatis-Plus 处理单表 CRUD 和分页省掉大量模板代码MySQL 8 是教务场景里最稳妥的选择窗口函数和 CTE 在统计排名时比手写子查询好写太多Redis 主要做两件事登录态 token 缓存和选课高峰期的余量预扣Spring Security 配 JWT 做无状态鉴权避免教务处多台机器部署时的 session 同步麻烦。前端是 Vue 3 Vite Element Plus Pinia Axios。Element Plus 的表格、表单、树形选择器几乎覆盖了教务系统 80% 的界面需求学院专业班级这种层级数据用 el-tree 和 el-cascader 直接能接上Pinia 存登录用户信息和权限码路由守卫里根据权限码决定能不能进某个页面。提示这套组合不是唯一的正确答案但对教务系统来说选它最大的价值是「二次开发时能搜到答案」。用冷门框架写出来的系统接手的人第一步就卡在环境上。版本上有一个血泪经验MySQL 驱动务必用 com.mysql.cj.jdbc.Driver并且连接串带上 serverTimezoneAsia/Shanghai否则成绩录入的时间字段会整体偏 8 小时这类问题排查起来相当玄学。2.2 目录结构后端分层与前端页面怎么对应后端是标准的 controller / service / mapper / entity 四层外加 config、common、security 三个横向包。真正值得看的是它把「业务模块」和「技术模块」分开了业务按教务领域切技术按职责切接手的人找代码时路径是可预期的。edu-admin/ ├── edu-common/ # 公共模块统一响应、异常、工具类 │ └── src/main/java/com/edu/common/ │ ├── result/R.java # 统一返回体 {code, msg, data} │ └── exception/GlobalExceptionHandler.java ├── edu-system/ # 基础数据学院、专业、班级、学期、用户 │ ├── controller/CollegeController.java │ ├── service/CollegeService.java │ └── mapper/CollegeMapper.java ├── edu-course/ # 课程库、开课计划、排课 │ ├── controller/ScheduleController.java │ └── service/impl/ScheduleServiceImpl.java ├── edu-score/ # 选课、成绩、绩点、统计 │ ├── controller/SelectionController.java │ └── controller/ScoreController.java ├── edu-security/ # JWT 过滤器、权限注解、登录 └── edu-admin-web/ # 前端 └── src/ ├── api/ # 按模块拆的 axios 封装 ├── views/course/ # 课程库、开课计划、排课页 ├── views/score/ # 选课、成绩录入、成绩单 ├── store/user.js # 用户信息与权限码 └── router/index.js # 路由 权限守卫这套结构里有个细节值得学edu-common 不依赖任何业务模块业务模块之间也不互相依赖需要跨模块拿数据时通过 mapper 层的只读查询或者事件解耦。比如排课模块要校验教师是否存在它不 import edu-system 的 Service而是自己写一个只读的 TeacherMapper 查一下。这样拆的好处是模块可以单独打 jar、单独启动做接口调试坏处是会有少量重复代码但对教务这种模块边界清晰的业务来说这点重复换来的是编译期的解耦。前端的目录和后端模块一一对应api/course.js 里的每个函数对应一个后端 Controller 的接口命名保持一致改接口时两边一起改不容易漏。2.3 本地启动从建库到前后端联调的完整命令跑通这套东西的门槛不高但顺序不能乱先建库导数据再起 Redis然后起后端最后起前端前端代理指向后端端口。第一步建库并导入初始化脚本。源码包的 sql 目录下一般有两个文件schema.sql 建表data.sql 灌基础数据学院、专业、管理员账号、几门示例课程。# 建库并导入注意字符集用 utf8mb4否则学生姓名里的生僻字会变成问号 mysql -uroot -p -e CREATE DATABASE edu_admin DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci; mysql -uroot -p edu_admin sql/schema.sql mysql -uroot -p edu_admin sql/data.sql # Redis 用于登录态和选课余量本地起一个就行 redis-server --port 6379 --daemonize yes第二步改后端配置。核心就是数据源、Redis、JWT 密钥三段其余保持默认。# edu-admin/src/main/resources/application-dev.yml server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/edu_admin?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: 你的密码 redis: host: 127.0.0.1 port: 6379 database: 0 mybatis-plus: configuration: map-underscore-to-camel-case: true # 数据库 snake_case 自动映射实体 camelCase global-config: db-config: logic-delete-field: deleted # 全局逻辑删除字段 logic-delete-value: 1 logic-not-delete-value: 0 edu: jwt: secret: 换成你自己的32位以上随机串 expire: 7200 # token 有效期单位秒几个参数值得单独说map-underscore-to-camel-case 打开后create_time 会自动映射到实体里的 createTime不然每个字段都要手写 TableFieldlogic-delete-field 配上 deleted 字段后MyBatis-Plus 的删除会自动变成 UPDATE deleted 1查询自动带 where deleted 0学生退课这种「要留痕」的操作正好用得上jwt.expire 给 7200 秒对教务系统偏短实际部署一般给 8 小时加一个 refresh token 续期。第三步启动后端和前端。# 后端在项目根目录执行-Dspring.profiles.active 指定 dev 配置 mvn clean package -DskipTests java -jar edu-admin/target/edu-admin.jar --spring.profiles.activedev # 或者开发阶段直接 mvn spring-boot:run -pl edu-admin # 前端进入 edu-admin-web安装依赖后起 dev server cd edu-admin-web npm install --registryhttps://registry.npmmirror.com npm run dev # 默认 http://localhost:5173vite.config.js 里把 /api 代理到 8080前端 vite.config.js 里的代理配置是关键一环不配的话所有接口都会 404// edu-admin-web/vite.config.js export default defineConfig({ server: { port: 5173, proxy: { /api: { target: http://127.0.0.1:8080, // 后端地址 changeOrigin: true, // 改请求头 host避免后端校验 origin 失败 rewrite: (path) path.replace(/^\/api/, ) // 后端接口没挂 /api 前缀时去掉 } } } })启动完成后用 data.sql 里预置的教务管理员账号登录能看到菜单说明权限链路是通的如果登录后左侧菜单是空的八成是角色权限码和路由里的 meta.permission 对不上这个问题放到后面的排查章细讲。3. 数据库与实体设计六张表撑起排课、选课和成绩3.1 核心表设计为什么这么切教务系统的表看着多真正承载业务逻辑的核心就六张course课程库、teaching_plan开课计划、schedule排课记录、course_selection选课记录、score成绩、semester学期。其余学院、专业、班级、教室、教师都是基础数据结构简单。切分逻辑是课程库定义「这门课是什么」开课计划定义「这学期谁开这门课、开给哪个班」排课记录定义「这门课在什么时间什么地点上」选课记录定义「哪个学生选了哪条排课」成绩挂在选课记录上。这条链子从抽象到具体一层比一层细是教务业务最自然的落法。关键设计点在 schedule 表。它同时存了教师、教室、班级、周次、星期、节次六个维度冲突检测就是在这六个维度上做区间重叠判断。很多新手会把班级塞进 teaching_plan 里认为一个开课计划对应一个班结果一门课要开给三个班时就只能建三条开课计划数据冗余还容易漏。正确的做法是 teaching_plan 和 class 之间加一张关联表或者用逗号分隔的 class_ids 字段加应用层解析——源码里用的是关联表规范但多一次 join。3.2 建表 SQL约束、索引与外键的取舍教务系统的表之间关系多但源码里基本没建外键。原因很实际选课高峰期每秒几百条 insert外键检查会拖慢写入而且教务数据经常要批量导入导出外键会让清表重灌变成噩梦。取而代之的是应用层校验加索引兜底。-- 课程库全校长效数据一个课程编码唯一 CREATE TABLE course ( id BIGINT PRIMARY KEY AUTO_INCREMENT, course_code VARCHAR(32) NOT NULL COMMENT 课程编码, course_name VARCHAR(128) NOT NULL COMMENT 课程名称, credit DECIMAL(3,1) NOT NULL DEFAULT 0 COMMENT 学分如 3.5, hours INT NOT NULL DEFAULT 0 COMMENT 总学时, course_type TINYINT NOT NULL DEFAULT 1 COMMENT 1必修 2选修 3实践, college_id BIGINT NOT NULL COMMENT 开课学院, deleted TINYINT NOT NULL DEFAULT 0, UNIQUE KEY uk_course_code (course_code, deleted) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT课程库; -- 排课记录冲突检测的主战场 CREATE TABLE schedule ( id BIGINT PRIMARY KEY AUTO_INCREMENT, plan_id BIGINT NOT NULL COMMENT 开课计划ID, teacher_id BIGINT NOT NULL COMMENT 授课教师, classroom_id BIGINT NOT NULL COMMENT 教室, class_id BIGINT NOT NULL COMMENT 上课班级, semester_id BIGINT NOT NULL COMMENT 学期, week_day TINYINT NOT NULL COMMENT 1-7 对应周一到周日, start_section TINYINT NOT NULL COMMENT 起始节次1-12, end_section TINYINT NOT NULL COMMENT 结束节次, start_week TINYINT NOT NULL COMMENT 起始周, end_week TINYINT NOT NULL COMMENT 结束周, capacity INT NOT NULL DEFAULT 0 COMMENT 容量, selected_count INT NOT NULL DEFAULT 0 COMMENT 已选人数, version INT NOT NULL DEFAULT 0 COMMENT 乐观锁版本号, KEY idx_teacher_time (teacher_id, semester_id, week_day, start_section, end_section), KEY idx_classroom_time (classroom_id, semester_id, week_day, start_section, end_section), KEY idx_class_time (class_id, semester_id, week_day, start_section, end_section) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT排课记录; -- 选课记录唯一索引是防重复选的最后一道闸 CREATE TABLE course_selection ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id BIGINT NOT NULL, schedule_id BIGINT NOT NULL, status TINYINT NOT NULL DEFAULT 1 COMMENT 1已选 2已退, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_student_schedule (student_id, schedule_id), KEY idx_schedule (schedule_id, status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT选课记录;三个索引是整个系统的性能命门。idx_teacher_time、idx_classroom_time、idx_class_time 覆盖了排课的三种冲突教师同一时间只能上一门课教室同一时间只能排一门课班级同一时间只能上一门课。冲突检测的 SQL 会按这三个维度分别查一次没有索引的话一次保存要扫全表。uk_student_schedule 这个唯一索引更关键。它保证同一个学生对同一条排课只能有一条记录重复提交会被数据库直接挡回来配合应用层捕获 DuplicateKeyException 就变成了「重复选课」的友好提示。这是并发场景下最便宜也最可靠的方案比先 select 再 insert 的双查逻辑稳得多。course_code 的唯一索引带上了 deleted 字段是逻辑删除的常见处理课程「删除」后 deleted 变 1同编码可以重新建但已删除记录不影响新建。3.3 实体映射与公共字段实体层用的是 MyBatis-Plus 的注解方式没有写 XML。三个公共字段值得单独拎出来说createTime、updateTime、deleted。它们被抽到一个 BaseEntity 里所有实体继承它。// edu-common/src/main/java/com/edu/common/entity/BaseEntity.java Data public class BaseEntity implements Serializable { TableId(type IdType.AUTO) private Long id; TableField(fill FieldFill.INSERT) // 插入时自动填充 private LocalDateTime createTime; TableField(fill FieldFill.INSERT_UPDATE) // 插入和更新时都填充 private LocalDateTime updateTime; TableLogic // 标记逻辑删除字段 private Integer deleted; Version // 乐观锁版本号仅 schedule 等表有 private Integer version; }自动填充靠一个 MetaObjectHandler 实现注入到 MyBatis-Plus 的全局配置里从此所有 insert 和 update 都不用再手动 setCreateTime()。// edu-common/src/main/java/com/edu/common/config/MyMetaObjectHandler.java Component public class MyMetaObjectHandler implements MetaObjectHandler { Override public void insertFill(MetaObject metaObject) { // strictInsertFill 只在字段为空时填充不会覆盖业务手动设置的值 this.strictInsertFill(metaObject, createTime, LocalDateTime.class, LocalDateTime.now()); this.strictInsertFill(metaObject, updateTime, LocalDateTime.class, LocalDateTime.now()); this.strictInsertFill(metaObject, deleted, Integer.class, 0); } Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, updateTime, LocalDateTime.class, LocalDateTime.now()); } }这里有个容易翻车的点Version 加在 BaseEntity 上是全局生效的意味着所有继承它的表都必须有 version 字段没有就会报 Unknown column version。源码里的处理是只在 Schedule 和 Score 这类需要并发控制的实体上单独声明 versionBaseEntity 不放。这个取舍看项目规模表多的话宁可复制几行也不要全局塞。4. 核心业务拆解排课冲突、选课并发、成绩录入4.1 排课冲突检测时间片模型与一次 SQL 判定排课的本质是往一张二维表里放方块横轴是周次1-20 周纵轴是节次1-12 节每个方块还叠加了教师、教室、班级三个身份维度。冲突判定的数学表达很简单——两个区间是否重叠条件是 a.start b.end AND a.end b.start。难的是要在三个维度上同时判。源码的做法是保存排课时先做三次查询教师维度、教室维度、班级维度各查一次任一维度命中就拒绝保存并把冲突的具体记录返回给前端让排课老师知道冲突在哪。// edu-course/src/main/java/com/edu/course/service/impl/ScheduleServiceImpl.java Override public ListSchedule checkConflict(ScheduleDTO dto) { ListSchedule conflicts new ArrayList(); // 1. 教师冲突同一教师在同一学期的同一时间段已有课 LambdaQueryWrapperSchedule teacherQuery new LambdaQueryWrapper(); teacherQuery.eq(Schedule::getTeacherId, dto.getTeacherId()) .eq(Schedule::getSemesterId, dto.getSemesterId()) .eq(Schedule::getWeekDay, dto.getWeekDay()) // 节次区间重叠新排课起始 已有课结束 且 新排课结束 已有课起始 .le(Schedule::getStartSection, dto.getEndSection()) .ge(Schedule::getEndSection, dto.getStartSection()) // 周次区间重叠两边周次区间必须有交集 .le(Schedule::getStartWeek, dto.getEndWeek()) .ge(Schedule::getEndWeek, dto.getStartWeek()) .ne(dto.getId() ! null, Schedule::getId, dto.getId()); // 编辑时排除自己 conflicts.addAll(scheduleMapper.selectList(teacherQuery)); // 2. 教室冲突同一教室在同一时间段只能排一门课 LambdaQueryWrapperSchedule roomQuery new LambdaQueryWrapper(); roomQuery.eq(Schedule::getClassroomId, dto.getClassroomId()) .eq(Schedule::getSemesterId, dto.getSemesterId()) .eq(Schedule::getWeekDay, dto.getWeekDay()) .le(Schedule::getStartSection, dto.getEndSection()) .ge(Schedule::getEndSection, dto.getStartSection()) .le(Schedule::getStartWeek, dto.getEndWeek()) .ge(Schedule::getEndWeek, dto.getStartWeek()) .ne(dto.getId() ! null, Schedule::getId, dto.getId()); conflicts.addAll(scheduleMapper.selectList(roomQuery)); // 3. 班级冲突同一班级同一时间段不能上两门课 LambdaQueryWrapperSchedule classQuery new LambdaQueryWrapper(); classQuery.eq(Schedule::getClassId, dto.getClassId()) .eq(Schedule::getSemesterId, dto.getSemesterId()) .eq(Schedule::getWeekDay, dto.getWeekDay()) .le(Schedule::getStartSection, dto.getEndSection()) .ge(Schedule::getEndSection, dto.getStartSection()) .le(Schedule::getStartWeek, dto.getEndWeek()) .ge(Schedule::getEndWeek, dto.getStartWeek()) .ne(dto.getId() ! null, Schedule::getId, dto.getId()); conflicts.addAll(scheduleMapper.selectList(classQuery)); return conflicts; }参数含义逐个交代week_day 是 1 到 7start_section 和 end_section 是第几节一般一天 12 节上午 4 节、下午 4 节、晚上 4 节start_week 和 end_week 是教学周区间。区间重叠的两组条件必须同时成立才算冲突只判节次不判周次是新手最常见的漏判——「1-8 周的课」和「9-16 周的课」在同一时间同一教室是合法的不判周次就会误报。ne(dto.getId() ! null, ...) 这段是编辑场景的处理修改已有排课的教室时要排除自己这条记录否则会和自己冲突。这个条件在新增时短路不生效MyBatis-Plus 的条件构造器支持这种「条件成立才拼 SQL」的写法比手写 if 判断拼 SQL 干净不少。三个维度分别查询再合并而不是用一条 OR 的大 SQL是有意的。分开查能拿到具体的冲突类型和冲突记录前端可以分别提示「张老师这个时间有课」「A101 教室被占用」「计科 2101 班有课」排课老师一眼知道怎么调。一条大 OR 查出来只有一个「有冲突」等于把排查工作丢回给人。提示冲突检测在应用层做有个绕不过去的漏洞——两个排课老师同时提交两边都通过了检测最后都保存成功。要彻底解决得在 schedule 表上给 (teacher_id, semester_id, week_day, start_section, end_section) 建唯一索引靠数据库兜底。但这个索引在「同一教师同一时间允许排一门跨周次的课」这种场景下会误杀所以多数项目选择用分布式锁包住检测和保存两步源码里用的是 Redis 锁 教师 ID 作为 key。4.2 选课并发乐观锁、唯一索引与 Redis 预扣三件套选课是整个系统里并发最高的入口。假设容量的课程几百个学生同时点提交如果不做控制典型的结果是超卖——capacity 是 50selected_count 被加到了 63。原因很朴素两个线程同时读到 selected_count 49都判断「还有余量」都执行了加一。源码用了三层防护从外到内依次是 Redis 预扣、数据库乐观锁、唯一索引。第一层Redis 预扣。选课开始前把每条排课的余量预热到 Redis选课时用 Lua 脚本原子判断并扣减扣减失败直接返回「已满」不碰数据库。// edu-score/src/main/java/com/edu/score/service/impl/SelectionServiceImpl.java private static final String STOCK_KEY edu:schedule:stock:; // Lua 脚本保证「读余量 判断 扣减」三步原子执行 private static final String LUA_DEDUCT local stock tonumber(redis.call(get, KEYS[1])) if stock nil then return -1 end // key 不存在说明未预热 if stock 0 then return 0 end // 余量为 0已满 redis.call(decr, KEYS[1]) return 1; // 扣减成功 public boolean deductStock(Long scheduleId) { Long result redisTemplate.execute( new DefaultRedisScript(LUA_DEDUCT, Long.class), Collections.singletonList(STOCK_KEY scheduleId) ); return result ! null result 1L; }返回值约定很有用1 成功0 已满-1 未预热。第三个状态是给运维看的——选课开放前忘了跑预热脚本所有请求都会返回 -1日志里一眼能看出来是部署问题不是代码问题。第二层数据库乐观锁。Redis 扣减成功后才进数据库更新时用 version 字段做 CAS防止 Redis 和数据库短暂不一致导致的超卖。// 扣减数据库余量update ... where selected_count capacity 是更轻的乐观控制 Update(UPDATE schedule SET selected_count selected_count 1, version version 1 WHERE id #{scheduleId} AND selected_count capacity) int increaseSelected(Param(scheduleId) Long scheduleId);这条 SQL 的关键在 where 条件里的 selected_count capacity。它把「判断余量」和「扣减」合并成一条原子语句返回的影响行数为 0 就代表满了。相比 select 出来判断再 update 的两步写法这条语句不会被并发打断也不需要额外的锁。用 version 做 CAS 反而多余——因为这个条件本身就是足够强的并发控制。第三层唯一索引兜底。哪怕前面两层都漏了比如学生连点两次提交course_selection 表的 uk_student_schedule 会把第二次插入挡掉应用层捕获异常转成友好提示。Transactional(rollbackFor Exception.class) public void selectCourse(Long studentId, Long scheduleId) { // 1. Redis 预扣失败直接返回不产生数据库压力 if (!deductStock(scheduleId)) { throw new BizException(该课程余量不足); } try { // 2. 数据库余量扣减影响行数为 0 说明超卖回滚 Redis 预扣 int rows scheduleMapper.increaseSelected(scheduleId); if (rows 0) { rollbackStock(scheduleId); // 把 Redis 余量加回去 throw new BizException(该课程余量不足); } // 3. 写入选课记录唯一索引挡住重复提交 CourseSelection cs new CourseSelection(); cs.setStudentId(studentId); cs.setScheduleId(scheduleId); cs.setStatus(1); selectionMapper.insert(cs); } catch (DuplicateKeyException e) { rollbackStock(scheduleId); // 重复选课也要回滚余量 throw new BizException(你已选过这门课); } }这段代码里最容易被忽略的是两处 rollbackStock。Redis 扣了但数据库没扣成或者数据库扣了但选课记录写失败都必须把 Redis 余量加回去否则余量会越跑越少选课后期的学生看到「已满」但实际还有空位。事务回滚只能回滚数据库管不到 Redis这一步必须手动补。这种跨存储的一致性问题是选课模块最容易漏的地方。退课的逻辑正好反过来先更新选课记录状态为已退再数据库余量减一最后 Redis 余量加一。顺序不能颠倒否则退课失败但余量已经加回去等于凭空多出名额。4.3 成绩录入与绩点统计批量写入和一次算清成绩模块的写入量不大一个班几十条但有两个特殊要求一是必须能批量提交、单条失败不影响其他条二是绩点换算规则要能按学校改。批量录入用的是 MyBatis-Plus 的 saveOrUpdateBatch配合 Transactional 保证一批要么全成要么全败。真正值得说的是成绩合法性校验平时成绩和考试成绩都必须在 0 到 100 之间总评按比例加权缺考要单独标记。// edu-score/src/main/java/com/edu/score/service/impl/ScoreServiceImpl.java Transactional(rollbackFor Exception.class) public int batchSaveScore(ListScoreDTO list, Long teacherId) { // 先一次性查出这些排课是否都属于当前教师避免逐条查库 SetLong scheduleIds list.stream().map(ScoreDTO::getScheduleId).collect(Collectors.toSet()); Long ownCount scheduleMapper.countByTeacherAndIds(teacherId, scheduleIds); if (ownCount null || ownCount ! scheduleIds.size()) { throw new BizException(存在不属于你的课程成绩提交被拒绝); } ListScore scores new ArrayList(list.size()); for (ScoreDTO dto : list) { // 数值校验放在入库前非法数据不落库 if (dto.getUsualScore() null || dto.getExamScore() null) { throw new BizException(学生 dto.getStudentName() 的成绩未填写完整); } Score score new Score(); score.setId(dto.getId()); score.setStudentId(dto.getStudentId()); score.setScheduleId(dto.getScheduleId()); score.setUsualScore(dto.getUsualScore()); score.setExamScore(dto.getExamScore()); // 总评 平时 * 30% 考试 * 70%比例从配置读方便按学校规则改 BigDecimal total dto.getUsualScore().multiply(new BigDecimal(0.3)) .add(dto.getExamScore().multiply(new BigDecimal(0.7))) .setScale(1, RoundingMode.HALF_UP); score.setTotalScore(total); score.setCreditPoint(calcCreditPoint(total)); // 绩点换算 scores.add(score); } // 批量写入单条失败整批回滚 return scoreMapper.insertOrUpdateBatch(scores); } // 常见的 4.0 绩点制换算可按学校规则整体替换这个方法 private BigDecimal calcCreditPoint(BigDecimal total) { double t total.doubleValue(); if (t 60) return BigDecimal.ZERO; // 60 分对应 1.0每多 1 分加 0.1100 分封顶 5.0 BigDecimal cp BigDecimal.valueOf((t - 50) / 10.0).setScale(1, RoundingMode.HALF_DOWN); return cp.min(new BigDecimal(5.0)); }权限校验这段是教务系统里必须有的。教师只能录自己教的课的成绩如果只在前端做过滤改个请求参数就能给别人的课录成绩这是很典型的越权漏洞。源码里的做法是把当前登录教师的 ID 从 JWT 里取出来和提交的 scheduleId 做一次集合比对只要有一个不属于自己就整批拒绝。countByTeacherAndIds 是一条 SQL 查完不会因为学生多而变慢。绩点换算单独抽成方法是因为不同学校的规则差异极大有的用 4.0 制、有的用 5.0 制、有的按分数段阶梯换算、有的把补考和重修分开算。抽成方法后二次开发时改这一个方法就够了不用动批量写入的主流程。更好的做法是把它做成策略接口按学期配置选择不同实现这一点在二次开发那章展开。5. 避坑与排查五个真实翻过的车5.1 现象登录成功但左侧菜单空白现象用预置的管理员账号登录接口返回 200token 也正常带上了但页面左侧菜单只有一个首页其余全不见。原因前端路由守卫读的是 store.user.js 里的 permissions 数组这个数组来自登录接口返回的用户信息。源码里登录接口只返回了 token用户信息和权限码要靠登录后再调一次 /user/info 获取。如果这个接口的返回结构是 {code, data}而前端解构写成了 res.data.permissions那就变成了取 data 里的 data永远是 undefined。这类解构层级对不上的问题在前后端分离项目里极其常见。解决先在浏览器 Network 里看 /user/info 的原始返回确认权限字段在哪一层再核对前端 store 里的取值路径。另外检查后端角色表里管理员角色的权限码是否为空——新建数据库只灌了角色没灌角色权限关联表也会导致权限数组是空的。判断方法很直接看 SQL 查询有没有返回行不看代码猜。5.2 现象排课保存时报 Duplicate entry 但表里没有重复数据现象新增一条排课提示唯一键冲突但按教师、教室、时间查了一遍确实没有重复记录。原因schedule 表上如果建了含逻辑删除字段的唯一索引比如 uk_teacher_time (teacher_id, week_day, start_section, deleted)删除一条排课只是把 deleted 从 0 改成 1唯一索引里仍然留着这条记录。再新建一条同样教师同样节次的排课deleted 也是 0两条 deleted0 的记录就撞了。逻辑删除和唯一索引天生冲突。解决把 deleted 字段改成删除时写入主键 ID 或者时间戳而不是固定的 1这样每条删除记录的值都不同不会互相冲突。或者干脆对排课这种强时间属性的数据用物理删除配合操作日志留痕。改字段类型时注意从 TINYINT 换成 BIGINT否则 ID 大了会溢出。5.3 现象选课高峰期接口大面积超时数据库连接池耗尽现象选课开放五分钟后端开始大量报「HikariPool-1 - Connection is not available」前端一直转圈。原因三个地方叠加。第一选课接口没有限流前端按钮没做防抖一个学生一秒能发十几次请求第二余量查询每次都走数据库 count一条排课几百人查就是几百次 count第三连接池默认最大 10 个连接扛不住瞬时并发。这三个问题单独都不致命凑在一起就是雪崩。解决按优先级改三处。余量查询改成读 Redis 预热值不进数据库选课接口加一层基于 Redis 的分布式限流按学生 ID 限每秒 2 次连接池 maximum-pool-size 调到 30 到 50同时把 connection-timeout 从默认 30 秒调到 3 秒让拿不到连接的请求快速失败而不是排队等死。改完再压测一轮重点看慢查询日志里有没有漏掉的 count。5.4 现象成绩导出的 Excel 打开是乱码现象成绩单导出功能下载下来的 xlsx用 Excel 打开中文全是问号用 WPS 打开正常。原因典型的响应头问题。后端在写响应流时没有设置 Content-Type 和 Content-Disposition或者设置了但没有 URL 编码文件名浏览器按默认的 ISO-8859-1 解析。WPS 容错性好所以看起来正常换个环境就露馅。解决导出接口固定写上这三行文件名用 URLEncoder 编码一次。response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setCharacterEncoding(utf-8); String fileName URLEncoder.encode(成绩单_ clazzName, UTF-8).replaceAll(\\, %20); response.setHeader(Content-Disposition, attachment;filename*utf-8 fileName);注意replaceAll(\, %20) 这行不能省。URLEncoder 会把空格编成加号而 HTTP 头里的加号会被某些浏览器当成字面量导致文件名里出现加号而不是空格。5.5 现象改完实体字段后查询报 Unknown column现象给课程表加了一个 course_nature 字段实体也加了对应属性但一查就报 Unknown column course_nature in field list。原因MyBatis-Plus 的字段映射依赖 map-underscore-to-camel-case 配置但这个配置只对查询结果集映射生效对自动生成的 SQL 里的列名同样生效。如果实体属性叫 courseNature配置没开生成的 SQL 里列名就是 courseNature数据库里却是 course_nature自然找不到。另外还有一种情况是加了 TableField(exist false) 的字段被误删了注解MyBatis-Plus 就当作真实列去查了。解决先确认配置文件里 map-underscore-to-camel-case 是 true且这个配置在正确的 profile 下生效dev 配置写了、prod 没写的情况很常见。如果是特殊命名对不上就在字段上明确写 TableField(course_nature)。第三种可能是字段加了但数据库没加改完实体记得同步执行 DDL本地开发环境尤其容易忘。6. 二次开发多租户、移动端和绩点策略这三处最值得动拿到这套源码多数人的第一反应是加功能。但按我的经验先想清楚改哪里比急着写代码重要。下面三处改造的性价比最高也最能体现这套架构留的余地。第一处多院系数据隔离。如果这套系统要给多个院系共用最省事的做法不是给每张表加 college_id 再到处写 where而是用 MyBatis-Plus 的租户插件统一拦截。写一个 TenantLineHandler从当前登录用户的上下文里取院系 ID插件会自动给所有配置了租户字段的表拼上 where college_id ?。// edu-common/src/main/java/com/edu/common/config/TenantConfig.java Bean public MybatisPlusInterceptor tenantInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new TenantLineInterceptor(new TenantLineHandler() { Override public Expression getTenantId() { // 从 ThreadLocal 里取登录用户所属院系网关或过滤器里已经塞好 return new LongValue(UserContext.getCollegeId()); } Override public String getTenantIdColumn() { return college_id; } Override public boolean ignoreTable(String tableName) { // 课程库、学期这类全局表不参与隔离否则新建学期会被绑到某个院系 return GLOBAL_TABLES.contains(tableName); } })); return interceptor; }改造时要盯住 ignoreTable 这个方法。全局表学期、教室、字典如果被误加了隔离条件新建的数据会带上当前院系的 college_id换个院系登录就查不到表现是「数据莫名消失」。我第一次做这个改造时就漏了学期表结果第二个院系登录看不到任何可选学期排查了半天才发现是拦截器把全局表也拦了。第二处移动端适配。教务系统现在绕不开学生手机查课表和成绩。前端不需要重写把 Vue 3 项目里 views 下的学生端页面单独打一个移动端入口用 postcss-px-to-viewport 做单位转换再在路由里按 UA 分流即可。后端接口完全复用只要注意分页参数在小屏上的默认值——PC 端默认每页 10 条手机上改成 5 条体验会好很多。第三处绩点规则策略化。前面提到的 calcCreditPoint 是硬编码的改造时把它抽成接口加多个实现用学期配置决定走哪个实现。改造点改动文件影响范围验证方式多院系隔离TenantConfig、各实体加 collegeId所有业务查询两个院系账号交叉登录互不可见移动端入口前端 router、vite 配置仅学生端页面手机浏览器打开课表可查可缩放绩点策略化ScoreService、新增策略实现类成绩统计接口切换配置后重新计算同一批成绩结果符合预期验证方法我一般固定成三步先造两套对照数据再切换配置跑一遍最后比对导出的成绩单和手算结果。这三步走完基本不会翻车。提示改造前先把原始版本的接口响应批量存一份快照改完用脚本跑一遍比对。教务系统的接口返回字段多靠肉眼对很容易漏。这套代码我拆过不止一遍最大的教训是别急着改业务逻辑先把逻辑删除、唯一索引、连接池这三个基础设施层的东西看明白。数据一致性上的后悔药事后补的代价永远比事前大。从那以后我每次接手这类系统都会先把所有唯一索引和执行计划拉出来过一遍确认没有逻辑删除踩唯一键的坑再动业务代码。希望帮到你。本文还有配套的精品资源点击获取
企业数字化 ERP 产品动态
相关推荐
宠物领养救助管理系统毕设工程:完整业务闭环与二次开发指南 简介:这份毕业设计资源包面向计算机相关专业学生与Java Web初学者,围绕宠物领养救助场景构建一套完整的管理系统,可用于课程设计、毕业设计参考或全栈入门练手。压缩包共236个文件、约15.61MB,以49个Java源文件承载后端业务逻辑&a… · 2026/11/13 12:32:22
WPF控件库Newbeecoder.UI实战:资源字典、主题切换与二次开发 简介:Newbeecoder.UI开源控件库面向WPF桌面应用开发者,尤其适合希望快速搭建现代美观界面、又不想从零手写控件样式的初中级开发者。库中整合了按钮、输入框、下拉列表、日历、进度条、树形视图、数据网格等常用与高级组件,并配套样式主题系统… · 2026/11/15 21:30:51
Unity3D素材包导入实战:从拆包到资产库的完整流程 简介:这份资源面向Unity3D初学者与独立开发者,围绕游戏制作中常见的素材与组件组织,帮助读者理解一个完整项目里模型、动画、脚本、音效与界面等要素如何协同工作。压缩包共56个文件,以35个js脚本、12个rtf说明文档、8个unitypack… · 2026/11/19 7:54:17
莱阳电工证报考条件内部消息:别再被坑!这5步教你搞定电工证 莱阳电工证报考条件内部消息:别再被坑!这5步教你搞定电工证 现在找工作,没个电工证根本没人搭理!尤其是在建筑工地、工厂、电力公司这些地方,电工证就是你的敲门砖。可偏偏很多人连莱阳电工证报考条件都不清楚,光凭一张嘴说自己会电工,那只能白忙一场… · 2026/11/20 23:59:17
考电工证体检几项最新政策解读 全国通用证书怎么复审 考电工证体检几项最新政策解读 全国通用证书怎么复审 证书过期了不知道怎么复审延期?别慌,这篇文章给你讲明白。尤其是手里拿着低压电工证、高压电工证的你,如果还没搞清楚体检项目和复审流程,那真的要吃大亏。别让一张全国通用的电工证变成“废纸”,赶… · 2026/11/20 23:59:17
电工证原价多久拿证?别再被中介忽悠了 电工证原价多久拿证?别再被中介忽悠了 你是不是也遇到过这种情况?明明是想考个电工证,结果被各种培训机构、中介绕得晕头转向,价格也五花八门,到底哪一家靠谱?更头疼的是, 多久拿证 成了你最大的疑问,生怕耽误了工期和项目进度。… · 2026/11/20 23:59:17
电工证牌照过期了不知道怎么复审延期?内部消息来了 电工证牌照过期了不知道怎么复审延期?内部消息来了 证书过期了不知道怎么复审延期?你不是一个人。最近很多在工地、工厂一线干活的电工朋友都在问这个问题,尤其是在 鹤壁 这样的水利工程建设地,特种作业证的 复审流程 和 地区差异… · 2026/11/20 23:59:17
低压电工证是四级吗?含金量高不高?工地电工必看 低压电工证是四级吗?含金量高不高?工地电工必看 工地太忙根本没时间复习考试,低压电工证是四级吗?含金量高不高?这些问题困扰着很多一线电工,尤其是那些在安阳市政公用工程单位工作的同事。今天咱们就来掰扯清楚,低压电工证到底是几级、含金量如何,还… · 2026/11/20 23:59:17
电工证考试科四通过率揭秘:学历不高也能报上名 电工证考试科四通过率揭秘:学历不高也能报上名 你是不是也担心自己学历不够,考不了电工证?别急,今天就带你扒一扒【电工证考试科四】的真实通过率,让你明白, 学历不高怕报不上名 其实是个误区。… · 2026/11/20 23:58:17
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32
建设厅特种工周三报名怎么弄?上岗必备别被中介坑 建设厅特种工周三报名怎么弄?上岗必备别被中介坑 不知道去哪报名怕被中介坑?作为商丘某高校工程类应届毕业生,小李最近就遇到了这样的困扰。他刚毕业,正在找实习岗位,发现很多工地都要求持有特种作业操作证,尤其是【建设厅特种工周三报名】这个时间点,… · 2026/11/20 0:00:54
中专考的中级电工证内部消息全攻略 中专考的中级电工证内部消息全攻略 你中专毕业,手头有中级电工证,但不知道从哪开始报名,怕被中介坑?别急,这篇文章就是为你量身定制的“内部消息”,帮你避开报名陷阱,稳稳拿到证书。… · 2026/11/20 0:00:54
外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价 外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价 之前考的证在外省能不能转过来?这几乎是所有在外地打拼的电工从业者最关心的问题。特别是像洛阳这样的工业城市,很多电工证是在外地考的,现在想在当地用,流程是不是很复杂?其实,只要搞清楚… · 2026/11/20 0:00:54
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03