简介这是一套面向计算机专业本科生的微信小程序毕业设计实战资源聚焦高校场景下的自习室预约管理需求适用于毕业设计、课程设计及期末大作业开发参考。资源包含完整前后端代码、MySQL数据库脚本、部署工具与详细教程技术栈涵盖微信小程序前端与Java后端SSM/SpringBoot适配IDEA、微信开发者工具及Tomcat 7.x/8.x环境注释详尽新手可快速上手调试运行。压缩包共1186个文件含151个JavaScript逻辑文件、120个Vue组件、96个Java业务类、64个WXML页面结构及66个WXSS样式文件辅以319张PNG界面截图与96个JSON配置整体大小29.28MB目录结构规范模块划分清晰。目前已有91人学习下载资源附带3个批处理脚本install/run/build及.bak备份文件便于环境搭建与版本回溯是兼具教学性、可运行性与工程规范性的高完成度毕设范例。1. 这不是个“套壳小程序”而是一套可落地的校园场景闭环预约系统新乡学院的学生早上六点抢自习室八成失败——不是因为手速慢而是系统压根没做并发控制、没做座位状态实时校验、没做预约冲突拦截。这个毕业设计项目恰恰卡在了真实校园场景的痛点上它用标准微信小程序前端 SSM 后端SpringMVC Spring MyBatis MySQL 构建了一套完整闭环从用户扫码进小程序选座、提交预约、支付押金模拟、到管理员后台审核、释放空闲座位、导出预约报表全部链路打通。它不依赖云开发或第三方服务所有逻辑跑在本地 Tomcat MySQL 环境里数据库脚本直接建表、初始化测试数据含教学楼、楼层、教室、座位坐标连管理员账号密码都写在application.properties里。适合两类人一是计算机专业学生做毕设/课设代码有中文注释、分层清晰controller → service → dao → entity、SQL 全部手写带字段说明二是运维或教学老师想快速搭一个轻量级预约 demo3 个 bat 脚本1-install.bat初始化库、2-run.bat启动后端、3-build.bat构建小程序包就能跑起来不用配 Maven 仓库镜像、不用改端口冲突、不用处理 SSL 证书。2. 前端小程序结构解析从IndexMain.vue.bak看页面路由与状态管理设计这个项目的小程序前端采用 Vue.js 2.x 微信原生组件混合开发非 uni-app所有.vue.bak文件是备份源码实际运行时需重命名为.vue。核心页面结构由IndexMain.vue驱动它不是单页应用入口而是作为主容器承载左侧导航IndexAsideStatic.vue.bak、顶部栏IndexHeader.vue.bak和面包屑BreadCrumbs.vue.bak。这种拆分方式规避了微信小程序对app.json页面栈的硬性限制把路由逻辑交给 Vue Router 模拟实际通过wx.navigateTo封装同时保留原生组件性能优势。2.1 页面加载流程与main.css.bak的样式隔离策略打开main.css.bak会发现它并非全局样式表而是专为IndexMain.vue容器设计的布局骨架/* main.css.bak 关键片段 */ .index-container { display: flex; height: 100vh; overflow: hidden; } .index-aside { width: 200px; background: #f5f5f5; border-right: 1px solid #e0e0e0; } .index-main-content { flex: 1; overflow-y: auto; padding: 16px; }提示.bak后缀说明该文件曾被覆盖部署前务必重命名为main.css并确认已引入到IndexMain.vue的style scoped中。scoped 属性确保样式仅作用于当前组件避免与微信原生组件如button、picker产生冲突——这是很多新手调试时发现按钮样式失效的根本原因。2.2update-password.vue.bak中的表单验证与接口调用链密码修改功能独立成页其验证逻辑不依赖第三方库而是用原生RegExp实现强度校验// update-password.vue.bak 中的 validatePassword 方法 validatePassword() { const pwdRegex /^(?.*[a-z])(?.*[A-Z])(?.*\d)[a-zA-Z\d]{8,16}$/; if (!pwdRegex.test(this.newPassword)) { wx.showToast({ title: 密码需8-16位含大小写字母数字, icon: none, duration: 2000 }); return false; } if (this.newPassword ! this.confirmPassword) { wx.showToast({ title: 两次输入密码不一致, icon: none, duration: 2000 }); return false; } return true; }该方法触发后调用wx.request发起 POST 请求wx.request({ url: http://localhost:8080/user/updatePassword, // 注意此处为开发环境地址上线需替换为域名 method: POST, data: { userId: wx.getStorageSync(userId), oldPassword: this.oldPassword, newPassword: this.newPassword }, header: { Content-Type: application/x-www-form-urlencoded }, success: (res) { if (res.data.code 200) { wx.showToast({ title: 修改成功, icon: success }); setTimeout(() wx.navigateBack(), 1500); } else { wx.showToast({ title: res.data.msg || 修改失败, icon: none }); } } });注意header中必须指定application/x-www-form-urlencoded否则后端 SpringMVC 的RequestParam注解无法正确解析参数。若改为application/json则后端需改用RequestBody接收 JSON 对象但本项目所有接口均按表单提交设计强行改类型会导致 400 错误。2.3 面包屑组件BreadCrumbs.vue.bak的动态路径生成逻辑该组件通过监听当前页面路径实现自动更新不依赖onLoad生命周期手动传参// BreadCrumbs.vue.bak 中的 mounted 钩子 mounted() { const pages getCurrentPages(); const currentPage pages[pages.length - 1]; const route currentPage.route; // 返回字符串如 pages/reserve/reserve // 映射关系表route → 中文标题 const routeMap { pages/index/index: 首页, pages/reserve/reserve: 预约座位, pages/myorder/myorder: 我的预约, pages/admin/login: 管理员登录 }; this.breadcrumbList route.split(/).map((item, index, arr) { const path arr.slice(0, index 1).join(/); return { name: routeMap[path] || item, path: / path }; }).filter(item item.name item.name ! pages); }此设计避免了每个页面重复写setData更新面包屑且支持多级嵌套如pages/reserve/detail可自动补全为「首页 预约座位 详情」但要求routeMap必须覆盖所有页面路径漏配会导致显示英文路径。3. 后端 SSM 架构实现MyBatis 动态 SQL 与预约冲突校验的核心逻辑项目后端明确采用 SSMSpring SpringMVC MyBatis而非 SpringBoot这意味着配置分散在spring-mvc.xml、applicationContext.xml和mybatis-config.xml三个文件中。数据库连接池使用 Druid事务管理通过Transactional注解实现所有 DAO 层操作均走 MyBatis 的SqlSessionTemplate。3.1 数据库设计关键约束与seat_status字段的业务语义MySQL 表结构中seat表的status字段不是简单的 0/1 开关而是四态枚举status含义是否可预约是否计入统计0空闲是是1已预约否是2维护中否否3已占用未释放否是该设计支撑了“预约后 15 分钟未签到自动释放”功能。对应 MyBatis 的SeatMapper.xml中查询可用座位的 SQL 使用CASE WHEN动态过滤!-- SeatMapper.xml -- select idselectAvailableSeats resultTypeSeat SELECT * FROM seat WHERE room_id #{roomId} AND status IN (0, 3) !-- 空闲和已占用状态才参与预约 -- AND id NOT IN ( SELECT seat_id FROM reservation WHERE DATE(reserve_time) CURDATE() AND status IN (0, 1) !-- 今日已预约且未取消/未过期 -- ) /select提示CURDATE()函数确保只排除当天预约记录避免历史数据干扰。若需支持跨天预约如提前 3 天需将CURDATE()替换为#{reserveDate}参数并在 Java 方法中传入LocalDate.now().plusDays(3)。3.2 预约接口的分布式锁防重放设计ReservationController.java中的createReservation方法表面看只是插入一条记录实则包含三重校验前端时间戳校验请求携带timestamp参数后端比对与服务器时间差是否超过 5 分钟Redis 分布式锁以lock:seat:${seatId}:${date}为 key设置过期时间 10 秒防止同一座位被并发抢占数据库唯一索引兜底reservation表在(seat_id, reserve_date, session_id)上建联合唯一索引。// ReservationService.java 片段 public Result createReservation(Reservation reservation) { // 1. 时间戳校验 long clientTime reservation.getTimestamp(); long serverTime System.currentTimeMillis(); if (Math.abs(serverTime - clientTime) 5 * 60 * 1000) { return Result.fail(请求超时); } // 2. Redis 锁 String lockKey lock:seat: reservation.getSeatId() : reservation.getReserveDate(); Boolean isLocked redisTemplate.opsForValue().setIfAbsent(lockKey, 1, 10, TimeUnit.SECONDS); if (!isLocked) { return Result.fail(座位正被他人预约请稍后再试); } try { // 3. 数据库插入唯一索引自动拦截重复 int rows reservationMapper.insert(reservation); return rows 0 ? Result.success() : Result.fail(预约失败); } finally { redisTemplate.delete(lockKey); // 必须释放锁 } }3.3 管理员后台的 MyBatis 分页插件配置细节项目使用 PageHelper 5.1.10非最新版其配置在mybatis-config.xml中plugins plugin interceptorcom.github.pagehelper.PageInterceptor property namedialect valuemysql/ property namerowBoundsWithCount valuetrue/ property nameoffsetAsPageNum valuetrue/ /plugin /plugins关键参数说明dialectmysql指定方言避免在 Oracle 或 PostgreSQL 环境下 SQL 报错rowBoundsWithCounttrue开启 count 查询PageHelper.startPage(1,10)后执行select * from reservation会自动生成SELECT COUNT(*)语句offsetAsPageNumtrue允许用startPage(offset, pageSize)代替startPage(pageNum, pageSize)适配前端传来的偏移量。若发现分页总数为 0需检查PageHelper.startPage()是否在select语句之前调用且中间不能有其他数据库操作如insert、update否则分页上下文会被清空。4. 部署全流程从1-install.bat到3-build.bat的环境适配要点项目提供三个批处理脚本但它们不是“一键傻瓜式”而是针对 Windows JDK8 Tomcat7/8 环境定制。Linux/macOS 用户需手动转换命令且必须注意 MySQL 5.7 与 8.0 的协议差异。4.11-install.bat执行前的数据库准备清单该脚本本质是调用mysql -u root -p init.sql但前提是MySQL 5.7 必须启用sql_modeNO_ENGINE_SUBSTITUTION在my.ini中添加[mysqld] sql_modeSTRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION若使用 MySQL 8.0需额外关闭caching_sha2_password认证插件否则 JDBC 连接报Client does not support authentication protocolALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY your_password; FLUSH PRIVILEGES;init.sql中的存储引擎必须显式声明项目 SQL 脚本中所有CREATE TABLE语句末尾均有ENGINEInnoDB DEFAULT CHARSETutf8mb4;不可省略。utf8mb4支持 emoji 和生僻字若用utf8会导致微信昵称存入乱码。4.22-run.bat启动失败的三大高频原因及修复命令Tomcat 启动报错常见于以下场景错误现象根本原因修复命令java.lang.ClassNotFoundException: org.springframework.web.servlet.DispatcherServletMaven 依赖未打入WEB-INF/lib运行mvn clean package -Dmaven.test.skiptrue后确认target/xxx/WEB-INF/lib下存在spring-webmvc-5.2.3.RELEASE.jarCaused by: java.sql.SQLException: Access denied for user rootlocalhostapplication.properties中数据库密码错误修改src/main/resources/application.propertiesjdbc.passwordyour_real_passwordSEVERE: Error filterStartweb.xml中CharacterEncodingFilter编码未设为 UTF-8在web.xml的filter标签下添加init-paramparam-nameencoding/param-nameparam-valueUTF-8/param-value/init-param4.33-build.bat构建小程序包的路径映射规则该脚本调用npm run build:weixin其package.json中定义scripts: { build:weixin: vue-cli-service build --mode weixin --dest dist/weixin }构建产物dist/weixin目录结构必须严格匹配微信开发者工具的项目根目录dist/weixin/ ├── app.js # 入口文件 ├── app.json # 页面路径配置 ├── project.config.json # 工具配置 └── pages/ └── index/ ├── index.js ├── index.wxml └── index.wxss若微信开发者工具提示“找不到 app.js”说明--dest路径错误需检查vue.config.js中outputDir是否为dist/weixin且project.config.json的miniprogramRoot字段值为./。5. 实战调试技巧用 Chrome DevTools 捕获小程序网络请求并定位后端 500 错误当小程序点击“预约”按钮无响应或提示“服务器内部错误”不要急于重装环境先用 Chrome DevTools 抓取真实请求链路。该技巧绕过微信开发者工具的代理限制直击 Tomcat 日志源头。5.1 启用 Tomcat 访问日志并定位异常请求在conf/server.xml的Host标签下添加Valve classNameorg.apache.catalina.valves.AccessLogValve directorylogs prefixlocalhost_access_log. suffix.txt pattern%h %l %u %t quot;%rquot; %s %b %D %{User-Agent}i /重启 Tomcat 后访问http://localhost:8080/user/login触发一次登录查看logs/localhost_access_log.2024-06-15.txt找到类似行127.0.0.1 - - [15/Jun/2024:14:22:33 0800] POST /reservation/create HTTP/1.1 500 1122 123 Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36其中500表示服务器错误123是耗时毫秒数1122是响应体字节数。接着查logs/catalina.out搜索14:22:33时间戳附近的堆栈Caused by: com.mysql.jdbc.exceptions.jdbc4.MySQLIntegrityConstraintViolationException: Duplicate entry 1001-2024-06-15-1 for key uk_seat_date_session这说明唯一索引冲突对应reservation表的(seat_id, reserve_date, session_id)联合索引。此时回到前端检查createReservation请求体中的session_id是否重复生成。5.2 微信小程序真机调试的抓包替代方案由于burp suite或charles无法直接抓取微信客户端流量采用“服务端打点 前端日志”双通道定位后端增加请求日志切面在com.xxx.aspect.LogAspect.java中添加Around(execution(* com.xxx.controller..*.*(..))) public Object logExecutionTime(ProceedingJoinPoint joinPoint) throws Throwable { long start System.currentTimeMillis(); Object proceed joinPoint.proceed(); long executionTime System.currentTimeMillis() - start; logger.info({} executed in {} ms with args {}, joinPoint.getSignature(), executionTime, Arrays.toString(joinPoint.getArgs())); return proceed; }小程序前端开启wx.setEnableDebug在app.js的onLaunch中添加if (wx.setEnableDebug) { wx.setEnableDebug({ enableDebug: true }); }然后在微信开发者工具控制台输入console.log(debug info)即可看到详细日志。5.3 MySQL 死锁排查从show engine innodb status提取关键信息当多个用户同时预约同一楼层座位时可能出现Deadlock found when trying to get lock错误。执行SHOW ENGINE INNODB STATUS\G重点关注LATEST DETECTED DEADLOCK部分提取TRANSACTIONID 和WAITING FOR THIS LOCK TO BE GRANTED的 SQL。例如*** (1) WAITING FOR THIS LOCK TO BE GRANTED: RECORD LOCKS space id 108 page no 3 n bits 72 index PRIMARY of table reserve.seat trx id 123456789 lock_mode X locks rec but not gap waiting说明事务 123456789 在等待seat表主键上的排他锁。此时应检查SeatService.updateStatus()方法是否在Transactional内执行了SELECT ... FOR UPDATE且锁范围过大如未加WHERE id ?条件导致锁整表。优化方案是缩小锁粒度或改用乐观锁version字段 UPDATE ... SET status 1, version version 1 WHERE id ? AND version ?。本文还有配套的精品资源点击获取
SSM校园座位预约系统：并发控制与微信小程序闭环实现
简介这是一套面向计算机专业本科生的微信小程序毕业设计实战资源聚焦高校场景下的自习室预约管理需求适用于毕业设计、课程设计及期末大作业开发参考。资源包含完整前后端代码、MySQL数据库脚本、部署工具与详细教程技术栈涵盖微信小程序前端与Java后端SSM/SpringBoot适配IDEA、微信开发者工具及Tomcat 7.x/8.x环境注释详尽新手可快速上手调试运行。压缩包共1186个文件含151个JavaScript逻辑文件、120个Vue组件、96个Java业务类、64个WXML页面结构及66个WXSS样式文件辅以319张PNG界面截图与96个JSON配置整体大小29.28MB目录结构规范模块划分清晰。目前已有91人学习下载资源附带3个批处理脚本install/run/build及.bak备份文件便于环境搭建与版本回溯是兼具教学性、可运行性与工程规范性的高完成度毕设范例。1. 这不是个“套壳小程序”而是一套可落地的校园场景闭环预约系统新乡学院的学生早上六点抢自习室八成失败——不是因为手速慢而是系统压根没做并发控制、没做座位状态实时校验、没做预约冲突拦截。这个毕业设计项目恰恰卡在了真实校园场景的痛点上它用标准微信小程序前端 SSM 后端SpringMVC Spring MyBatis MySQL 构建了一套完整闭环从用户扫码进小程序选座、提交预约、支付押金模拟、到管理员后台审核、释放空闲座位、导出预约报表全部链路打通。它不依赖云开发或第三方服务所有逻辑跑在本地 Tomcat MySQL 环境里数据库脚本直接建表、初始化测试数据含教学楼、楼层、教室、座位坐标连管理员账号密码都写在application.properties里。适合两类人一是计算机专业学生做毕设/课设代码有中文注释、分层清晰controller → service → dao → entity、SQL 全部手写带字段说明二是运维或教学老师想快速搭一个轻量级预约 demo3 个 bat 脚本1-install.bat初始化库、2-run.bat启动后端、3-build.bat构建小程序包就能跑起来不用配 Maven 仓库镜像、不用改端口冲突、不用处理 SSL 证书。2. 前端小程序结构解析从IndexMain.vue.bak看页面路由与状态管理设计这个项目的小程序前端采用 Vue.js 2.x 微信原生组件混合开发非 uni-app所有.vue.bak文件是备份源码实际运行时需重命名为.vue。核心页面结构由IndexMain.vue驱动它不是单页应用入口而是作为主容器承载左侧导航IndexAsideStatic.vue.bak、顶部栏IndexHeader.vue.bak和面包屑BreadCrumbs.vue.bak。这种拆分方式规避了微信小程序对app.json页面栈的硬性限制把路由逻辑交给 Vue Router 模拟实际通过wx.navigateTo封装同时保留原生组件性能优势。2.1 页面加载流程与main.css.bak的样式隔离策略打开main.css.bak会发现它并非全局样式表而是专为IndexMain.vue容器设计的布局骨架/* main.css.bak 关键片段 */ .index-container { display: flex; height: 100vh; overflow: hidden; } .index-aside { width: 200px; background: #f5f5f5; border-right: 1px solid #e0e0e0; } .index-main-content { flex: 1; overflow-y: auto; padding: 16px; }提示.bak后缀说明该文件曾被覆盖部署前务必重命名为main.css并确认已引入到IndexMain.vue的style scoped中。scoped 属性确保样式仅作用于当前组件避免与微信原生组件如button、picker产生冲突——这是很多新手调试时发现按钮样式失效的根本原因。2.2update-password.vue.bak中的表单验证与接口调用链密码修改功能独立成页其验证逻辑不依赖第三方库而是用原生RegExp实现强度校验// update-password.vue.bak 中的 validatePassword 方法 validatePassword() { const pwdRegex /^(?.*[a-z])(?.*[A-Z])(?.*\d)[a-zA-Z\d]{8,16}$/; if (!pwdRegex.test(this.newPassword)) { wx.showToast({ title: 密码需8-16位含大小写字母数字, icon: none, duration: 2000 }); return false; } if (this.newPassword ! this.confirmPassword) { wx.showToast({ title: 两次输入密码不一致, icon: none, duration: 2000 }); return false; } return true; }该方法触发后调用wx.request发起 POST 请求wx.request({ url: http://localhost:8080/user/updatePassword, // 注意此处为开发环境地址上线需替换为域名 method: POST, data: { userId: wx.getStorageSync(userId), oldPassword: this.oldPassword, newPassword: this.newPassword }, header: { Content-Type: application/x-www-form-urlencoded }, success: (res) { if (res.data.code 200) { wx.showToast({ title: 修改成功, icon: success }); setTimeout(() wx.navigateBack(), 1500); } else { wx.showToast({ title: res.data.msg || 修改失败, icon: none }); } } });注意header中必须指定application/x-www-form-urlencoded否则后端 SpringMVC 的RequestParam注解无法正确解析参数。若改为application/json则后端需改用RequestBody接收 JSON 对象但本项目所有接口均按表单提交设计强行改类型会导致 400 错误。2.3 面包屑组件BreadCrumbs.vue.bak的动态路径生成逻辑该组件通过监听当前页面路径实现自动更新不依赖onLoad生命周期手动传参// BreadCrumbs.vue.bak 中的 mounted 钩子 mounted() { const pages getCurrentPages(); const currentPage pages[pages.length - 1]; const route currentPage.route; // 返回字符串如 pages/reserve/reserve // 映射关系表route → 中文标题 const routeMap { pages/index/index: 首页, pages/reserve/reserve: 预约座位, pages/myorder/myorder: 我的预约, pages/admin/login: 管理员登录 }; this.breadcrumbList route.split(/).map((item, index, arr) { const path arr.slice(0, index 1).join(/); return { name: routeMap[path] || item, path: / path }; }).filter(item item.name item.name ! pages); }此设计避免了每个页面重复写setData更新面包屑且支持多级嵌套如pages/reserve/detail可自动补全为「首页 预约座位 详情」但要求routeMap必须覆盖所有页面路径漏配会导致显示英文路径。3. 后端 SSM 架构实现MyBatis 动态 SQL 与预约冲突校验的核心逻辑项目后端明确采用 SSMSpring SpringMVC MyBatis而非 SpringBoot这意味着配置分散在spring-mvc.xml、applicationContext.xml和mybatis-config.xml三个文件中。数据库连接池使用 Druid事务管理通过Transactional注解实现所有 DAO 层操作均走 MyBatis 的SqlSessionTemplate。3.1 数据库设计关键约束与seat_status字段的业务语义MySQL 表结构中seat表的status字段不是简单的 0/1 开关而是四态枚举status含义是否可预约是否计入统计0空闲是是1已预约否是2维护中否否3已占用未释放否是该设计支撑了“预约后 15 分钟未签到自动释放”功能。对应 MyBatis 的SeatMapper.xml中查询可用座位的 SQL 使用CASE WHEN动态过滤!-- SeatMapper.xml -- select idselectAvailableSeats resultTypeSeat SELECT * FROM seat WHERE room_id #{roomId} AND status IN (0, 3) !-- 空闲和已占用状态才参与预约 -- AND id NOT IN ( SELECT seat_id FROM reservation WHERE DATE(reserve_time) CURDATE() AND status IN (0, 1) !-- 今日已预约且未取消/未过期 -- ) /select提示CURDATE()函数确保只排除当天预约记录避免历史数据干扰。若需支持跨天预约如提前 3 天需将CURDATE()替换为#{reserveDate}参数并在 Java 方法中传入LocalDate.now().plusDays(3)。3.2 预约接口的分布式锁防重放设计ReservationController.java中的createReservation方法表面看只是插入一条记录实则包含三重校验前端时间戳校验请求携带timestamp参数后端比对与服务器时间差是否超过 5 分钟Redis 分布式锁以lock:seat:${seatId}:${date}为 key设置过期时间 10 秒防止同一座位被并发抢占数据库唯一索引兜底reservation表在(seat_id, reserve_date, session_id)上建联合唯一索引。// ReservationService.java 片段 public Result createReservation(Reservation reservation) { // 1. 时间戳校验 long clientTime reservation.getTimestamp(); long serverTime System.currentTimeMillis(); if (Math.abs(serverTime - clientTime) 5 * 60 * 1000) { return Result.fail(请求超时); } // 2. Redis 锁 String lockKey lock:seat: reservation.getSeatId() : reservation.getReserveDate(); Boolean isLocked redisTemplate.opsForValue().setIfAbsent(lockKey, 1, 10, TimeUnit.SECONDS); if (!isLocked) { return Result.fail(座位正被他人预约请稍后再试); } try { // 3. 数据库插入唯一索引自动拦截重复 int rows reservationMapper.insert(reservation); return rows 0 ? Result.success() : Result.fail(预约失败); } finally { redisTemplate.delete(lockKey); // 必须释放锁 } }3.3 管理员后台的 MyBatis 分页插件配置细节项目使用 PageHelper 5.1.10非最新版其配置在mybatis-config.xml中plugins plugin interceptorcom.github.pagehelper.PageInterceptor property namedialect valuemysql/ property namerowBoundsWithCount valuetrue/ property nameoffsetAsPageNum valuetrue/ /plugin /plugins关键参数说明dialectmysql指定方言避免在 Oracle 或 PostgreSQL 环境下 SQL 报错rowBoundsWithCounttrue开启 count 查询PageHelper.startPage(1,10)后执行select * from reservation会自动生成SELECT COUNT(*)语句offsetAsPageNumtrue允许用startPage(offset, pageSize)代替startPage(pageNum, pageSize)适配前端传来的偏移量。若发现分页总数为 0需检查PageHelper.startPage()是否在select语句之前调用且中间不能有其他数据库操作如insert、update否则分页上下文会被清空。4. 部署全流程从1-install.bat到3-build.bat的环境适配要点项目提供三个批处理脚本但它们不是“一键傻瓜式”而是针对 Windows JDK8 Tomcat7/8 环境定制。Linux/macOS 用户需手动转换命令且必须注意 MySQL 5.7 与 8.0 的协议差异。4.11-install.bat执行前的数据库准备清单该脚本本质是调用mysql -u root -p init.sql但前提是MySQL 5.7 必须启用sql_modeNO_ENGINE_SUBSTITUTION在my.ini中添加[mysqld] sql_modeSTRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION若使用 MySQL 8.0需额外关闭caching_sha2_password认证插件否则 JDBC 连接报Client does not support authentication protocolALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY your_password; FLUSH PRIVILEGES;init.sql中的存储引擎必须显式声明项目 SQL 脚本中所有CREATE TABLE语句末尾均有ENGINEInnoDB DEFAULT CHARSETutf8mb4;不可省略。utf8mb4支持 emoji 和生僻字若用utf8会导致微信昵称存入乱码。4.22-run.bat启动失败的三大高频原因及修复命令Tomcat 启动报错常见于以下场景错误现象根本原因修复命令java.lang.ClassNotFoundException: org.springframework.web.servlet.DispatcherServletMaven 依赖未打入WEB-INF/lib运行mvn clean package -Dmaven.test.skiptrue后确认target/xxx/WEB-INF/lib下存在spring-webmvc-5.2.3.RELEASE.jarCaused by: java.sql.SQLException: Access denied for user rootlocalhostapplication.properties中数据库密码错误修改src/main/resources/application.propertiesjdbc.passwordyour_real_passwordSEVERE: Error filterStartweb.xml中CharacterEncodingFilter编码未设为 UTF-8在web.xml的filter标签下添加init-paramparam-nameencoding/param-nameparam-valueUTF-8/param-value/init-param4.33-build.bat构建小程序包的路径映射规则该脚本调用npm run build:weixin其package.json中定义scripts: { build:weixin: vue-cli-service build --mode weixin --dest dist/weixin }构建产物dist/weixin目录结构必须严格匹配微信开发者工具的项目根目录dist/weixin/ ├── app.js # 入口文件 ├── app.json # 页面路径配置 ├── project.config.json # 工具配置 └── pages/ └── index/ ├── index.js ├── index.wxml └── index.wxss若微信开发者工具提示“找不到 app.js”说明--dest路径错误需检查vue.config.js中outputDir是否为dist/weixin且project.config.json的miniprogramRoot字段值为./。5. 实战调试技巧用 Chrome DevTools 捕获小程序网络请求并定位后端 500 错误当小程序点击“预约”按钮无响应或提示“服务器内部错误”不要急于重装环境先用 Chrome DevTools 抓取真实请求链路。该技巧绕过微信开发者工具的代理限制直击 Tomcat 日志源头。5.1 启用 Tomcat 访问日志并定位异常请求在conf/server.xml的Host标签下添加Valve classNameorg.apache.catalina.valves.AccessLogValve directorylogs prefixlocalhost_access_log. suffix.txt pattern%h %l %u %t quot;%rquot; %s %b %D %{User-Agent}i /重启 Tomcat 后访问http://localhost:8080/user/login触发一次登录查看logs/localhost_access_log.2024-06-15.txt找到类似行127.0.0.1 - - [15/Jun/2024:14:22:33 0800] POST /reservation/create HTTP/1.1 500 1122 123 Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36其中500表示服务器错误123是耗时毫秒数1122是响应体字节数。接着查logs/catalina.out搜索14:22:33时间戳附近的堆栈Caused by: com.mysql.jdbc.exceptions.jdbc4.MySQLIntegrityConstraintViolationException: Duplicate entry 1001-2024-06-15-1 for key uk_seat_date_session这说明唯一索引冲突对应reservation表的(seat_id, reserve_date, session_id)联合索引。此时回到前端检查createReservation请求体中的session_id是否重复生成。5.2 微信小程序真机调试的抓包替代方案由于burp suite或charles无法直接抓取微信客户端流量采用“服务端打点 前端日志”双通道定位后端增加请求日志切面在com.xxx.aspect.LogAspect.java中添加Around(execution(* com.xxx.controller..*.*(..))) public Object logExecutionTime(ProceedingJoinPoint joinPoint) throws Throwable { long start System.currentTimeMillis(); Object proceed joinPoint.proceed(); long executionTime System.currentTimeMillis() - start; logger.info({} executed in {} ms with args {}, joinPoint.getSignature(), executionTime, Arrays.toString(joinPoint.getArgs())); return proceed; }小程序前端开启wx.setEnableDebug在app.js的onLaunch中添加if (wx.setEnableDebug) { wx.setEnableDebug({ enableDebug: true }); }然后在微信开发者工具控制台输入console.log(debug info)即可看到详细日志。5.3 MySQL 死锁排查从show engine innodb status提取关键信息当多个用户同时预约同一楼层座位时可能出现Deadlock found when trying to get lock错误。执行SHOW ENGINE INNODB STATUS\G重点关注LATEST DETECTED DEADLOCK部分提取TRANSACTIONID 和WAITING FOR THIS LOCK TO BE GRANTED的 SQL。例如*** (1) WAITING FOR THIS LOCK TO BE GRANTED: RECORD LOCKS space id 108 page no 3 n bits 72 index PRIMARY of table reserve.seat trx id 123456789 lock_mode X locks rec but not gap waiting说明事务 123456789 在等待seat表主键上的排他锁。此时应检查SeatService.updateStatus()方法是否在Transactional内执行了SELECT ... FOR UPDATE且锁范围过大如未加WHERE id ?条件导致锁整表。优化方案是缩小锁粒度或改用乐观锁version字段 UPDATE ... SET status 1, version version 1 WHERE id ? AND version ?。本文还有配套的精品资源点击获取