尧图网站建设 
简介这份资源是面向高校计算机专业学生与Java初学者的一份教室管理系统毕业设计文档针对传统教室管理效率低、数据资源浪费等问题给出了一套可参考的完整实现方案。文档围绕系统用户管理、楼层信息管理、校内新闻管理、教室信息管理以及登录退出等模块展开采用B/S结构与MVC三层设计模式配合MyEclipse编辑器与MySQL数据库完成开发并附有功能、性能与安全测试说明适合用作课程设计、毕业设计或Java Web入门练手项目。资源包共1个docx文件约1.07MB内容涵盖摘要、绪论、主要技术与工具介绍、系统设计与实现、数据库设计及测试等章节目录结构完整便于按章节查阅与二次修改。目前已有43人学习下载读者可从中获取需求分析思路、模块划分方式、MVC分层写法与MySQL建表参考快速搭建自己的教室管理项目框架。1. 教室管理系统为什么总在第二周崩从排课冲突说起开学第二周教务处电话被打爆——两个班同时被排进同一间教室教师端显示“已预约”学生端却查不到课表。这不是段子是绝大多数基于 Java 的教室管理系统在真实校园里翻车的固定剧本。标题里的“教室管理系统”听着像个课程设计作业但它真正要解决的是三件事教室资源的状态一致性、排课冲突的实时检测、以及多角色管理员/教师/学生对同一份数据的并发读写。用 Java 做这套系统主流选型是 Spring Boot MyBatis 走 MVC 分层MySQL 做持久化前端 B/S 架构浏览器直接访问不需要装客户端。适合谁看正在做课程设计但不想只交个能跑的 demo 的人以及接手了学校真实排课需求、需要一套能扛住开学高峰的轻量系统的开发者。下面按“先立住模型、再动手复现、最后避坑”的顺序拆开讲。2. 把教室、课程、时间段拆成三张表数据模型先立住2.1 为什么排课冲突的根因在表结构而不是在代码很多人一上来就写 Controller结果排课逻辑里塞了七八个 if-else 判断“这间教室这个时间段有没有被占”。这种写法在数据量小的时候能跑一旦教室上百间、课程上千条查询和判断就会变成灾难。正确的做法是把“冲突检测”下沉到数据库层用唯一约束和事务来兜底代码只负责业务编排。教室管理系统的核心实体其实只有三个教室Classroom、课程安排Schedule、用户User。关键在于 Schedule 表怎么设计。常见做法是把它设计成“一条记录代表一次占用”字段包括 classroom_id、week_day、section第几大节、weeks第几周到第几周、course_id、teacher_id。这样一条 SQL 就能查出某间教室在某天某节是否已被占用。提示不要把“周次”存成字符串如“1-16周”那会让后续按周查询变成全表扫描加字符串解析。用起始周和结束周两个 int 字段或者用位图存 20 周以内的占用情况。2.2 建表 SQL 与索引设计下面是我一般会用的建表语句注意唯一索引和普通索引的搭配-- 教室表 CREATE TABLE classroom ( id BIGINT PRIMARY KEY AUTO_INCREMENT, room_no VARCHAR(20) NOT NULL COMMENT 教室编号如 A101, building VARCHAR(50) NOT NULL COMMENT 教学楼, capacity INT NOT NULL DEFAULT 0 COMMENT 容纳人数, room_type TINYINT NOT NULL DEFAULT 0 COMMENT 0普通 1多媒体 2实验室, status TINYINT NOT NULL DEFAULT 1 COMMENT 1可用 0停用, UNIQUE KEY uk_room (building, room_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 排课表一条记录 一次占用 CREATE TABLE schedule ( id BIGINT PRIMARY KEY AUTO_INCREMENT, classroom_id BIGINT NOT NULL, course_id BIGINT NOT NULL, teacher_id BIGINT NOT NULL, week_day TINYINT NOT NULL COMMENT 1-7 周一到周日, section TINYINT NOT NULL COMMENT 1-5 第几大节, start_week TINYINT NOT NULL, end_week TINYINT NOT NULL, semester VARCHAR(20) NOT NULL COMMENT 如 2024-2025-1, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_room_time (classroom_id, semester, week_day, section), KEY idx_teacher (teacher_id, semester, week_day, section) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;逻辑说明idx_room_time这个联合索引是给“查某间教室某学期某天某节有没有课”用的字段顺序不能乱classroom_id 区分度最高放最前。idx_teacher同理用来检测教师时间冲突。参数上week_day 用 1-7 而不是 0-6是为了和大多数学校的排课习惯对齐减少前端转换。section 用 1-5 代表上午两大节、下午两大节、晚上一节具体节次划分各校不同但字段类型用 TINYINT 足够。为什么不直接加唯一约束UNIQUE(classroom_id, semester, week_day, section)因为同一间教室在同一时间段可能因为单双周不同而安排不同课程。如果学校没有单双周需求加上这个唯一约束是最省事的防冲突手段。有单双周的话就得在应用层用事务加锁来保证。2.3 冲突检测的 SQL 怎么写才不翻车排课时最核心的一步是检测冲突。下面这条 SQL 同时检测教室冲突和教师冲突SELECT COUNT(*) FROM schedule WHERE semester #{semester} AND week_day #{weekDay} AND section #{section} AND (classroom_id #{classroomId} OR teacher_id #{teacherId}) AND NOT (end_week #{startWeek} OR start_week #{endWeek})逻辑说明最后那个NOT (end_week startWeek OR start_week endWeek)是判断两个周次区间是否重叠的标准写法。如果新排课的周次区间和已有记录完全不重叠说明不冲突。参数上startWeek 和 endWeek 由前端传入后端要校验 startWeek endWeek 且都在 1-20 范围内。这条 SQL 返回 0 才能插入返回大于 0 就说明冲突需要给前端返回具体冲突的教室或教师。注意这条 SQL 在高并发下仍有竞态条件——两个请求同时查到 0 然后同时插入。解决办法是在插入时用INSERT ... SELECT ... WHERE NOT EXISTS或者对 classroom_id 加行锁。课程设计级别用前者就够真实系统建议用 Redis 分布式锁按教室维度加锁。3. 用 Spring Boot MyBatis 搭 MVC 骨架从启动到第一个接口3.1 项目结构和依赖怎么定MVC 分层在 Spring Boot 里的落地就是 Controller → Service → Mapper → MySQL。目录结构我一般这样组织src/main/java/com/example/classroom/ ├── controller/ // 接收请求参数校验 ├── service/ // 业务逻辑事务边界 │ └── impl/ ├── mapper/ // MyBatis 接口 ├── entity/ // 数据库实体 ├── dto/ // 请求/响应对象 └── common/ // 统一返回、异常处理pom.xml 核心依赖就四个spring-boot-starter-web、mybatis-spring-boot-starter、mysql-connector-java、lombok。版本上 Spring Boot 用 2.7.x 或 3.x 都行但 3.x 要求 Java 17课程设计环境如果还是 JDK 8 就选 2.7.x。MySQL 驱动 8.x 对应 MySQL 8.05.7 的库用 5.1.x 驱动也能连但建议统一用 8.x 驱动加allowPublicKeyRetrievaltrue参数。dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.1/version /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependencyapplication.yml 里 datasource 配置注意时区和编码spring: datasource: url: jdbc:mysql://localhost:3306/classroom?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: truemap-underscore-to-camel-case: true这个配置能省掉大量 resultMap 手写映射room_no 自动映射到 roomNo。serverTimezone不配的话 MySQL 8 会报时区错误这是新手最常见的翻车点之一。3.2 排课接口的完整实现Controller 层只做参数接收和返回封装RestController RequestMapping(/api/schedule) public class ScheduleController { Autowired private ScheduleService scheduleService; PostMapping(/add) public Result add(RequestBody Valid ScheduleDTO dto) { // 参数校验由 Valid 完成业务异常由全局处理器兜底 scheduleService.addSchedule(dto); return Result.ok(); } }Service 层是事务和冲突检测的核心Service public class ScheduleServiceImpl implements ScheduleService { Autowired private ScheduleMapper scheduleMapper; Override Transactional(rollbackFor Exception.class) public void addSchedule(ScheduleDTO dto) { // 1. 基础校验周次范围、节次范围 if (dto.getStartWeek() dto.getEndWeek()) { throw new BizException(起始周不能大于结束周); } // 2. 冲突检测 int conflict scheduleMapper.countConflict(dto); if (conflict 0) { throw new BizException(该时间段教室或教师已被占用); } // 3. 插入 scheduleMapper.insert(dto); } }逻辑说明Transactional保证冲突检测和插入在同一个事务里配合数据库的隔离级别MySQL 默认 REPEATABLE READ能在一定程度上防止并发插入。但如前所述高并发下仍需额外锁。参数上rollbackFor Exception.class确保任何异常都回滚不加的话默认只回滚 RuntimeException。Mapper XML 里对应 countConflict 的 SQL 就是 2.3 节那条。insert 用useGeneratedKeystrue keyPropertyid回填主键。3.3 查询课表的接口与分页查询接口要考虑按教室、按教师、按班级三个维度。我一般做成一个通用查询用动态 SQL 拼条件select idlistSchedule resultTypeScheduleVO SELECT s.*, c.room_no, c.building, co.course_name, t.teacher_name FROM schedule s JOIN classroom c ON s.classroom_id c.id JOIN course co ON s.course_id co.id JOIN teacher t ON s.teacher_id t.id WHERE s.semester #{semester} if testclassroomId ! null AND s.classroom_id #{classroomId} /if if testteacherId ! null AND s.teacher_id #{teacherId} /if if testweekDay ! null AND s.week_day #{weekDay} /if ORDER BY s.week_day, s.section /select逻辑说明用 JOIN 一次性把教室名、课程名、教师名查出来避免前端拿到 id 再逐个请求。参数上semester 是必传的其他条件可选。分页的话课程设计级别用 PageHelper 插件最省事真实系统建议用游标分页避免深分页性能问题。4. 排课冲突、并发写入、时区错乱三个必踩的坑4.1 现象两个请求同时排课数据库里出现两条冲突记录原因冲突检测和插入之间存在时间窗口两个线程都查到 0 然后都插入。这是典型的 check-then-act 竞态。解决三种方案按场景选。课程设计用INSERT ... SELECT ... WHERE NOT EXISTS一条 SQL 搞定把检测和插入合并INSERT INTO schedule (classroom_id, course_id, teacher_id, week_day, section, start_week, end_week, semester) SELECT #{classroomId}, #{courseId}, #{teacherId}, #{weekDay}, #{section}, #{startWeek}, #{endWeek}, #{semester} FROM DUAL WHERE NOT EXISTS ( SELECT 1 FROM schedule WHERE semester #{semester} AND week_day #{weekDay} AND section #{section} AND (classroom_id #{classroomId} OR teacher_id #{teacherId}) AND NOT (end_week #{startWeek} OR start_week #{endWeek}) )真实系统用 Redis 按 classroom_id 加分布式锁锁超时设 3 秒。再狠一点就在 schedule 表上加唯一索引让数据库直接拒绝。4.2 现象MySQL 8 连接报The server time zone value ?D1ú±ê×?ê±?? is unrecognized原因MySQL 8 的时区默认是系统时区Windows 中文环境下会返回乱码时区名JDBC 驱动解析不了。解决连接串加serverTimezoneAsia/Shanghai。如果还报错检查 MySQL 的default-time-zone参数用SET GLOBAL time_zone 8:00临时改或者改 my.ini 永久生效。这个坑和 MySQL 安装配置教程里反复出现的问题是同一个根因。4.3 现象教师端查到的课表比实际少一节课原因查询时用了WHERE week_day #{weekDay}但前端传的是字符串 1MySQL 隐式转换后索引失效加上如果有LIMIT分页可能漏数据。解决DTO 里 weekDay 用 Integer 类型Controller 加Valid校验范围 1-7。另外检查 MyBatis 的map-underscore-to-camel-case是否生效没生效的话room_no映射不到roomNo前端拿到 null 会显示空白看起来像“少了一节课”。4.4 现象删除教室后关联的排课记录变成孤儿数据原因外键约束没加或者加了但删除时没级联。解决classroom 表被 schedule 引用删除教室前先检查是否有未结束的排课。我一般用软删除classroom 加is_deleted字段删除时只改标记查询时过滤。这样历史排课记录还能关联到教室信息不会出现“教室不存在”的报错。4.5 现象前端传的日期格式后端解析报 400原因Spring Boot 默认不支持yyyy-MM-dd格式的字符串转 LocalDate需要额外配置。解决DTO 字段上加JsonFormat(pattern yyyy-MM-dd)或者全局配置spring.jackson.date-format。如果用的是DateTimeFormat那是 Spring MVC 的参数绑定注解和 Jackson 的JsonFormat适用场景不同RequestBody 用后者RequestParam 用前者。5. 让系统从能跑到好用三个进阶技巧5.1 用数据库视图简化课表查询排课系统最复杂的查询是“查某间教室一周的课表”需要把 schedule 按 week_day 和 section 透视成二维表。与其在 Java 里拼不如建一个视图CREATE VIEW v_room_timetable AS SELECT c.id AS classroom_id, c.room_no, s.week_day, s.section, s.start_week, s.end_week, co.course_name, t.teacher_name FROM schedule s JOIN classroom c ON s.classroom_id c.id JOIN course co ON s.course_id co.id JOIN teacher t ON s.teacher_id t.id WHERE c.status 1;然后查询时按 classroom_id 和 semester 过滤Java 层只需要把结果按 week_day 分组塞进一个二维数组。这样 SQL 简单缓存也好做——同一间教室的课表在学期内基本不变可以缓存 10 分钟。5.2 用 AOP 记录排课操作日志教室管理系统在真实场景里需要审计谁在什么时候改了哪条排课记录。用 Spring AOP 加自定义注解最优雅Aspect Component public class ScheduleLogAspect { Autowired private LogMapper logMapper; Around(annotation(scheduleLog)) public Object log(ProceedingJoinPoint pjp, ScheduleLog scheduleLog) throws Throwable { Object result pjp.proceed(); // 从参数里提取操作类型和对象 id ScheduleDTO dto (ScheduleDTO) pjp.getArgs()[0]; logMapper.insert(new LogDO(排课, dto.getClassroomId(), new Date())); return result; } }逻辑说明Around在方法执行后记录日志如果方法抛异常则不记录或者按需记录失败日志。参数上annotation(scheduleLog)绑定自定义注解注解里可以定义操作类型。这个方案比在每个 Service 方法里手写 log 代码干净得多。5.3 用定时任务自动清理过期排课每学期结束后上学期的排课记录不应该再出现在默认查询里。与其每次查询都加semester 当前学期不如用一个定时任务把过期数据归档Component public class ArchiveTask { Autowired private ScheduleMapper scheduleMapper; // 每月1号凌晨2点执行 Scheduled(cron 0 0 2 1 * ?) public void archive() { String currentSemester SemesterUtil.current(); // 把非当前学期的记录移到历史表 scheduleMapper.moveToHistory(currentSemester); } }逻辑说明Scheduled的 cron 表达式0 0 2 1 * ?表示每月 1 号凌晨 2 点。参数上SemesterUtil.current()根据当前日期算出学期字符串比如 9 月到次年 1 月是2024-2025-1。归档用INSERT INTO schedule_history SELECT ... WHERE semester ! #{current}再DELETE放在同一个事务里。注意定时任务在集群环境下会重复执行课程设计单机没问题多实例部署要加分布式锁或者用 Quartz 的集群模式。5.4 验证系统是否真的扛住了并发最后说一个验证方法用 JMeter 或 wrk 对排课接口发 50 个并发请求全部排同一间教室同一时间段看最终数据库里有几条记录。正确结果应该是 1 条成功、49 条返回冲突。如果出现 2 条以上说明竞态没解决。这个测试比任何单元测试都直接我每次改完冲突检测逻辑都会跑一遍。血泪经验是不要相信“我加了事务就没问题”这种话事务的隔离级别和锁范围不搞清楚并发问题照样出。教室管理系统这种读多写少的场景把冲突检测做扎实比加一堆缓存和消息队列都管用。希望帮到你。本文还有配套的精品资源点击获取 Java教室管理系统实战：排课冲突检测与并发写入避坑指南
简介这份资源是面向高校计算机专业学生与Java初学者的一份教室管理系统毕业设计文档针对传统教室管理效率低、数据资源浪费等问题给出了一套可参考的完整实现方案。文档围绕系统用户管理、楼层信息管理、校内新闻管理、教室信息管理以及登录退出等模块展开采用B/S结构与MVC三层设计模式配合MyEclipse编辑器与MySQL数据库完成开发并附有功能、性能与安全测试说明适合用作课程设计、毕业设计或Java Web入门练手项目。资源包共1个docx文件约1.07MB内容涵盖摘要、绪论、主要技术与工具介绍、系统设计与实现、数据库设计及测试等章节目录结构完整便于按章节查阅与二次修改。目前已有43人学习下载读者可从中获取需求分析思路、模块划分方式、MVC分层写法与MySQL建表参考快速搭建自己的教室管理项目框架。1. 教室管理系统为什么总在第二周崩从排课冲突说起开学第二周教务处电话被打爆——两个班同时被排进同一间教室教师端显示“已预约”学生端却查不到课表。这不是段子是绝大多数基于 Java 的教室管理系统在真实校园里翻车的固定剧本。标题里的“教室管理系统”听着像个课程设计作业但它真正要解决的是三件事教室资源的状态一致性、排课冲突的实时检测、以及多角色管理员/教师/学生对同一份数据的并发读写。用 Java 做这套系统主流选型是 Spring Boot MyBatis 走 MVC 分层MySQL 做持久化前端 B/S 架构浏览器直接访问不需要装客户端。适合谁看正在做课程设计但不想只交个能跑的 demo 的人以及接手了学校真实排课需求、需要一套能扛住开学高峰的轻量系统的开发者。下面按“先立住模型、再动手复现、最后避坑”的顺序拆开讲。2. 把教室、课程、时间段拆成三张表数据模型先立住2.1 为什么排课冲突的根因在表结构而不是在代码很多人一上来就写 Controller结果排课逻辑里塞了七八个 if-else 判断“这间教室这个时间段有没有被占”。这种写法在数据量小的时候能跑一旦教室上百间、课程上千条查询和判断就会变成灾难。正确的做法是把“冲突检测”下沉到数据库层用唯一约束和事务来兜底代码只负责业务编排。教室管理系统的核心实体其实只有三个教室Classroom、课程安排Schedule、用户User。关键在于 Schedule 表怎么设计。常见做法是把它设计成“一条记录代表一次占用”字段包括 classroom_id、week_day、section第几大节、weeks第几周到第几周、course_id、teacher_id。这样一条 SQL 就能查出某间教室在某天某节是否已被占用。提示不要把“周次”存成字符串如“1-16周”那会让后续按周查询变成全表扫描加字符串解析。用起始周和结束周两个 int 字段或者用位图存 20 周以内的占用情况。2.2 建表 SQL 与索引设计下面是我一般会用的建表语句注意唯一索引和普通索引的搭配-- 教室表 CREATE TABLE classroom ( id BIGINT PRIMARY KEY AUTO_INCREMENT, room_no VARCHAR(20) NOT NULL COMMENT 教室编号如 A101, building VARCHAR(50) NOT NULL COMMENT 教学楼, capacity INT NOT NULL DEFAULT 0 COMMENT 容纳人数, room_type TINYINT NOT NULL DEFAULT 0 COMMENT 0普通 1多媒体 2实验室, status TINYINT NOT NULL DEFAULT 1 COMMENT 1可用 0停用, UNIQUE KEY uk_room (building, room_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 排课表一条记录 一次占用 CREATE TABLE schedule ( id BIGINT PRIMARY KEY AUTO_INCREMENT, classroom_id BIGINT NOT NULL, course_id BIGINT NOT NULL, teacher_id BIGINT NOT NULL, week_day TINYINT NOT NULL COMMENT 1-7 周一到周日, section TINYINT NOT NULL COMMENT 1-5 第几大节, start_week TINYINT NOT NULL, end_week TINYINT NOT NULL, semester VARCHAR(20) NOT NULL COMMENT 如 2024-2025-1, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_room_time (classroom_id, semester, week_day, section), KEY idx_teacher (teacher_id, semester, week_day, section) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;逻辑说明idx_room_time这个联合索引是给“查某间教室某学期某天某节有没有课”用的字段顺序不能乱classroom_id 区分度最高放最前。idx_teacher同理用来检测教师时间冲突。参数上week_day 用 1-7 而不是 0-6是为了和大多数学校的排课习惯对齐减少前端转换。section 用 1-5 代表上午两大节、下午两大节、晚上一节具体节次划分各校不同但字段类型用 TINYINT 足够。为什么不直接加唯一约束UNIQUE(classroom_id, semester, week_day, section)因为同一间教室在同一时间段可能因为单双周不同而安排不同课程。如果学校没有单双周需求加上这个唯一约束是最省事的防冲突手段。有单双周的话就得在应用层用事务加锁来保证。2.3 冲突检测的 SQL 怎么写才不翻车排课时最核心的一步是检测冲突。下面这条 SQL 同时检测教室冲突和教师冲突SELECT COUNT(*) FROM schedule WHERE semester #{semester} AND week_day #{weekDay} AND section #{section} AND (classroom_id #{classroomId} OR teacher_id #{teacherId}) AND NOT (end_week #{startWeek} OR start_week #{endWeek})逻辑说明最后那个NOT (end_week startWeek OR start_week endWeek)是判断两个周次区间是否重叠的标准写法。如果新排课的周次区间和已有记录完全不重叠说明不冲突。参数上startWeek 和 endWeek 由前端传入后端要校验 startWeek endWeek 且都在 1-20 范围内。这条 SQL 返回 0 才能插入返回大于 0 就说明冲突需要给前端返回具体冲突的教室或教师。注意这条 SQL 在高并发下仍有竞态条件——两个请求同时查到 0 然后同时插入。解决办法是在插入时用INSERT ... SELECT ... WHERE NOT EXISTS或者对 classroom_id 加行锁。课程设计级别用前者就够真实系统建议用 Redis 分布式锁按教室维度加锁。3. 用 Spring Boot MyBatis 搭 MVC 骨架从启动到第一个接口3.1 项目结构和依赖怎么定MVC 分层在 Spring Boot 里的落地就是 Controller → Service → Mapper → MySQL。目录结构我一般这样组织src/main/java/com/example/classroom/ ├── controller/ // 接收请求参数校验 ├── service/ // 业务逻辑事务边界 │ └── impl/ ├── mapper/ // MyBatis 接口 ├── entity/ // 数据库实体 ├── dto/ // 请求/响应对象 └── common/ // 统一返回、异常处理pom.xml 核心依赖就四个spring-boot-starter-web、mybatis-spring-boot-starter、mysql-connector-java、lombok。版本上 Spring Boot 用 2.7.x 或 3.x 都行但 3.x 要求 Java 17课程设计环境如果还是 JDK 8 就选 2.7.x。MySQL 驱动 8.x 对应 MySQL 8.05.7 的库用 5.1.x 驱动也能连但建议统一用 8.x 驱动加allowPublicKeyRetrievaltrue参数。dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.1/version /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependencyapplication.yml 里 datasource 配置注意时区和编码spring: datasource: url: jdbc:mysql://localhost:3306/classroom?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: truemap-underscore-to-camel-case: true这个配置能省掉大量 resultMap 手写映射room_no 自动映射到 roomNo。serverTimezone不配的话 MySQL 8 会报时区错误这是新手最常见的翻车点之一。3.2 排课接口的完整实现Controller 层只做参数接收和返回封装RestController RequestMapping(/api/schedule) public class ScheduleController { Autowired private ScheduleService scheduleService; PostMapping(/add) public Result add(RequestBody Valid ScheduleDTO dto) { // 参数校验由 Valid 完成业务异常由全局处理器兜底 scheduleService.addSchedule(dto); return Result.ok(); } }Service 层是事务和冲突检测的核心Service public class ScheduleServiceImpl implements ScheduleService { Autowired private ScheduleMapper scheduleMapper; Override Transactional(rollbackFor Exception.class) public void addSchedule(ScheduleDTO dto) { // 1. 基础校验周次范围、节次范围 if (dto.getStartWeek() dto.getEndWeek()) { throw new BizException(起始周不能大于结束周); } // 2. 冲突检测 int conflict scheduleMapper.countConflict(dto); if (conflict 0) { throw new BizException(该时间段教室或教师已被占用); } // 3. 插入 scheduleMapper.insert(dto); } }逻辑说明Transactional保证冲突检测和插入在同一个事务里配合数据库的隔离级别MySQL 默认 REPEATABLE READ能在一定程度上防止并发插入。但如前所述高并发下仍需额外锁。参数上rollbackFor Exception.class确保任何异常都回滚不加的话默认只回滚 RuntimeException。Mapper XML 里对应 countConflict 的 SQL 就是 2.3 节那条。insert 用useGeneratedKeystrue keyPropertyid回填主键。3.3 查询课表的接口与分页查询接口要考虑按教室、按教师、按班级三个维度。我一般做成一个通用查询用动态 SQL 拼条件select idlistSchedule resultTypeScheduleVO SELECT s.*, c.room_no, c.building, co.course_name, t.teacher_name FROM schedule s JOIN classroom c ON s.classroom_id c.id JOIN course co ON s.course_id co.id JOIN teacher t ON s.teacher_id t.id WHERE s.semester #{semester} if testclassroomId ! null AND s.classroom_id #{classroomId} /if if testteacherId ! null AND s.teacher_id #{teacherId} /if if testweekDay ! null AND s.week_day #{weekDay} /if ORDER BY s.week_day, s.section /select逻辑说明用 JOIN 一次性把教室名、课程名、教师名查出来避免前端拿到 id 再逐个请求。参数上semester 是必传的其他条件可选。分页的话课程设计级别用 PageHelper 插件最省事真实系统建议用游标分页避免深分页性能问题。4. 排课冲突、并发写入、时区错乱三个必踩的坑4.1 现象两个请求同时排课数据库里出现两条冲突记录原因冲突检测和插入之间存在时间窗口两个线程都查到 0 然后都插入。这是典型的 check-then-act 竞态。解决三种方案按场景选。课程设计用INSERT ... SELECT ... WHERE NOT EXISTS一条 SQL 搞定把检测和插入合并INSERT INTO schedule (classroom_id, course_id, teacher_id, week_day, section, start_week, end_week, semester) SELECT #{classroomId}, #{courseId}, #{teacherId}, #{weekDay}, #{section}, #{startWeek}, #{endWeek}, #{semester} FROM DUAL WHERE NOT EXISTS ( SELECT 1 FROM schedule WHERE semester #{semester} AND week_day #{weekDay} AND section #{section} AND (classroom_id #{classroomId} OR teacher_id #{teacherId}) AND NOT (end_week #{startWeek} OR start_week #{endWeek}) )真实系统用 Redis 按 classroom_id 加分布式锁锁超时设 3 秒。再狠一点就在 schedule 表上加唯一索引让数据库直接拒绝。4.2 现象MySQL 8 连接报The server time zone value ?D1ú±ê×?ê±?? is unrecognized原因MySQL 8 的时区默认是系统时区Windows 中文环境下会返回乱码时区名JDBC 驱动解析不了。解决连接串加serverTimezoneAsia/Shanghai。如果还报错检查 MySQL 的default-time-zone参数用SET GLOBAL time_zone 8:00临时改或者改 my.ini 永久生效。这个坑和 MySQL 安装配置教程里反复出现的问题是同一个根因。4.3 现象教师端查到的课表比实际少一节课原因查询时用了WHERE week_day #{weekDay}但前端传的是字符串 1MySQL 隐式转换后索引失效加上如果有LIMIT分页可能漏数据。解决DTO 里 weekDay 用 Integer 类型Controller 加Valid校验范围 1-7。另外检查 MyBatis 的map-underscore-to-camel-case是否生效没生效的话room_no映射不到roomNo前端拿到 null 会显示空白看起来像“少了一节课”。4.4 现象删除教室后关联的排课记录变成孤儿数据原因外键约束没加或者加了但删除时没级联。解决classroom 表被 schedule 引用删除教室前先检查是否有未结束的排课。我一般用软删除classroom 加is_deleted字段删除时只改标记查询时过滤。这样历史排课记录还能关联到教室信息不会出现“教室不存在”的报错。4.5 现象前端传的日期格式后端解析报 400原因Spring Boot 默认不支持yyyy-MM-dd格式的字符串转 LocalDate需要额外配置。解决DTO 字段上加JsonFormat(pattern yyyy-MM-dd)或者全局配置spring.jackson.date-format。如果用的是DateTimeFormat那是 Spring MVC 的参数绑定注解和 Jackson 的JsonFormat适用场景不同RequestBody 用后者RequestParam 用前者。5. 让系统从能跑到好用三个进阶技巧5.1 用数据库视图简化课表查询排课系统最复杂的查询是“查某间教室一周的课表”需要把 schedule 按 week_day 和 section 透视成二维表。与其在 Java 里拼不如建一个视图CREATE VIEW v_room_timetable AS SELECT c.id AS classroom_id, c.room_no, s.week_day, s.section, s.start_week, s.end_week, co.course_name, t.teacher_name FROM schedule s JOIN classroom c ON s.classroom_id c.id JOIN course co ON s.course_id co.id JOIN teacher t ON s.teacher_id t.id WHERE c.status 1;然后查询时按 classroom_id 和 semester 过滤Java 层只需要把结果按 week_day 分组塞进一个二维数组。这样 SQL 简单缓存也好做——同一间教室的课表在学期内基本不变可以缓存 10 分钟。5.2 用 AOP 记录排课操作日志教室管理系统在真实场景里需要审计谁在什么时候改了哪条排课记录。用 Spring AOP 加自定义注解最优雅Aspect Component public class ScheduleLogAspect { Autowired private LogMapper logMapper; Around(annotation(scheduleLog)) public Object log(ProceedingJoinPoint pjp, ScheduleLog scheduleLog) throws Throwable { Object result pjp.proceed(); // 从参数里提取操作类型和对象 id ScheduleDTO dto (ScheduleDTO) pjp.getArgs()[0]; logMapper.insert(new LogDO(排课, dto.getClassroomId(), new Date())); return result; } }逻辑说明Around在方法执行后记录日志如果方法抛异常则不记录或者按需记录失败日志。参数上annotation(scheduleLog)绑定自定义注解注解里可以定义操作类型。这个方案比在每个 Service 方法里手写 log 代码干净得多。5.3 用定时任务自动清理过期排课每学期结束后上学期的排课记录不应该再出现在默认查询里。与其每次查询都加semester 当前学期不如用一个定时任务把过期数据归档Component public class ArchiveTask { Autowired private ScheduleMapper scheduleMapper; // 每月1号凌晨2点执行 Scheduled(cron 0 0 2 1 * ?) public void archive() { String currentSemester SemesterUtil.current(); // 把非当前学期的记录移到历史表 scheduleMapper.moveToHistory(currentSemester); } }逻辑说明Scheduled的 cron 表达式0 0 2 1 * ?表示每月 1 号凌晨 2 点。参数上SemesterUtil.current()根据当前日期算出学期字符串比如 9 月到次年 1 月是2024-2025-1。归档用INSERT INTO schedule_history SELECT ... WHERE semester ! #{current}再DELETE放在同一个事务里。注意定时任务在集群环境下会重复执行课程设计单机没问题多实例部署要加分布式锁或者用 Quartz 的集群模式。5.4 验证系统是否真的扛住了并发最后说一个验证方法用 JMeter 或 wrk 对排课接口发 50 个并发请求全部排同一间教室同一时间段看最终数据库里有几条记录。正确结果应该是 1 条成功、49 条返回冲突。如果出现 2 条以上说明竞态没解决。这个测试比任何单元测试都直接我每次改完冲突检测逻辑都会跑一遍。血泪经验是不要相信“我加了事务就没问题”这种话事务的隔离级别和锁范围不搞清楚并发问题照样出。教室管理系统这种读多写少的场景把冲突检测做扎实比加一堆缓存和消息队列都管用。希望帮到你。本文还有配套的精品资源点击获取