简介这是一份基于ASP.NET WebForms平台开发的智能选课系统完整项目源码面向计算机专业学生、课程设计选题者以及需要搭建教务选课平台的技术人员。项目围绕学生、教师、管理员三类角色展开实现用户登录与权限管理、课程信息展示、选课与退课、班级维护、学生与教师信息管理、成绩管理等核心功能可有效替代传统人工排课流程提升教务管理效率。压缩包共45个文件以10个aspx页面、12个C#逻辑代码和11个resx资源文件为主体另含sln解决方案、mdf/ldf数据库、web.config配置、htm/txt使用说明等文件整体仅167KB。目录结构清晰、数据库文件齐备可直接还原部署或在现有功能模块上扩展二次开发。目前已有306人学习访问适合需要参考Web表单经典开发模式、理解选课业务完整链路的开发者。1. 智能选课系统选课季不再靠手速而是靠规则每学期选课系统开放那几分钟教务群里总有人喊「又崩了」「抢到了但是冲突」。我拆过不少选课类项目这套智能选课系统是比较完整的一套它把「先到先得」的抢课模式改成了「志愿匹配 自动排课」——学生先填志愿系统根据先修课、绩点、教学评价等因素打分排序选课一开放就按结果批量处理同时自动避开时间、教室、教师三类冲突。它适合两类人一类是需要在现有教务系统上做二次开发的开发者想找一个能跑的底座另一类是课程设计选了「选课系统」题目、想看清完整链路的学生团队。这篇文章我会从技术栈、目录结构、核心算法、部署排查一路拆到改造建议。2. 系统架构与技术选型前后端分离 事务型选课核心先交代整体技术地图。这套智能选课系统采用前后端分离架构前端 Vue 3 Element Plus后端 Spring Boot 2.7 MyBatis-Plus数据落在 MySQL 8.0Redis 承担缓存与分布式锁。选课这类业务的特点是写密集、并发高、状态多所以系统把「预检—加锁—校验—写入」做成一条固定链路而不是把逻辑散落在各个 Controller 里。这个设计决策直接决定了后续改造的难易度——你改一个环节不会牵连到别的接口。2.1 目录结构从启动类到可运行包的完整布局拿到源码后我习惯先不看 README而是直接开目录。整个工程被清晰分成 frontend、backend、sql 三块光看命名就能猜到各自的职责。前端是两个独立视图合在一个工程里后端则是标准的 Spring Boot 分层外加一个专门的算法包。smart-course/ ├── frontend/ # Vue3 工程 │ ├── src/views/student/ # 学生端页面 │ ├── src/views/admin/ # 教务管理端 │ └── src/api/ # 接口封装 ├── backend/ │ ├── controller/ # 选课、课程、用户接口 │ ├── service/ # 事务核心 │ ├── mapper/ # MyBatis-Plus Mapper │ ├── algorithm/ # 冲突检测、志愿匹配算法 │ └── config/ # 跨域、Redis 配置 └── sql/ ├── schema.sql # 建库建表 └── init_data.sql # 示例数据后端把算法单独放一个包这个设计从第一次看就觉得很对冲突检测和选课事务分离意味着你可以先单独跑算法测试再挂到接口上而不是每次改排课规则都要重启整个服务。前端部分学生端和管理端是两个独立的视图目录共用同一套 api 封装。学生端核心页面有三个选课大厅、我的课表、志愿填报管理端有课程管理、开课审核、选课结果导出。目录结构里没有多余的外层壳子拿过来就能定位到要改的文件。2.2 接口设计一套 REST 接口如何覆盖选课全流程系统对外暴露的接口不多但每个都对应一个明确的业务动作。我整理了一份核心接口清单二次开发时你会频繁跟它们打交道。方法路径作用关键参数POST/api/preference/submit提交选课志愿studentId, classIdList, priorityPOST/api/enrollment/select正式选课单班studentId, classIdDELETE/api/enrollment/{id}退课enrollmentIdGET/api/teaching/available查询某学生可选教学班studentId, semesterIdPOST/api/admin/enrollment/batch批量处理志愿管理员semesterId其中值得留意的是「查询可选教学班」这个接口。它不只是返回课程列表还会在返回前做两件事过滤掉学生已经选过的班级标注出与学生已有课表冲突的班级。这两个动作在接口层完成是为了让前端拿到数据后可以直接绘制课表不需要自己写时间重叠判断。批量处理志愿的接口是管理端独有的它把学生提交的志愿表统一读出来计算结果分成「已选」「候选」「落选」三种状态写回 enrollment 表是整个系统的收口动作。2.3 数据库设计五张核心表怎么支撑选课闭环数据库设计是这套系统里最值得看的部分。总共六张核心表学生表、教师表、课程表、教学班表、选课记录表、志愿表。课程与教学班分离是排课系统的关键——同一门课允许开多个班每个班绑定各自的教师、时间、教室和容量。冲突检测的对象不是课程而是教学班因为同一个课程代码在不同时间开课完全不冲突。表名关键字段作用studentid, grade_point, major学生基础信息与绩点courseid, name, credit, prerequisite_id课程定义含先修课teaching_classid, course_id, teacher_id, weekday, time_slot, room, capacity每个班的上课时间、教室与容量enrollmentid, student_id, class_id, status选课结果status 含已选/已退/候选preferenceid, student_id, class_id, priority学生志愿与优先级preference 表是整个「智能」二字的载体。学生提交的不是单个选课请求而是一组带优先级的志愿系统在选课开放后统一读取 preference 表按规则批量处理。这么做的好处是选课从「抢」变成了「等结果」服务器压力从峰值瞬间集中变成可控的批量计算。选课记录的 status 字段也很容易被忽略它不只是「已选」还包含「已退」「候选」。候选状态是为补选设计的如果有人退课系统会自动把候选名单里优先级最高的人补进去。数据库脚本在 sql 目录下建库后直接执行 schema.sql 和 init_data.sql 就能获得一批可演示的教学班数据。2.4 事务与并发为什么选课接口不能只加 synchronized最开始我拆这类项目时习惯性地以为选课就是「先查容量再 insert」。但容量检查和插入之间有时间差两个并发请求可能同时读到剩余名额为 1然后双双插入成功——超卖。这套系统的做法是三层防线数据库唯一索引、Redis 分布式锁、事务隔离级别。唯一索引防止同一学生重复选同一班分布式锁防止容量超卖事务保证状态变更要么全部成功要么全部回滚。这里要说清楚一个选择为什么用 Redis 分布式锁而不是数据库悲观锁因为选课接口内部还要做推荐计算和冲突检测整个操作耗时不短持锁时间太长用数据库行锁会把其他不相干的读写也拖住。另一个细节是 time_slot 的格式设计——它编码成「星期 节次」的离散枚举而不是时间戳。原因很简单时间戳做区间重叠判断需要复杂的条件拼接离散节次可以让冲突判断退化成位运算性能好一个量级。这个取舍在后面核心代码里能看到它带来的实际收益。3. 核心模块拆解一次选课请求从进入到返回的完整链路这一章是最值得看的部分。我选了三个点来讲冲突检测时间、教室、教师三个维度、志愿匹配算法评分排序、以及选课事务的完整链路。这三段代码基本覆盖了系统的核心逻辑也对应你在二次开发时最可能改的地方。3.1 冲突检测时间、教室、教师三类冲突一次算清冲突检测的核心对象是教学班。一个教学班包含 weekday星期几、time_slot第几节到第几节、room、teacher_id。判断两个班是否冲突最朴素的做法是逐对比较每个维度但这套系统用了一个技巧把时间槽位编码成二进制位图一个班的上课时间合并成一个 long冲突判断从多维字符串比较退化成位与运算。// 时间段冲突判断把 weekday 和 time_slot 编码成位图 public boolean isTimeConflict(TeachingClass a, TeachingClass b) { long aMap timeSlotToBitMap(a.getWeekday(), a.getStartSection(), a.getEndSection()); long bMap timeSlotToBitMap(b.getWeekday(), b.getStartSection(), b.getEndSection()); return (aMap bMap) ! 0L; } // 位图编码一天最多 12 节一周 7 天正好装进一个 long private long timeSlotToBitMap(int weekday, int startSection, int endSection) { long map 0L; int base weekday * 12; for (int i startSection; i endSection; i) { map | (1L (base i)); } return map; }这个方法把「星期几 第几节」映射到 long 的 84 个位上7 天 × 12 节两个班只要位与结果不为 0就说明存在重叠节次。参数里的 startSection 和 endSection 是闭区间比如第 3 节到第 4 节编码时循环会分别置位 3 和 4不会出现差一错误。教室冲突和教师冲突的判断逻辑更简单——直接比较教室 ID 和教师 ID 是否相同然后再加一个时间重叠的前置条件最终统一封装在一个 ConflictChecker 类里。这个类对外返回一个 ConflictReport 对象里面包含冲突类型TIME / ROOM / TEACHER和涉及的另一方名称。前端拿到这个报告后会在课表上用红框标出冲突的班级并提示具体是跟哪门课、哪个教室冲突。这个报告对象是二次开发时最容易扩展的地方你后续想加「校区冲突」「体育课特殊场地冲突」在这个类里加枚举值就行。3.2 志愿匹配绩点、先修课、教学评价怎么合成一个分数「智能」的核心在这个方法里。系统计算每个学生对每个志愿班的综合评分评分由三部分组成绩点权重、先修课达成度、课程的历史教学评价。评分之后按「志愿优先级 分数」双关键字排序高优先级且高分优先录取名额满了就进入候选队列。public int score(Student student, TeachingClass clazz, ListEnrollment history) { int score 0; // 绩点权重3.5 以上 303.0 以上 20其余 10 if (student.getGradePoint() 3.5) score 30; else if (student.getGradePoint() 3.0) score 20; else score 10; // 先修课达成已通过先修课加分没通过直接扣 50 并标记不可选 Course course courseService.getById(clazz.getCourseId()); if (course.getPrerequisiteId() ! null) { boolean pass history.stream() .anyMatch(e - e.getCourseId().equals(course.getPrerequisiteId()) PASS.equals(e.getStatus())); score pass ? 20 : -50; } // 教学评价从课程表冗余字段读取优秀课程 10 if (clazz.getRating() 4.5) score 10; return score; }这段代码的参数设计有讲究。绩点阈值、加分值都是常量在真实项目里这些值会被抽到配置表由教务在选课开始前调整。先修课没通过的惩罚值设得很高是为了保证评分排序时「不满足先修课」的学生几乎不可能靠志愿优先级翻盘。整个 score 方法没有副作用输入学生和班级状态输出一个整数非常容易写单元测试——这也是我建议你在二次开发时优先改这个方法的原因它好验证。这个评分方法在批量处理时会被反复调用性能上有一个优化点值得留意history 参数只需要查询一次在批处理外层加载好传给每个 score 调用复用避免每个班级都去查一次成绩表。源码里这个优化是做了的你在读代码时如果发现 score 方法被循环调用注意看上层是否用了局部缓存不要自己画蛇添足再加缓存把内存撑爆。3.3 选课事务分布式锁 唯一索引 状态机选课入口看起来只是一个普通接口但内部是完整的状态机。核心逻辑分为几步先获取 Redis 分布式锁锁内做容量校验、冲突校验、写入 enrollment 表最后释放锁。Transactional public Enrollment select(SelectRequest req) { String lockKey lock:class: req.getClassId(); boolean locked redisLock.tryLock(lockKey, 3, TimeUnit.SECONDS); if (!locked) { throw new BizException(当前选课人数过多请重试); } try { TeachingClass clazz teachingClassMapper.selectById(req.getClassId()); if (clazz.getEnrolledCount() clazz.getCapacity()) { throw new BizException(该教学班已满); } if (conflictChecker.hasAnyConflict(req.getStudentId(), req.getClassId())) { throw new BizException(存在时间/教室/教师冲突); } // 唯一索引 (student_id, class_id) 兜底防重 Enrollment enrollment new Enrollment(req.getStudentId(), req.getClassId(), SELECTED); enrollmentMapper.insert(enrollment); teachingClassMapper.increaseEnrolledCount(req.getClassId()); return enrollment; } finally { redisLock.unlock(lockKey); } }这里有几个值得注意的细节。tryLock 设置 3 秒超时防止学生在接口上一直等待锁的粒度是教学班而不是学生因为容量共享是核心竞争点教室和教师冲突通常不走锁。事务和锁的顺序也有讲究先 lock再进入 Transactional 方法保证从解锁到提交之间不会有新的读操作插进来看到中间状态。这是我在踩过「锁先释放、事务还没提交」的坑之后养成的习惯。退课操作是另一个容易写错的地方。它不只是删除一条记录先要关闭「已选」状态再触发候选补选。补选逻辑同样包在事务里并且用同一个分布式锁锁住教学班因为补选本质上也是写操作。Transactional public void dropEnrollment(Long enrollmentId) { Enrollment enrollment enrollmentMapper.selectById(enrollmentId); String lockKey lock:class: enrollment.getClassId(); redisLock.tryLock(lockKey, 3, TimeUnit.SECONDS); try { enrollment.setStatus(DROPPED); enrollmentMapper.updateById(enrollment); // 取出候选队列中优先级最高的学生直接补选 ListPreference candidates preferenceMapper .selectCandidates(enrollment.getClassId(), CANDIDATE); if (!candidates.isEmpty()) { Preference first candidates.get(0); Enrollment newEnrollment new Enrollment( first.getStudentId(), enrollment.getClassId(), SELECTED); enrollmentMapper.insert(newEnrollment); teachingClassMapper.increaseEnrolledCount(enrollment.getClassId()); } } finally { redisLock.unlock(lockKey); } }补选的时候有个性能问题需要注意如果候选人数很多每次退课都触发一次队列扫描压力不小。这套系统的做法是给 preference 表加一个状态字段batch 处理时把所有落选的人一次性标记成 CANDIDATE退课补选只取 statusCANDIDATE 的第一条按 priority 排序后取第一条。这样查询走索引补选是 O(1) 的量级不会因为候选人多而变慢。开发者如果自己从头写补选逻辑很容易写成「全表扫一遍找出最高优先级」数据量一上来就翻车这里的设计可以直接借鉴。4. 本地运行与避坑排查从零到能点开选课页面的完整流程这一章的目标是让你拿到源码后能在半小时内跑起来。流程分四步初始化数据库、启动 Redis、启动后端、启动前端。每一步都有对应的检查点失败时看日志定位。4.1 环境准备与数据库初始化需要 JDK 1.8、Maven 3.6、Node 16、MySQL 8.0、Redis 6。第一步先建库mysql -u root -p -e CREATE DATABASE smart_course DEFAULT CHARSET utf8mb4; mysql -u root -p smart_course sql/schema.sql mysql -u root -p smart_course sql/init_data.sqlinit_data.sql 里内置了 3 个学生账号、5 门课程、8 个教学班和一批志愿数据登录后能直接看到效果。如果执行脚本报错多半是 MySQL 版本太低或者字符集设置不对检查一下 sql 文件里是否有 utf8mb4 相关的 DDL以及你的 MySQL 是否支持。另外注意 init_data.sql 里有外键依赖建表脚本必须全量执行成功再导入数据跳步执行会报外键约束错误。4.2 启动后端与前端后端配置在 application.yml主要改三处数据库连接、Redis 地址、端口。默认端口 8080Redis 默认 localhost:6379。如果你本地的 MySQL 或 Redis 改了密码记得同步改这里连接池初始化失败是启动阶段最常见的报错。启动命令cd backend mvn spring-boot:run看到 Tomcat started on port(s): 8080 后后端就起来了。前端需要先安装依赖再启动 dev servercd frontend npm install npm run dev默认前端端口 5173通过 Vite 代理把 /api 转发到 8080所以本地不需要额外处理跨域。启动后访问 5173 端口用 init_data.sql 里内置的管理员账号登录管理端能看到课程管理和开课审核两个页面。学生账号登录后能看到选课大厅和志愿填报入口先提交一组志愿再用管理员账号跑一次 batch 处理能看到志愿状态从「待处理」变成「已选」或「候选」。4.3 常见问题与避坑记录这一部分是我在复现过程里遇到过的真实问题全部按「现象 → 原因 → 解决」整理你在跑的过程中如果卡住先对号入座。现象一后端启动报连接超时日志里出现 Failed to connect to Redis。直接原因通常是 Redis 没有启动或者 application.yml 里的地址写的是远程 IP 而本机没放通防火墙。解决方法是先本地启动 redis-server 确认 6379 端口正常再把地址改回 127.0.0.1排除网络因素后再接远程实例。这个报错信息本身带着完整的连接地址先看它连的是不是你以为的那个地址。现象二前端能打开页面但接口全部 404浏览器控制台能看到 /api/xxx 请求返回 index.html。原因是 Vite 代理没生效。检查 frontend/vite.config.ts 里的 proxy 配置target 必须是 http://127.0.0.1:8080同时确认后端启动端口没有被占用。如果后端改过端口两处要一起改只改一处就会看到这种页面能开、数据全空的诡异状态。现象三选课接口报「该教学班已满」但数据库里明显有空位。原因多半是 enroll_count 字段和实际记录数不一致。教学班的容量是冗余字段如果之前手动在数据库里删过 enrollment 记录enrolled_count 不会自动减。解决方法是写一条 SQL 把 enrolled_count 重算为实际数量或者直接重新执行 init_data.sql 做一次全新初始化不要手动改数手动改容易改出负数。现象四退课后候选补选不触发。原因是候选队列里根本没有状态为 CANDIDATE 的记录。批量处理志愿batch那一步如果没有跑所有落选者状态会是 UNPROCESSED而不是 CANDIDATE。先确认管理员后台执行过 batch 操作再查 preference 表的状态字段。这个问题容易让人误以为补选代码有 bug实际上只是数据状态没走到位。现象五并发压测时偶尔出现容量超卖检查日志发现分布式锁没有起作用。常见原因是两个节点用了不同的 Redis 库或不同的 key 前缀导致锁互不可见。需要确认所有实例连接的是同一个 Redis并且锁 key 规则一致不能一部分走 lock:class: 前缀另一部分走自定义前缀。分布式锁这种问题不会在单机测试时暴露只有压测或者多实例部署时才现形属于典型的「测试环境一切正常上线就翻车」。现象六MySQL 时区报错 The server time zone value CST is unrecognized。原因是 MySQL 8.0 的时区设置与 JDBC 驱动不一致。在 jdbc url 里加 serverTimezoneAsia/Shanghai 即可解决。这个问题无害但会挡住启动流程第一次跑时直接加好省得日志滚动刷屏干扰你排查别的错误。5. 二次开发三个值得动手的改造方向与验证技巧如果你准备拿这套系统做二次开发我建议从三个方向里挑一个动手不要一上来就重构整个选课流程。方向一最安全方向二涉及面大一些方向三对性能提升最明显。方向一把评分常量配置化。score 方法里的绩点阈值和加分值当前是硬编码的上线前教务肯定要调整。改造方式是新建一张 rule_config 表启动时加载到内存评分时从内存读验证方式是写一个参数化单元测试改变阈值后确认原先能选上的学生会被挤到候选区。这个改动不碰事务逻辑风险最低适合作为读代码的热身。方向二增加先修课硬校验。当前先修课只做加分和扣分并不会真正阻止选课。更严谨的改造是在选课事务里加一层硬校验如果未通过先修课直接抛异常不允许提交。要注意的是先修课的通过状态来自成绩表这块数据当前是模拟的改造时需要先确定成绩数据源。改完后记得在冲突报告里增加一种 PREREQUISITE 类型前端才能给出对应的提示文案。方向三把选课结果导出做成异步任务。当前管理端的导出接口是同步查询选课人数多的时候会卡住。改造思路是引入线程池把导出任务丢给后台生成 CSV完成后通过通知中心提醒管理员下载。验证时用较大数据量压一次导出接口确认接口在 2 秒内返回「任务已创建」而不是一直转圈。我的习惯是每改一个模块前先跑一遍该模块的单元测试确认基线是绿的改完再跑一遍对比破坏的地方。如果是涉及选课事务的改动就同时起两个客户端并发戳同一个教学班接口看会不会出现超卖。这套「先基线、再改造、最后并发验证」的流程帮我在这个项目上少走了很多弯路。从那以后我每次接手这类核心业务系统都强制先跑一遍基线测试再动代码这个习惯让我避开了好几次自以为改对了、一上线就出幺蛾子的局面。希望这篇文章能帮你在智能选课系统的源码里快速找到方向。本文还有配套的精品资源点击获取
简介这是一份基于ASP.NET WebForms平台开发的智能选课系统完整项目源码面向计算机专业学生、课程设计选题者以及需要搭建教务选课平台的技术人员。项目围绕学生、教师、管理员三类角色展开实现用户登录与权限管理、课程信息展示、选课与退课、班级维护、学生与教师信息管理、成绩管理等核心功能可有效替代传统人工排课流程提升教务管理效率。压缩包共45个文件以10个aspx页面、12个C#逻辑代码和11个resx资源文件为主体另含sln解决方案、mdf/ldf数据库、web.config配置、htm/txt使用说明等文件整体仅167KB。目录结构清晰、数据库文件齐备可直接还原部署或在现有功能模块上扩展二次开发。目前已有306人学习访问适合需要参考Web表单经典开发模式、理解选课业务完整链路的开发者。1. 智能选课系统选课季不再靠手速而是靠规则每学期选课系统开放那几分钟教务群里总有人喊「又崩了」「抢到了但是冲突」。我拆过不少选课类项目这套智能选课系统是比较完整的一套它把「先到先得」的抢课模式改成了「志愿匹配 自动排课」——学生先填志愿系统根据先修课、绩点、教学评价等因素打分排序选课一开放就按结果批量处理同时自动避开时间、教室、教师三类冲突。它适合两类人一类是需要在现有教务系统上做二次开发的开发者想找一个能跑的底座另一类是课程设计选了「选课系统」题目、想看清完整链路的学生团队。这篇文章我会从技术栈、目录结构、核心算法、部署排查一路拆到改造建议。2. 系统架构与技术选型前后端分离 事务型选课核心先交代整体技术地图。这套智能选课系统采用前后端分离架构前端 Vue 3 Element Plus后端 Spring Boot 2.7 MyBatis-Plus数据落在 MySQL 8.0Redis 承担缓存与分布式锁。选课这类业务的特点是写密集、并发高、状态多所以系统把「预检—加锁—校验—写入」做成一条固定链路而不是把逻辑散落在各个 Controller 里。这个设计决策直接决定了后续改造的难易度——你改一个环节不会牵连到别的接口。2.1 目录结构从启动类到可运行包的完整布局拿到源码后我习惯先不看 README而是直接开目录。整个工程被清晰分成 frontend、backend、sql 三块光看命名就能猜到各自的职责。前端是两个独立视图合在一个工程里后端则是标准的 Spring Boot 分层外加一个专门的算法包。smart-course/ ├── frontend/ # Vue3 工程 │ ├── src/views/student/ # 学生端页面 │ ├── src/views/admin/ # 教务管理端 │ └── src/api/ # 接口封装 ├── backend/ │ ├── controller/ # 选课、课程、用户接口 │ ├── service/ # 事务核心 │ ├── mapper/ # MyBatis-Plus Mapper │ ├── algorithm/ # 冲突检测、志愿匹配算法 │ └── config/ # 跨域、Redis 配置 └── sql/ ├── schema.sql # 建库建表 └── init_data.sql # 示例数据后端把算法单独放一个包这个设计从第一次看就觉得很对冲突检测和选课事务分离意味着你可以先单独跑算法测试再挂到接口上而不是每次改排课规则都要重启整个服务。前端部分学生端和管理端是两个独立的视图目录共用同一套 api 封装。学生端核心页面有三个选课大厅、我的课表、志愿填报管理端有课程管理、开课审核、选课结果导出。目录结构里没有多余的外层壳子拿过来就能定位到要改的文件。2.2 接口设计一套 REST 接口如何覆盖选课全流程系统对外暴露的接口不多但每个都对应一个明确的业务动作。我整理了一份核心接口清单二次开发时你会频繁跟它们打交道。方法路径作用关键参数POST/api/preference/submit提交选课志愿studentId, classIdList, priorityPOST/api/enrollment/select正式选课单班studentId, classIdDELETE/api/enrollment/{id}退课enrollmentIdGET/api/teaching/available查询某学生可选教学班studentId, semesterIdPOST/api/admin/enrollment/batch批量处理志愿管理员semesterId其中值得留意的是「查询可选教学班」这个接口。它不只是返回课程列表还会在返回前做两件事过滤掉学生已经选过的班级标注出与学生已有课表冲突的班级。这两个动作在接口层完成是为了让前端拿到数据后可以直接绘制课表不需要自己写时间重叠判断。批量处理志愿的接口是管理端独有的它把学生提交的志愿表统一读出来计算结果分成「已选」「候选」「落选」三种状态写回 enrollment 表是整个系统的收口动作。2.3 数据库设计五张核心表怎么支撑选课闭环数据库设计是这套系统里最值得看的部分。总共六张核心表学生表、教师表、课程表、教学班表、选课记录表、志愿表。课程与教学班分离是排课系统的关键——同一门课允许开多个班每个班绑定各自的教师、时间、教室和容量。冲突检测的对象不是课程而是教学班因为同一个课程代码在不同时间开课完全不冲突。表名关键字段作用studentid, grade_point, major学生基础信息与绩点courseid, name, credit, prerequisite_id课程定义含先修课teaching_classid, course_id, teacher_id, weekday, time_slot, room, capacity每个班的上课时间、教室与容量enrollmentid, student_id, class_id, status选课结果status 含已选/已退/候选preferenceid, student_id, class_id, priority学生志愿与优先级preference 表是整个「智能」二字的载体。学生提交的不是单个选课请求而是一组带优先级的志愿系统在选课开放后统一读取 preference 表按规则批量处理。这么做的好处是选课从「抢」变成了「等结果」服务器压力从峰值瞬间集中变成可控的批量计算。选课记录的 status 字段也很容易被忽略它不只是「已选」还包含「已退」「候选」。候选状态是为补选设计的如果有人退课系统会自动把候选名单里优先级最高的人补进去。数据库脚本在 sql 目录下建库后直接执行 schema.sql 和 init_data.sql 就能获得一批可演示的教学班数据。2.4 事务与并发为什么选课接口不能只加 synchronized最开始我拆这类项目时习惯性地以为选课就是「先查容量再 insert」。但容量检查和插入之间有时间差两个并发请求可能同时读到剩余名额为 1然后双双插入成功——超卖。这套系统的做法是三层防线数据库唯一索引、Redis 分布式锁、事务隔离级别。唯一索引防止同一学生重复选同一班分布式锁防止容量超卖事务保证状态变更要么全部成功要么全部回滚。这里要说清楚一个选择为什么用 Redis 分布式锁而不是数据库悲观锁因为选课接口内部还要做推荐计算和冲突检测整个操作耗时不短持锁时间太长用数据库行锁会把其他不相干的读写也拖住。另一个细节是 time_slot 的格式设计——它编码成「星期 节次」的离散枚举而不是时间戳。原因很简单时间戳做区间重叠判断需要复杂的条件拼接离散节次可以让冲突判断退化成位运算性能好一个量级。这个取舍在后面核心代码里能看到它带来的实际收益。3. 核心模块拆解一次选课请求从进入到返回的完整链路这一章是最值得看的部分。我选了三个点来讲冲突检测时间、教室、教师三个维度、志愿匹配算法评分排序、以及选课事务的完整链路。这三段代码基本覆盖了系统的核心逻辑也对应你在二次开发时最可能改的地方。3.1 冲突检测时间、教室、教师三类冲突一次算清冲突检测的核心对象是教学班。一个教学班包含 weekday星期几、time_slot第几节到第几节、room、teacher_id。判断两个班是否冲突最朴素的做法是逐对比较每个维度但这套系统用了一个技巧把时间槽位编码成二进制位图一个班的上课时间合并成一个 long冲突判断从多维字符串比较退化成位与运算。// 时间段冲突判断把 weekday 和 time_slot 编码成位图 public boolean isTimeConflict(TeachingClass a, TeachingClass b) { long aMap timeSlotToBitMap(a.getWeekday(), a.getStartSection(), a.getEndSection()); long bMap timeSlotToBitMap(b.getWeekday(), b.getStartSection(), b.getEndSection()); return (aMap bMap) ! 0L; } // 位图编码一天最多 12 节一周 7 天正好装进一个 long private long timeSlotToBitMap(int weekday, int startSection, int endSection) { long map 0L; int base weekday * 12; for (int i startSection; i endSection; i) { map | (1L (base i)); } return map; }这个方法把「星期几 第几节」映射到 long 的 84 个位上7 天 × 12 节两个班只要位与结果不为 0就说明存在重叠节次。参数里的 startSection 和 endSection 是闭区间比如第 3 节到第 4 节编码时循环会分别置位 3 和 4不会出现差一错误。教室冲突和教师冲突的判断逻辑更简单——直接比较教室 ID 和教师 ID 是否相同然后再加一个时间重叠的前置条件最终统一封装在一个 ConflictChecker 类里。这个类对外返回一个 ConflictReport 对象里面包含冲突类型TIME / ROOM / TEACHER和涉及的另一方名称。前端拿到这个报告后会在课表上用红框标出冲突的班级并提示具体是跟哪门课、哪个教室冲突。这个报告对象是二次开发时最容易扩展的地方你后续想加「校区冲突」「体育课特殊场地冲突」在这个类里加枚举值就行。3.2 志愿匹配绩点、先修课、教学评价怎么合成一个分数「智能」的核心在这个方法里。系统计算每个学生对每个志愿班的综合评分评分由三部分组成绩点权重、先修课达成度、课程的历史教学评价。评分之后按「志愿优先级 分数」双关键字排序高优先级且高分优先录取名额满了就进入候选队列。public int score(Student student, TeachingClass clazz, ListEnrollment history) { int score 0; // 绩点权重3.5 以上 303.0 以上 20其余 10 if (student.getGradePoint() 3.5) score 30; else if (student.getGradePoint() 3.0) score 20; else score 10; // 先修课达成已通过先修课加分没通过直接扣 50 并标记不可选 Course course courseService.getById(clazz.getCourseId()); if (course.getPrerequisiteId() ! null) { boolean pass history.stream() .anyMatch(e - e.getCourseId().equals(course.getPrerequisiteId()) PASS.equals(e.getStatus())); score pass ? 20 : -50; } // 教学评价从课程表冗余字段读取优秀课程 10 if (clazz.getRating() 4.5) score 10; return score; }这段代码的参数设计有讲究。绩点阈值、加分值都是常量在真实项目里这些值会被抽到配置表由教务在选课开始前调整。先修课没通过的惩罚值设得很高是为了保证评分排序时「不满足先修课」的学生几乎不可能靠志愿优先级翻盘。整个 score 方法没有副作用输入学生和班级状态输出一个整数非常容易写单元测试——这也是我建议你在二次开发时优先改这个方法的原因它好验证。这个评分方法在批量处理时会被反复调用性能上有一个优化点值得留意history 参数只需要查询一次在批处理外层加载好传给每个 score 调用复用避免每个班级都去查一次成绩表。源码里这个优化是做了的你在读代码时如果发现 score 方法被循环调用注意看上层是否用了局部缓存不要自己画蛇添足再加缓存把内存撑爆。3.3 选课事务分布式锁 唯一索引 状态机选课入口看起来只是一个普通接口但内部是完整的状态机。核心逻辑分为几步先获取 Redis 分布式锁锁内做容量校验、冲突校验、写入 enrollment 表最后释放锁。Transactional public Enrollment select(SelectRequest req) { String lockKey lock:class: req.getClassId(); boolean locked redisLock.tryLock(lockKey, 3, TimeUnit.SECONDS); if (!locked) { throw new BizException(当前选课人数过多请重试); } try { TeachingClass clazz teachingClassMapper.selectById(req.getClassId()); if (clazz.getEnrolledCount() clazz.getCapacity()) { throw new BizException(该教学班已满); } if (conflictChecker.hasAnyConflict(req.getStudentId(), req.getClassId())) { throw new BizException(存在时间/教室/教师冲突); } // 唯一索引 (student_id, class_id) 兜底防重 Enrollment enrollment new Enrollment(req.getStudentId(), req.getClassId(), SELECTED); enrollmentMapper.insert(enrollment); teachingClassMapper.increaseEnrolledCount(req.getClassId()); return enrollment; } finally { redisLock.unlock(lockKey); } }这里有几个值得注意的细节。tryLock 设置 3 秒超时防止学生在接口上一直等待锁的粒度是教学班而不是学生因为容量共享是核心竞争点教室和教师冲突通常不走锁。事务和锁的顺序也有讲究先 lock再进入 Transactional 方法保证从解锁到提交之间不会有新的读操作插进来看到中间状态。这是我在踩过「锁先释放、事务还没提交」的坑之后养成的习惯。退课操作是另一个容易写错的地方。它不只是删除一条记录先要关闭「已选」状态再触发候选补选。补选逻辑同样包在事务里并且用同一个分布式锁锁住教学班因为补选本质上也是写操作。Transactional public void dropEnrollment(Long enrollmentId) { Enrollment enrollment enrollmentMapper.selectById(enrollmentId); String lockKey lock:class: enrollment.getClassId(); redisLock.tryLock(lockKey, 3, TimeUnit.SECONDS); try { enrollment.setStatus(DROPPED); enrollmentMapper.updateById(enrollment); // 取出候选队列中优先级最高的学生直接补选 ListPreference candidates preferenceMapper .selectCandidates(enrollment.getClassId(), CANDIDATE); if (!candidates.isEmpty()) { Preference first candidates.get(0); Enrollment newEnrollment new Enrollment( first.getStudentId(), enrollment.getClassId(), SELECTED); enrollmentMapper.insert(newEnrollment); teachingClassMapper.increaseEnrolledCount(enrollment.getClassId()); } } finally { redisLock.unlock(lockKey); } }补选的时候有个性能问题需要注意如果候选人数很多每次退课都触发一次队列扫描压力不小。这套系统的做法是给 preference 表加一个状态字段batch 处理时把所有落选的人一次性标记成 CANDIDATE退课补选只取 statusCANDIDATE 的第一条按 priority 排序后取第一条。这样查询走索引补选是 O(1) 的量级不会因为候选人多而变慢。开发者如果自己从头写补选逻辑很容易写成「全表扫一遍找出最高优先级」数据量一上来就翻车这里的设计可以直接借鉴。4. 本地运行与避坑排查从零到能点开选课页面的完整流程这一章的目标是让你拿到源码后能在半小时内跑起来。流程分四步初始化数据库、启动 Redis、启动后端、启动前端。每一步都有对应的检查点失败时看日志定位。4.1 环境准备与数据库初始化需要 JDK 1.8、Maven 3.6、Node 16、MySQL 8.0、Redis 6。第一步先建库mysql -u root -p -e CREATE DATABASE smart_course DEFAULT CHARSET utf8mb4; mysql -u root -p smart_course sql/schema.sql mysql -u root -p smart_course sql/init_data.sqlinit_data.sql 里内置了 3 个学生账号、5 门课程、8 个教学班和一批志愿数据登录后能直接看到效果。如果执行脚本报错多半是 MySQL 版本太低或者字符集设置不对检查一下 sql 文件里是否有 utf8mb4 相关的 DDL以及你的 MySQL 是否支持。另外注意 init_data.sql 里有外键依赖建表脚本必须全量执行成功再导入数据跳步执行会报外键约束错误。4.2 启动后端与前端后端配置在 application.yml主要改三处数据库连接、Redis 地址、端口。默认端口 8080Redis 默认 localhost:6379。如果你本地的 MySQL 或 Redis 改了密码记得同步改这里连接池初始化失败是启动阶段最常见的报错。启动命令cd backend mvn spring-boot:run看到 Tomcat started on port(s): 8080 后后端就起来了。前端需要先安装依赖再启动 dev servercd frontend npm install npm run dev默认前端端口 5173通过 Vite 代理把 /api 转发到 8080所以本地不需要额外处理跨域。启动后访问 5173 端口用 init_data.sql 里内置的管理员账号登录管理端能看到课程管理和开课审核两个页面。学生账号登录后能看到选课大厅和志愿填报入口先提交一组志愿再用管理员账号跑一次 batch 处理能看到志愿状态从「待处理」变成「已选」或「候选」。4.3 常见问题与避坑记录这一部分是我在复现过程里遇到过的真实问题全部按「现象 → 原因 → 解决」整理你在跑的过程中如果卡住先对号入座。现象一后端启动报连接超时日志里出现 Failed to connect to Redis。直接原因通常是 Redis 没有启动或者 application.yml 里的地址写的是远程 IP 而本机没放通防火墙。解决方法是先本地启动 redis-server 确认 6379 端口正常再把地址改回 127.0.0.1排除网络因素后再接远程实例。这个报错信息本身带着完整的连接地址先看它连的是不是你以为的那个地址。现象二前端能打开页面但接口全部 404浏览器控制台能看到 /api/xxx 请求返回 index.html。原因是 Vite 代理没生效。检查 frontend/vite.config.ts 里的 proxy 配置target 必须是 http://127.0.0.1:8080同时确认后端启动端口没有被占用。如果后端改过端口两处要一起改只改一处就会看到这种页面能开、数据全空的诡异状态。现象三选课接口报「该教学班已满」但数据库里明显有空位。原因多半是 enroll_count 字段和实际记录数不一致。教学班的容量是冗余字段如果之前手动在数据库里删过 enrollment 记录enrolled_count 不会自动减。解决方法是写一条 SQL 把 enrolled_count 重算为实际数量或者直接重新执行 init_data.sql 做一次全新初始化不要手动改数手动改容易改出负数。现象四退课后候选补选不触发。原因是候选队列里根本没有状态为 CANDIDATE 的记录。批量处理志愿batch那一步如果没有跑所有落选者状态会是 UNPROCESSED而不是 CANDIDATE。先确认管理员后台执行过 batch 操作再查 preference 表的状态字段。这个问题容易让人误以为补选代码有 bug实际上只是数据状态没走到位。现象五并发压测时偶尔出现容量超卖检查日志发现分布式锁没有起作用。常见原因是两个节点用了不同的 Redis 库或不同的 key 前缀导致锁互不可见。需要确认所有实例连接的是同一个 Redis并且锁 key 规则一致不能一部分走 lock:class: 前缀另一部分走自定义前缀。分布式锁这种问题不会在单机测试时暴露只有压测或者多实例部署时才现形属于典型的「测试环境一切正常上线就翻车」。现象六MySQL 时区报错 The server time zone value CST is unrecognized。原因是 MySQL 8.0 的时区设置与 JDBC 驱动不一致。在 jdbc url 里加 serverTimezoneAsia/Shanghai 即可解决。这个问题无害但会挡住启动流程第一次跑时直接加好省得日志滚动刷屏干扰你排查别的错误。5. 二次开发三个值得动手的改造方向与验证技巧如果你准备拿这套系统做二次开发我建议从三个方向里挑一个动手不要一上来就重构整个选课流程。方向一最安全方向二涉及面大一些方向三对性能提升最明显。方向一把评分常量配置化。score 方法里的绩点阈值和加分值当前是硬编码的上线前教务肯定要调整。改造方式是新建一张 rule_config 表启动时加载到内存评分时从内存读验证方式是写一个参数化单元测试改变阈值后确认原先能选上的学生会被挤到候选区。这个改动不碰事务逻辑风险最低适合作为读代码的热身。方向二增加先修课硬校验。当前先修课只做加分和扣分并不会真正阻止选课。更严谨的改造是在选课事务里加一层硬校验如果未通过先修课直接抛异常不允许提交。要注意的是先修课的通过状态来自成绩表这块数据当前是模拟的改造时需要先确定成绩数据源。改完后记得在冲突报告里增加一种 PREREQUISITE 类型前端才能给出对应的提示文案。方向三把选课结果导出做成异步任务。当前管理端的导出接口是同步查询选课人数多的时候会卡住。改造思路是引入线程池把导出任务丢给后台生成 CSV完成后通过通知中心提醒管理员下载。验证时用较大数据量压一次导出接口确认接口在 2 秒内返回「任务已创建」而不是一直转圈。我的习惯是每改一个模块前先跑一遍该模块的单元测试确认基线是绿的改完再跑一遍对比破坏的地方。如果是涉及选课事务的改动就同时起两个客户端并发戳同一个教学班接口看会不会出现超卖。这套「先基线、再改造、最后并发验证」的流程帮我在这个项目上少走了很多弯路。从那以后我每次接手这类核心业务系统都强制先跑一遍基线测试再动代码这个习惯让我避开了好几次自以为改对了、一上线就出幺蛾子的局面。希望这篇文章能帮你在智能选课系统的源码里快速找到方向。本文还有配套的精品资源点击获取
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
