简介这份资源是一篇基于 Spring Boot 与微信小程序的高校教室预约管理系统毕业论文面向计算机相关专业的本科毕业生、课程设计者以及需要完成类似选题的开发者可用于参考选题思路、系统分析与论文写作框架。压缩包内含 1 个 doc 文档约 4.65MB内容按摘要、绪论、开发工具及关键技术介绍、系统分析等章节组织中英文摘要与目录齐全便于直接对照结构与行文规范。论文围绕微信小程序、Spring Boot 框架、MySQL 数据库和 Java 语言展开涵盖需求与可行性分析、功能模块与界面设计、数据库表结构与索引设计、后端接口开发并讨论了系统后期的维护、升级与安全等可操作性问题。目前已有 132 人学习浏览适合作为教室预约、场地管理等同类课题的参考范本帮助读者理清从需求分析到数据库与后端实现的完整链路也可作为论文排版与章节撰写的借鉴材料。1. 从一张被重复占用的教室排期表说起校园项目里最常见的事故是教务老师打开后台发现同一间 A305 在周三第 3-4 节挂着三条预约记录三个学生都收到了预约成功。问题往往不在页面而在于把查一次有没有冲突、没有就插入写成了两段互不相干的操作两个人同时提交就会各自查到没冲突。这份 springboot 基于微信小程序的高校教室预约管理系统论文 源码正好踩在这类真实痛点上管理员服务端负责监测员管理、教室类型、教室信息、课室大门、课室窗帘、课室用电、充电提醒与留言板监测员微信端负责查教室、看设备状态、提交和取消预约论文里的监测员就是小程序端的普通用户通常是学生或值班巡检人员。它适合正在做基于 Spring Boot 的 Java 毕设、想把小程序和 Java 后端彻底跑通一遍的人也适合已经写过 CRUD、但没认真处理过并发预约与状态流转的人拿来对照自己的实现。2. 拆开目录看技术栈Spring Boot 分层、小程序双端职责与开发环境2.1 为什么这套毕设用 Spring Boot 而不是原生 SSM论文里给 Spring Boot 列了六条优势真正站得住的是两条起步依赖把内嵌 Tomcat、Jackson、日志、数据源一起打包进来不用再维护 web.xml 和一堆 XML以及自动装配。自动装配的机制不复杂SpringBootApplication里藏着EnableAutoConfiguration它读取依赖包里的候选配置类再由ConditionalOnClass、ConditionalOnMissingBean这类条件注解筛选只有类路径上确实存在对应依赖、并且你没有自己定义 Bean 时才生效。理解这一层后面遇到依赖加了但配置没生效就不会乱猜。用 IDEA 创建项目的顺序我一般这么走New Project → Spring InitializrServer URL 保持默认Group 填com.exampleArtifact 填classroomType 选 MavenJDK 选 17依赖勾 Spring Web、MySQL Driver、LombokMyBatis-Plus 不在官方列表里生成后手动加先跑一遍空项目确认 8080 能起来再往里填业务代码。JDK 这一步最容易翻车。Spring Boot 3.x 的最低要求是 JDK 17如果本机只有 JDK 8只能把版本压到 2.7.x很多人嘴里说的springboot 版本太高跑不起来根源就在这里而不是 Maven 下载失败。dependencies !-- Web 层内嵌 Tomcat Spring MVC -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- 持久层MyBatis-Plus 省掉单表 CRUD 的 XML -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.5/version /dependency !-- 驱动8.x 驱动类名为 com.mysql.cj.jdbc.Driver -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency !-- 参数校验NotNull、Min 等注解生效 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependency /dependencies三个依赖各管一段starter-web 提供 MVC 和序列化MyBatis-Plus 负责把实体映射成 SQLvalidation 负责在 Controller 入参上拦掉明显非法的请求。scope为 runtime 表示编译期不需要驱动类只在运行时加载这样换数据库驱动不用改代码。2.2 小程序端目录结构与双端职责划分小程序框架分逻辑层和视图层逻辑层跑在 JSCore 里写Page({})、App({})视图层是 WXML WXSS由 WebView 渲染。两层之间靠setData通信逻辑层改数据、视图层跟着更新所以不要在setData里塞整个大对象教室列表几百条一次性传会明显掉帧分页取、按需传才是正常做法。微信开发者工具的用法论文里列了一长串常用的其实就编译预览、控制台调试、真机远程调试、上传代码四件事。需要注意代码体积限制在 2M 以内教室封面图这类静态资源别直接打进包里走对象存储或后端静态目录。端模块主要操作落库表管理员服务端监测员管理增删改用户、重置密码、分配角色sys_user管理员服务端教室信息管理维护编号、教学楼、类型、座位数classroom、classroom_type管理员服务端设备监测管理记录大门、窗帘、用电、充电提醒状态device_record管理员服务端预约审核通过或驳回预约单reservation监测员微信端首页、教室信息按教学楼和日期筛可用教室classroom监测员微信端课室大门、课室用电查看设备当前状态device_record监测员微信端我的我的预约、取消预约reservation{ pages: [ pages/index/index, pages/classroom/list, pages/reservation/submit, pages/reservation/mine, pages/mine/mine ], window: { navigationBarTitleText: 教室预约, navigationBarBackgroundColor: #ffffff, navigationStyle: custom, backgroundColor: #f5f6f8 }, networkTimeout: { request: 10000 } }pages的第一项就是冷启动页navigationStyle设为custom表示自绘导航栏页面里要自己留状态栏高度这一点在第 5 章会算networkTimeout.request建议显式写成 10 秒默认值更长弱网下用户会以为按钮没反应而反复点。2.3 后端配置与本地起服务server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/classroom_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 mybatis-plus: configuration: map-underscore-to-camel-case: true global-config: db-config: id-type: autoserverTimezone和time-zone必须同时指定只写一个会出现入库时间比实际早 8 小时allowPublicKeyRetrievaltrue是 MySQL 8 用 caching_sha2_password 认证时本地连接的常见补丁map-underscore-to-camel-case打开后room_no才会自动映射到roomNo不开就是一片 null。3. 教室预约的数据建模从 ER 图落到 InnoDB 建表语句3.1 三类实体怎么切表论文的 ER 图给了监测员信息、教室信息、课室大门、课室窗帘、课室用电五张实体属性图。落地时最常见的偷懒做法是给大门、窗帘、用电各建一张结构几乎一样的表字段都是监测账号、教室编号、监测类型、状态、备注、记录时间。我一般合成一张device_record用device_type区分 1大门、2窗帘、3用电、4充电提醒用电表额外的电量监测字段就放在通用ext_value里。这样新增一类设备不用动表结构查询某间教室的全部设备状态也只需要一条 SQL。3.2 核心表建表语句CREATE TABLE classroom ( id bigint NOT NULL AUTO_INCREMENT COMMENT 教室主键, room_no varchar(20) NOT NULL COMMENT 教室编号如 A305, building varchar(50) NOT NULL COMMENT 教学楼名称, type_id bigint NOT NULL COMMENT 教室类型外键, seat_count int NOT NULL DEFAULT 0 COMMENT 座位数, cover varchar(255) DEFAULT NULL COMMENT 封面图地址, status tinyint NOT NULL DEFAULT 1 COMMENT 1 可用 0 停用 2 维护中, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_room_building (building, room_no), KEY idx_type_status (type_id, status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT教室信息表; CREATE TABLE reservation ( id bigint NOT NULL AUTO_INCREMENT, classroom_id bigint NOT NULL COMMENT 教室 ID, user_id bigint NOT NULL COMMENT 预约人 ID取自登录态不取前端, reserve_date date NOT NULL COMMENT 预约日期, start_section tinyint NOT NULL COMMENT 开始节次 1-12, end_section tinyint NOT NULL COMMENT 结束节次闭区间, status tinyint NOT NULL DEFAULT 1 COMMENT 1 待审核 2 已通过 3 已取消 4 已使用 5 已驳回, remark varchar(200) DEFAULT NULL, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_room_date (classroom_id, reserve_date, status), KEY idx_user_date (user_id, reserve_date) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT预约主单表;uk_room_building保证同一个教学楼里不会出现两个 A305idx_room_date是查某间教室某天有哪些预约的覆盖前缀idx_user_date服务于小程序我的预约页。状态字段用 tinyint 而不是 varchar一是省空间二是排序和条件过滤时会走索引而不是字符串比较。3.3 用唯一索引兜住并发重复预约主单表解决不了重复预约因为一次预约是第 3 到第 4 节这样的区间区间重叠没法用一条唯一索引表达。可行的做法是加一张节次占位表把区间拆成单个节次行让数据库来判重CREATE TABLE reservation_slot ( id bigint NOT NULL AUTO_INCREMENT, classroom_id bigint NOT NULL, reserve_date date NOT NULL, section tinyint NOT NULL COMMENT 节次序号 1-12, reservation_id bigint NOT NULL COMMENT 归属预约单, PRIMARY KEY (id), UNIQUE KEY uk_room_date_section (classroom_id, reserve_date, section), KEY idx_reservation (reservation_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT节次占用表取消预约时删除对应行;uk_room_date_section就是那把锁两个人抢同一间教室的同一节第二条插入必然抛 DuplicateKeyException。因为占位行只在有效预约期间存在取消预约时直接物理删除这些行教室立刻回到可约状态不需要处理状态位占着坑的问题。提示占位表不要做成取消后置状态 0那等于把唯一索引废掉了下一次预约还是插不进去。3.4 字段类型上的三个坑论文里常见写法建议写法原因reserve_date varchar(20)date字符串比较时2025-3-1大于2025-12-01区间查询直接错status varchar(10)存已通过tinyint 字典状态改名要全表更新索引效率也低electricity varchar(50)decimal(10,2)电量做增减需要数值类型字符串要额外转换时间字段统一用 datetime配合ON UPDATE CURRENT_TIMESTAMP让 update_time 自动维护比在 Service 里手动setUpdateTime(new Date())可靠得多。4. 预约冲突校验与状态流转服务层事务与小程序端调用4.1 接口清单与参数约定方法路径关键入参返回约定POST/api/reservation/submitclassroomId、reserveDate、startSection、endSectioncode0 与预约单 id409 表示节次被占GET/api/classroom/availablebuilding、reserveDate、startSection、endSection可用教室列表GET/api/reservation/minepageNum、pageSize当前用户预约分页PUT/api/reservation/cancel/{id}预约单 idcode0403 表示非本人PUT/api/reservation/audit/{id}status2 通过 / 5 驳回仅管理员可调统一响应体写成{code, msg, data}三段小程序端只判code永远不要把 HTTP 状态码和业务码混着用否则真机上的表现和开发者工具不一致时很难查。4.2 服务层事务范围与冲突兜底Service public class ReservationServiceImpl implements ReservationService { Resource private ReservationMapper reservationMapper; Resource private ReservationSlotMapper slotMapper; Resource private ClassroomMapper classroomMapper; /** * 提交预约主单 节次占位任意一行唯一键冲突则整笔回滚 */ Override Transactional(rollbackFor Exception.class) public Long submit(ReservationDTO dto) { if (dto.getEndSection() dto.getStartSection()) { throw new BizException(结束节次不能早于开始节次); } // 1. 教室必须处于可用状态停用和维护中的直接拒绝 Classroom room classroomMapper.selectById(dto.getClassroomId()); if (room null || room.getStatus() ! 1) { throw new BizException(教室不存在或当前不可预约); } // 2. 写主单用户 ID 从登录态取不信任前端传参 Reservation r new Reservation(); r.setClassroomId(dto.getClassroomId()); r.setUserId(UserContext.getUserId()); r.setReserveDate(dto.getReserveDate()); r.setStartSection(dto.getStartSection()); r.setEndSection(dto.getEndSection()); r.setStatus(1); reservationMapper.insert(r); // 3. 逐节占位重复键异常交由容器触发回滚 for (int s dto.getStartSection(); s dto.getEndSection(); s) { ReservationSlot slot new ReservationSlot(); slot.setClassroomId(dto.getClassroomId()); slot.setReserveDate(dto.getReserveDate()); slot.setSection((byte) s); slot.setReservationId(r.getId()); slotMapper.insert(slot); } return r.getId(); } }几个参数必须说清楚。rollbackFor Exception.class是因为 Spring 默认只在 RuntimeException 和 Error 上回滚业务里若抛了受检异常就会留下半截数据。UserContext.getUserId()从拦截器解析的 token 里取用户前端传的 userId 一律忽略否则改个请求体就能替别人预约。用户 ID 依赖reservationMapper.insert回填MyBatis-Plus 的主键回填默认开启所以r.getId()在插入后立即可用。节次循环逐条插入是为了让异常精确落在冲突的那一节数据量大时可以换批量插入但冲突信息会变模糊。取消预约是反向操作同样要放在事务里Override Transactional(rollbackFor Exception.class) public void cancel(Long id) { Reservation r reservationMapper.selectById(id); if (r null) throw new BizException(预约不存在); if (!r.getUserId().equals(UserContext.getUserId())) throw new BizException(无权操作他人预约); if (r.getStatus() 4) throw new BizException(已使用的预约不可取消); r.setStatus(3); reservationMapper.updateById(r); // 释放节次占位教室立刻回到可约状态 slotMapper.delete(new LambdaQueryWrapperReservationSlot() .eq(ReservationSlot::getReservationId, id)); }4.3 小程序端提交与错误回显// pages/reservation/submit.js Page({ data: { sections: [1, 2, 3, 4, 5, 6, 7, 8], startIndex: 0, endIndex: 1, submitting: false }, onSubmit() { if (this.data.submitting) return; // 防连点重复提交的第一道闸 const { startIndex, endIndex, sections } this.data; if (endIndex startIndex) { wx.showToast({ title: 结束节次不能早于开始, icon: none }); return; } this.setData({ submitting: true }); wx.request({ url: ${getApp().globalData.baseUrl}/api/reservation/submit, method: POST, header: { content-type: application/json, Authorization: wx.getStorageSync(token) // 后端拦截器据此解析用户 }, data: { classroomId: this.data.classroomId, reserveDate: this.data.reserveDate, startSection: sections[startIndex], endSection: sections[endIndex] }, success: (res) { if (res.data.code 0) { wx.showToast({ title: 已提交等待审核 }); setTimeout(() wx.navigateBack(), 800); } else if (res.data.code 409) { wx.showToast({ title: 该时段已被占用换一间或换节次, icon: none }); } else { wx.showToast({ title: res.data.msg || 提交失败, icon: none }); } }, fail: () wx.showToast({ title: 网络异常请重试, icon: none }), complete: () this.setData({ submitting: false }) }); } });submitting标记是最便宜的一道防重用户连点两下不会发两次请求complete里复位保证失败后按钮还能用409 分支单独提示因为这是并发冲突最常见的表现形式笼统提示提交失败用户会反复试。4.4 排错顺序预约接口报错时按这个顺序看先SHOW INDEX FROM reservation_slot;确认唯一索引真的建了再打印 SQL 看reserve_date传进去是不是字符串最后查事务是否生效——同一个类里 A 方法直接调this.submit()属于自调用不走代理Transactional完全不起作用必须通过注入的接口调用或者AopContext.currentProxy()。这三步能覆盖九成以上的预约成功了但数据不对。5. 联调与上线前的验证域名白名单、并发复现与导航栏适配小程序要调后端先在公众号后台的「开发管理 → 开发设置 → 服务器域名」里把 API 域名填进 request 合法域名必须 HTTPS。本地开发阶段在开发者工具的「详情 → 本地设置」勾上不校验合法域名、web-view、TLS 版本以及 HTTPS 证书就能直连http://localhost:8080注意这个开关对真机预览无效手机调试要么部署到已备案域名要么用内网穿透工具把本地端口暴露出去。冲突逻辑不能只靠代码审查用两条并发请求验证最直接# 同一教室、同一天、同一节次同时提交期望只有一笔返回 code0 curl -X POST https://api.example.com/api/reservation/submit \ -H Content-Type: application/json \ -H Authorization: Bearer token-a \ -d {classroomId:1,reserveDate:2025-03-12,startSection:3,endSection:4} curl -X POST https://api.example.com/api/reservation/submit \ -H Content-Type: application/json \ -H Authorization: Bearer token-b \ -d {classroomId:1,reserveDate:2025-03-12,startSection:3,endSection:4} wait让两条请求几乎同时发出wait等两者结束再回终端。正确结果是其中一笔code0、另一笔code409reservation_slot里恰好两行节次 3、4。如果两笔都成功回到上一节的三步排查。最后是自绘导航栏的高度。navigationStyle: custom之后页面顶部要自己顶出状态栏和胶囊的位置// app.js const win wx.getWindowInfo(); // 基础库 2.20.1 起替代 getSystemInfoSync const menu wx.getMenuButtonBoundingClientRect(); // 胶囊按钮的位置和尺寸 App({ globalData: { statusBarHeight: win.statusBarHeight, // 胶囊上下留白对称据此反推导航栏高度 navBarHeight: (menu.top - win.statusBarHeight) * 2 menu.height } });statusBarHeight是状态栏高度menu.top是胶囊顶部到屏幕顶部的距离两者相减得到胶囊上方留白乘 2 就是下留白加上胶囊自身高度才是完整的导航栏高度。页面里把这几个值写进padding-top标题才不会在不同机型上被胶囊压住。改完这套配置记得在开发者工具里切换几款机型再核一遍navBarHeight几像素的偏差就足以让标题偏移。本文还有配套的精品资源点击获取 Spring Boot微信小程序教室预约系统：并发冲突与状态流转（论文+源码）
简介这份资源是一篇基于 Spring Boot 与微信小程序的高校教室预约管理系统毕业论文面向计算机相关专业的本科毕业生、课程设计者以及需要完成类似选题的开发者可用于参考选题思路、系统分析与论文写作框架。压缩包内含 1 个 doc 文档约 4.65MB内容按摘要、绪论、开发工具及关键技术介绍、系统分析等章节组织中英文摘要与目录齐全便于直接对照结构与行文规范。论文围绕微信小程序、Spring Boot 框架、MySQL 数据库和 Java 语言展开涵盖需求与可行性分析、功能模块与界面设计、数据库表结构与索引设计、后端接口开发并讨论了系统后期的维护、升级与安全等可操作性问题。目前已有 132 人学习浏览适合作为教室预约、场地管理等同类课题的参考范本帮助读者理清从需求分析到数据库与后端实现的完整链路也可作为论文排版与章节撰写的借鉴材料。1. 从一张被重复占用的教室排期表说起校园项目里最常见的事故是教务老师打开后台发现同一间 A305 在周三第 3-4 节挂着三条预约记录三个学生都收到了预约成功。问题往往不在页面而在于把查一次有没有冲突、没有就插入写成了两段互不相干的操作两个人同时提交就会各自查到没冲突。这份 springboot 基于微信小程序的高校教室预约管理系统论文 源码正好踩在这类真实痛点上管理员服务端负责监测员管理、教室类型、教室信息、课室大门、课室窗帘、课室用电、充电提醒与留言板监测员微信端负责查教室、看设备状态、提交和取消预约论文里的监测员就是小程序端的普通用户通常是学生或值班巡检人员。它适合正在做基于 Spring Boot 的 Java 毕设、想把小程序和 Java 后端彻底跑通一遍的人也适合已经写过 CRUD、但没认真处理过并发预约与状态流转的人拿来对照自己的实现。2. 拆开目录看技术栈Spring Boot 分层、小程序双端职责与开发环境2.1 为什么这套毕设用 Spring Boot 而不是原生 SSM论文里给 Spring Boot 列了六条优势真正站得住的是两条起步依赖把内嵌 Tomcat、Jackson、日志、数据源一起打包进来不用再维护 web.xml 和一堆 XML以及自动装配。自动装配的机制不复杂SpringBootApplication里藏着EnableAutoConfiguration它读取依赖包里的候选配置类再由ConditionalOnClass、ConditionalOnMissingBean这类条件注解筛选只有类路径上确实存在对应依赖、并且你没有自己定义 Bean 时才生效。理解这一层后面遇到依赖加了但配置没生效就不会乱猜。用 IDEA 创建项目的顺序我一般这么走New Project → Spring InitializrServer URL 保持默认Group 填com.exampleArtifact 填classroomType 选 MavenJDK 选 17依赖勾 Spring Web、MySQL Driver、LombokMyBatis-Plus 不在官方列表里生成后手动加先跑一遍空项目确认 8080 能起来再往里填业务代码。JDK 这一步最容易翻车。Spring Boot 3.x 的最低要求是 JDK 17如果本机只有 JDK 8只能把版本压到 2.7.x很多人嘴里说的springboot 版本太高跑不起来根源就在这里而不是 Maven 下载失败。dependencies !-- Web 层内嵌 Tomcat Spring MVC -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- 持久层MyBatis-Plus 省掉单表 CRUD 的 XML -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.5/version /dependency !-- 驱动8.x 驱动类名为 com.mysql.cj.jdbc.Driver -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency !-- 参数校验NotNull、Min 等注解生效 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependency /dependencies三个依赖各管一段starter-web 提供 MVC 和序列化MyBatis-Plus 负责把实体映射成 SQLvalidation 负责在 Controller 入参上拦掉明显非法的请求。scope为 runtime 表示编译期不需要驱动类只在运行时加载这样换数据库驱动不用改代码。2.2 小程序端目录结构与双端职责划分小程序框架分逻辑层和视图层逻辑层跑在 JSCore 里写Page({})、App({})视图层是 WXML WXSS由 WebView 渲染。两层之间靠setData通信逻辑层改数据、视图层跟着更新所以不要在setData里塞整个大对象教室列表几百条一次性传会明显掉帧分页取、按需传才是正常做法。微信开发者工具的用法论文里列了一长串常用的其实就编译预览、控制台调试、真机远程调试、上传代码四件事。需要注意代码体积限制在 2M 以内教室封面图这类静态资源别直接打进包里走对象存储或后端静态目录。端模块主要操作落库表管理员服务端监测员管理增删改用户、重置密码、分配角色sys_user管理员服务端教室信息管理维护编号、教学楼、类型、座位数classroom、classroom_type管理员服务端设备监测管理记录大门、窗帘、用电、充电提醒状态device_record管理员服务端预约审核通过或驳回预约单reservation监测员微信端首页、教室信息按教学楼和日期筛可用教室classroom监测员微信端课室大门、课室用电查看设备当前状态device_record监测员微信端我的我的预约、取消预约reservation{ pages: [ pages/index/index, pages/classroom/list, pages/reservation/submit, pages/reservation/mine, pages/mine/mine ], window: { navigationBarTitleText: 教室预约, navigationBarBackgroundColor: #ffffff, navigationStyle: custom, backgroundColor: #f5f6f8 }, networkTimeout: { request: 10000 } }pages的第一项就是冷启动页navigationStyle设为custom表示自绘导航栏页面里要自己留状态栏高度这一点在第 5 章会算networkTimeout.request建议显式写成 10 秒默认值更长弱网下用户会以为按钮没反应而反复点。2.3 后端配置与本地起服务server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/classroom_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 mybatis-plus: configuration: map-underscore-to-camel-case: true global-config: db-config: id-type: autoserverTimezone和time-zone必须同时指定只写一个会出现入库时间比实际早 8 小时allowPublicKeyRetrievaltrue是 MySQL 8 用 caching_sha2_password 认证时本地连接的常见补丁map-underscore-to-camel-case打开后room_no才会自动映射到roomNo不开就是一片 null。3. 教室预约的数据建模从 ER 图落到 InnoDB 建表语句3.1 三类实体怎么切表论文的 ER 图给了监测员信息、教室信息、课室大门、课室窗帘、课室用电五张实体属性图。落地时最常见的偷懒做法是给大门、窗帘、用电各建一张结构几乎一样的表字段都是监测账号、教室编号、监测类型、状态、备注、记录时间。我一般合成一张device_record用device_type区分 1大门、2窗帘、3用电、4充电提醒用电表额外的电量监测字段就放在通用ext_value里。这样新增一类设备不用动表结构查询某间教室的全部设备状态也只需要一条 SQL。3.2 核心表建表语句CREATE TABLE classroom ( id bigint NOT NULL AUTO_INCREMENT COMMENT 教室主键, room_no varchar(20) NOT NULL COMMENT 教室编号如 A305, building varchar(50) NOT NULL COMMENT 教学楼名称, type_id bigint NOT NULL COMMENT 教室类型外键, seat_count int NOT NULL DEFAULT 0 COMMENT 座位数, cover varchar(255) DEFAULT NULL COMMENT 封面图地址, status tinyint NOT NULL DEFAULT 1 COMMENT 1 可用 0 停用 2 维护中, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_room_building (building, room_no), KEY idx_type_status (type_id, status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT教室信息表; CREATE TABLE reservation ( id bigint NOT NULL AUTO_INCREMENT, classroom_id bigint NOT NULL COMMENT 教室 ID, user_id bigint NOT NULL COMMENT 预约人 ID取自登录态不取前端, reserve_date date NOT NULL COMMENT 预约日期, start_section tinyint NOT NULL COMMENT 开始节次 1-12, end_section tinyint NOT NULL COMMENT 结束节次闭区间, status tinyint NOT NULL DEFAULT 1 COMMENT 1 待审核 2 已通过 3 已取消 4 已使用 5 已驳回, remark varchar(200) DEFAULT NULL, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_room_date (classroom_id, reserve_date, status), KEY idx_user_date (user_id, reserve_date) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT预约主单表;uk_room_building保证同一个教学楼里不会出现两个 A305idx_room_date是查某间教室某天有哪些预约的覆盖前缀idx_user_date服务于小程序我的预约页。状态字段用 tinyint 而不是 varchar一是省空间二是排序和条件过滤时会走索引而不是字符串比较。3.3 用唯一索引兜住并发重复预约主单表解决不了重复预约因为一次预约是第 3 到第 4 节这样的区间区间重叠没法用一条唯一索引表达。可行的做法是加一张节次占位表把区间拆成单个节次行让数据库来判重CREATE TABLE reservation_slot ( id bigint NOT NULL AUTO_INCREMENT, classroom_id bigint NOT NULL, reserve_date date NOT NULL, section tinyint NOT NULL COMMENT 节次序号 1-12, reservation_id bigint NOT NULL COMMENT 归属预约单, PRIMARY KEY (id), UNIQUE KEY uk_room_date_section (classroom_id, reserve_date, section), KEY idx_reservation (reservation_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT节次占用表取消预约时删除对应行;uk_room_date_section就是那把锁两个人抢同一间教室的同一节第二条插入必然抛 DuplicateKeyException。因为占位行只在有效预约期间存在取消预约时直接物理删除这些行教室立刻回到可约状态不需要处理状态位占着坑的问题。提示占位表不要做成取消后置状态 0那等于把唯一索引废掉了下一次预约还是插不进去。3.4 字段类型上的三个坑论文里常见写法建议写法原因reserve_date varchar(20)date字符串比较时2025-3-1大于2025-12-01区间查询直接错status varchar(10)存已通过tinyint 字典状态改名要全表更新索引效率也低electricity varchar(50)decimal(10,2)电量做增减需要数值类型字符串要额外转换时间字段统一用 datetime配合ON UPDATE CURRENT_TIMESTAMP让 update_time 自动维护比在 Service 里手动setUpdateTime(new Date())可靠得多。4. 预约冲突校验与状态流转服务层事务与小程序端调用4.1 接口清单与参数约定方法路径关键入参返回约定POST/api/reservation/submitclassroomId、reserveDate、startSection、endSectioncode0 与预约单 id409 表示节次被占GET/api/classroom/availablebuilding、reserveDate、startSection、endSection可用教室列表GET/api/reservation/minepageNum、pageSize当前用户预约分页PUT/api/reservation/cancel/{id}预约单 idcode0403 表示非本人PUT/api/reservation/audit/{id}status2 通过 / 5 驳回仅管理员可调统一响应体写成{code, msg, data}三段小程序端只判code永远不要把 HTTP 状态码和业务码混着用否则真机上的表现和开发者工具不一致时很难查。4.2 服务层事务范围与冲突兜底Service public class ReservationServiceImpl implements ReservationService { Resource private ReservationMapper reservationMapper; Resource private ReservationSlotMapper slotMapper; Resource private ClassroomMapper classroomMapper; /** * 提交预约主单 节次占位任意一行唯一键冲突则整笔回滚 */ Override Transactional(rollbackFor Exception.class) public Long submit(ReservationDTO dto) { if (dto.getEndSection() dto.getStartSection()) { throw new BizException(结束节次不能早于开始节次); } // 1. 教室必须处于可用状态停用和维护中的直接拒绝 Classroom room classroomMapper.selectById(dto.getClassroomId()); if (room null || room.getStatus() ! 1) { throw new BizException(教室不存在或当前不可预约); } // 2. 写主单用户 ID 从登录态取不信任前端传参 Reservation r new Reservation(); r.setClassroomId(dto.getClassroomId()); r.setUserId(UserContext.getUserId()); r.setReserveDate(dto.getReserveDate()); r.setStartSection(dto.getStartSection()); r.setEndSection(dto.getEndSection()); r.setStatus(1); reservationMapper.insert(r); // 3. 逐节占位重复键异常交由容器触发回滚 for (int s dto.getStartSection(); s dto.getEndSection(); s) { ReservationSlot slot new ReservationSlot(); slot.setClassroomId(dto.getClassroomId()); slot.setReserveDate(dto.getReserveDate()); slot.setSection((byte) s); slot.setReservationId(r.getId()); slotMapper.insert(slot); } return r.getId(); } }几个参数必须说清楚。rollbackFor Exception.class是因为 Spring 默认只在 RuntimeException 和 Error 上回滚业务里若抛了受检异常就会留下半截数据。UserContext.getUserId()从拦截器解析的 token 里取用户前端传的 userId 一律忽略否则改个请求体就能替别人预约。用户 ID 依赖reservationMapper.insert回填MyBatis-Plus 的主键回填默认开启所以r.getId()在插入后立即可用。节次循环逐条插入是为了让异常精确落在冲突的那一节数据量大时可以换批量插入但冲突信息会变模糊。取消预约是反向操作同样要放在事务里Override Transactional(rollbackFor Exception.class) public void cancel(Long id) { Reservation r reservationMapper.selectById(id); if (r null) throw new BizException(预约不存在); if (!r.getUserId().equals(UserContext.getUserId())) throw new BizException(无权操作他人预约); if (r.getStatus() 4) throw new BizException(已使用的预约不可取消); r.setStatus(3); reservationMapper.updateById(r); // 释放节次占位教室立刻回到可约状态 slotMapper.delete(new LambdaQueryWrapperReservationSlot() .eq(ReservationSlot::getReservationId, id)); }4.3 小程序端提交与错误回显// pages/reservation/submit.js Page({ data: { sections: [1, 2, 3, 4, 5, 6, 7, 8], startIndex: 0, endIndex: 1, submitting: false }, onSubmit() { if (this.data.submitting) return; // 防连点重复提交的第一道闸 const { startIndex, endIndex, sections } this.data; if (endIndex startIndex) { wx.showToast({ title: 结束节次不能早于开始, icon: none }); return; } this.setData({ submitting: true }); wx.request({ url: ${getApp().globalData.baseUrl}/api/reservation/submit, method: POST, header: { content-type: application/json, Authorization: wx.getStorageSync(token) // 后端拦截器据此解析用户 }, data: { classroomId: this.data.classroomId, reserveDate: this.data.reserveDate, startSection: sections[startIndex], endSection: sections[endIndex] }, success: (res) { if (res.data.code 0) { wx.showToast({ title: 已提交等待审核 }); setTimeout(() wx.navigateBack(), 800); } else if (res.data.code 409) { wx.showToast({ title: 该时段已被占用换一间或换节次, icon: none }); } else { wx.showToast({ title: res.data.msg || 提交失败, icon: none }); } }, fail: () wx.showToast({ title: 网络异常请重试, icon: none }), complete: () this.setData({ submitting: false }) }); } });submitting标记是最便宜的一道防重用户连点两下不会发两次请求complete里复位保证失败后按钮还能用409 分支单独提示因为这是并发冲突最常见的表现形式笼统提示提交失败用户会反复试。4.4 排错顺序预约接口报错时按这个顺序看先SHOW INDEX FROM reservation_slot;确认唯一索引真的建了再打印 SQL 看reserve_date传进去是不是字符串最后查事务是否生效——同一个类里 A 方法直接调this.submit()属于自调用不走代理Transactional完全不起作用必须通过注入的接口调用或者AopContext.currentProxy()。这三步能覆盖九成以上的预约成功了但数据不对。5. 联调与上线前的验证域名白名单、并发复现与导航栏适配小程序要调后端先在公众号后台的「开发管理 → 开发设置 → 服务器域名」里把 API 域名填进 request 合法域名必须 HTTPS。本地开发阶段在开发者工具的「详情 → 本地设置」勾上不校验合法域名、web-view、TLS 版本以及 HTTPS 证书就能直连http://localhost:8080注意这个开关对真机预览无效手机调试要么部署到已备案域名要么用内网穿透工具把本地端口暴露出去。冲突逻辑不能只靠代码审查用两条并发请求验证最直接# 同一教室、同一天、同一节次同时提交期望只有一笔返回 code0 curl -X POST https://api.example.com/api/reservation/submit \ -H Content-Type: application/json \ -H Authorization: Bearer token-a \ -d {classroomId:1,reserveDate:2025-03-12,startSection:3,endSection:4} curl -X POST https://api.example.com/api/reservation/submit \ -H Content-Type: application/json \ -H Authorization: Bearer token-b \ -d {classroomId:1,reserveDate:2025-03-12,startSection:3,endSection:4} wait让两条请求几乎同时发出wait等两者结束再回终端。正确结果是其中一笔code0、另一笔code409reservation_slot里恰好两行节次 3、4。如果两笔都成功回到上一节的三步排查。最后是自绘导航栏的高度。navigationStyle: custom之后页面顶部要自己顶出状态栏和胶囊的位置// app.js const win wx.getWindowInfo(); // 基础库 2.20.1 起替代 getSystemInfoSync const menu wx.getMenuButtonBoundingClientRect(); // 胶囊按钮的位置和尺寸 App({ globalData: { statusBarHeight: win.statusBarHeight, // 胶囊上下留白对称据此反推导航栏高度 navBarHeight: (menu.top - win.statusBarHeight) * 2 menu.height } });statusBarHeight是状态栏高度menu.top是胶囊顶部到屏幕顶部的距离两者相减得到胶囊上方留白乘 2 就是下留白加上胶囊自身高度才是完整的导航栏高度。页面里把这几个值写进padding-top标题才不会在不同机型上被胶囊压住。改完这套配置记得在开发者工具里切换几款机型再核一遍navBarHeight几像素的偏差就足以让标题偏移。本文还有配套的精品资源点击获取