简介一套基于Spring、SpringMVC与MyBatis框架的乒乓球管理系统源码配套微信小程序端。项目面向毕业设计学生、Java Web开发学习者和微信小程序开发者覆盖用户管理、场地预约、赛事安排、积分统计等完整业务模块能有效帮助理解SSM框架整合流程与前后端交互逻辑。压缩包内共有两千个文件整体大小约为三十五点八二兆字节。主要文件类型包括Java后端源码、Vue前端组件、JavaScript脚本、小程序WXML页面和WXSS样式以及数据库SQL脚本、XML配置、样式表、图片和说明文档等目录结构清晰便于按模块查阅。目前已有150人学习或下载。该源码最大的价值在于整套源码可直接导入常用开发工具运行便于观察Spring容器管理、MyBatis动态SQL、SpringMVC请求分发等关键机制小程序端可学习WXML布局与JavaScript业务逻辑配合。包内还附有备份文件、Markdown说明等辅助资料适合用于毕业设计参考、二次开发或课程项目答辩。1. 一个SSM后台加小程序前端乒乓球馆预约可以这样拆接手过一个乒乓球馆的管理需求场地档期排班靠Excel会员预约靠微信群接龙赛事积分靠手工记。当时的第一反应是做个后台管理系统但教练和球友真正想要的是“手机上看场地、点一下就能约”。于是这套基于 SSMSpring SpringMVC MyBatis的乒乓球管理系统配微信小程序前端的方案就成型了。它解决的核心问题有三类场地档期可视化与预约冲突避免、赛事报名与积分统计的线上化、以及管理员后台对会员和订单的统一管理。对做毕业设计或JavaWeb课程设计的同学来说这套源码的价值在于三层架构分工清楚、MyBatis动态SQL处理条件查询很典型、小程序端从登录到支付闭环完整可以直接照着改。2. SSM架构分层与乒乓球场馆数据模型设计2.1 SSM三个组件在系统中的职责切分在拆这套系统之前先把SSM的边界定清楚。Spring是容器负责管理Service层对象的创建和依赖注入比如场地预约Service要被Controller引用不需要手动new全部交给Spring IoC容器装配SpringMVC是Web层入口接收小程序端发来的HTTP请求通过DispatcherServlet把请求映射到对应的Controller方法再返回JSON数据MyBatis负责持久化把Java对象与数据库表字段做映射。项目中五个核心模块——用户管理、场地预约、赛事安排、积分统计、公告发布——都遵循Controller调Service、Service调Mapper、Mapper写SQL的链路。一个典型例子是场地预约小程序端提交预约请求Controller层接收参数并做基础校验Service层判断该场地该时间段是否已被占用需要查预约表再调用Mapper执行插入同时记录一条操作日志。权限控制通过拦截器实现管理员请求会校验Session或Token这一步就是在SpringMVC的拦截器里完成的。2.2 核心表结构设计数据库设计直接决定后续动态SQL的复杂度。下面的建表语句是工程里最常用的五张表字段上做了精简保留了关键业务字段。CREATE TABLE venue ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL COMMENT 场地名称如1号台, type TINYINT DEFAULT 1 COMMENT 1-普通台 2-VIP台, price DECIMAL(6,2) DEFAULT 20.00 COMMENT 每小时价格, status TINYINT DEFAULT 0 COMMENT 0-可预约 1-维护中 ); CREATE TABLE reservation ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL COMMENT 预约用户ID, venue_id INT NOT NULL COMMENT 场地ID, start_time DATETIME NOT NULL, end_time DATETIME NOT NULL, status TINYINT DEFAULT 0 COMMENT 0-待支付 1-已确认 2-已取消, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE match_info ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(100) NOT NULL COMMENT 赛事名称, sign_start DATETIME NOT NULL, sign_end DATETIME NOT NULL, match_time DATETIME NOT NULL, max_players INT DEFAULT 16 COMMENT 报名上限 );表之间的关联很直接reservation通过user_id关联用户表、venue_id关联场地表match_info与报名记录表是一对多关系。这里的核心设计点有两个第一场地状态与预约状态分开存场地status表示当前是否可约预约status表示某条预约单的流转状态避免用一个字段表达两种含义第二预约时间段用start_time和end_time两个字段而不是单存日期这样查询“某天某时段冲突”时可以走范围判断后续MyBatis动态SQL写起来也更直观。2.3 Maven项目骨架与依赖版本选择工程结构按maven标准布局划分src/main/java下分controller、service、mapper、entity四个包resources下放Spring配置、MyBatis映射文件和数据库连接配置。对于SSM项目一个容易踩的坑是Spring与MyBatis的版本兼容问题我常用的组合是Spring 5.1.x MyBatis 3.5.x mybatis-spring 2.0.xMaven编译器指向JDK 1.8。dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.1.20.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.1.20.RELEASE/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.5.6/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.6/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version5.1.49/version /dependency dependency groupIdcom.alibaba/groupId artifactIddruid/artifactId version1.2.8/version /dependency /dependencies上述坐标中druid连接池用于统一管理数据库连接监控SQL执行情况mysql驱动版本需要和自己本机的MySQL对应MySQL 5.7用5.1.x或8.0.x都可以但MySQL 8.0建议换驱动并加serverTimezoneAsia/Shanghai参数。Spring配置里要开启注解驱动和组件扫描否则Controller上的RequestMapping不会被识别。3. 后端核心接口实现与MyBatis动态SQL应用3.1 Controller层接口设计与请求流转小程序端的所有操作最后都落在HTTP接口上。下表整理了这个系统中几个关键接口的定义字段命名要和前端联调时保持严格一致接口路径方法入参说明/api/venue/listGETtype可选按类型获取场地列表及当日预约状态/api/reservation/submitPOSTuserId、venueId、startTime、endTime提交预约并扣减支付金额/api/reservation/myListGETuserId当前用户的预约记录/api/match/signupPOSTuserId、matchId赛事报名/api/admin/venue/updatePUT场地表单管理员修改场地状态或价格以提交预约接口为例Controller接收JSON参数后先做非空与时间先后校验再调Service执行核心逻辑。这里要说明一个容易忽略的点前端传过来的userId不能直接作为可信身份生产环境应从小程序登录态换取的用户身份中获取。毕设阶段如果不想引入完整的OAuth流程至少要在拦截器里校验Token并取出用户ID后覆盖请求参数。RestController RequestMapping(/api/reservation) public class ReservationController { Autowired private ReservationService reservationService; PostMapping(/submit) public Result submit(RequestBody ReservationDTO dto, HttpServletRequest request) { // 从请求头获取token并解析出用户ID避免前端传参伪造 String token request.getHeader(Authorization); Integer userId JwtUtil.parseToken(token); if (userId null) { return Result.error(401, 登录状态过期); } ReservationVO vo reservationService.submitReservation( userId, dto.getVenueId(), dto.getStartTime(), dto.getEndTime()); return Result.success(vo); } }这段代码里有两个关键设计。第一用RestController直接返回对象SpringMVC会通过Jackson自动序列化为JSON第二JWT解析的userId优先于前端传入的userId避免越权操作。Service返回的ReservationVO中包含预约单ID和待支付金额小程序端拿到后直接调起支付。3.2 Service层事务与冲突检测预约接口最容易出现的是超卖问题两人同时抢同一个场地同一时间段。解决方案是加数据库唯一索引配合悲观锁或乐观锁。下面的Service代码采用悲观锁方案selectForUpdate会在事务内锁定满足条件的行直到提交后才释放。Service public class ReservationServiceImpl implements ReservationService { Autowired private ReservationMapper reservationMapper; Autowired private VenueMapper venueMapper; Override Transactional(rollbackFor Exception.class) public ReservationVO submitReservation(Integer userId, Integer venueId, Date startTime, Date endTime) { // 检查场地是否存在且可预约 Venue venue venueMapper.selectByIdForUpdate(venueId); if (venue null || venue.getStatus() 1) { throw new BizException(场地不存在或维护中); } // 查询该场地该时间段是否已有冲突预约 int count reservationMapper.countConflict(venueId, startTime, endTime); if (count 0) { throw new BizException(该时段已被预约); } // 插入预约记录初始状态为待支付 Reservation reservation new Reservation(); reservation.setUserId(userId); reservation.setVenueId(venueId); reservation.setStartTime(startTime); reservation.setEndTime(endTime); reservation.setStatus(0); reservationMapper.insert(reservation); return new ReservationVO(reservation.getId(), venue.getPrice()); } }Transactional保证了冲突检测和插入操作在同一条数据库连接中执行配合selectByIdForUpdate的行锁避免并发下产生双重预约。rollbackFor Exception.class的意思是遇到任何异常都回滚不要只在遇到RuntimeException时才回滚。countConflict这条SQL在做范围重叠判断查询条件是start_time #{endTime} AND end_time #{startTime}这个条件也适用于场地不跨天的情况。3.3 MyBatis动态SQL处理多条件筛选后台管理端最常用的功能是按条件筛选预约记录比如按时间范围、场地类型、订单状态组合查询。如果为每个组合写一条SQL会产生大量重复代码。MyBatis的where和if标签比多条件字符串拼接更安全不会出现多余的WHERE或AND。select idselectReservationList resultTypemap SELECT r.id, u.nickname, v.name AS venue_name, r.start_time, r.end_time, r.status, r.create_time FROM reservation r LEFT JOIN user u ON r.user_id u.id LEFT JOIN venue v ON r.venue_id v.id where if testvenueType ! null and venueType ! AND v.type #{venueType} /if if teststatus ! null AND r.status #{status} /if if teststartDate ! null and startDate ! AND r.start_time gt; #{startDate} /if if testendDate ! null and endDate ! AND r.end_time lt; #{endDate} /if /where ORDER BY r.create_time DESC LIMIT #{offset}, #{pageSize} /select这段XML中where标签会自动判断子条件内是否为空若为空则去掉整个WHERE关键字若不为空则自动去掉第一个多余的AND。时间比较运算符和在XML中需要转义为gt;与lt;否则XML解析报错。利用这套动态SQL后端只需要写一个Mapper方法前端传多传少都能得到正确结果。4. 微信小程序端登录授权与预约流程实现4.1 小程序项目结构与基础配置小程序端的技术结构相对固定WXML负责页面结构、WXSS负责样式、JS负责业务逻辑与请求发送app.json配置页面路由和导航栏。这个项目中用到的页面包括首页场地列表、预约页、我的预约页、赛事活动页、个人中心页。开发之前先在微信公众平台申请测试号获取AppID和AppSecret然后在项目的app.js中做全局配置。utils/request.js封装通用的网络请求方法请求头统一带上登录后获取的Token。// utils/request.js const BASE_URL https://your-server.com/api; function request(path, method, data, token) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL path, method: method, data: data, header: { Content-Type: application/json, Authorization: token || }, success: (res) { if (res.statusCode 401) { wx.navigateTo({ url: /pages/login/login }); reject(res.data); } else if (res.statusCode 200 res.data.code 0) { resolve(res.data.data); } else { wx.showToast({ title: res.data.msg, icon: none }); reject(res.data); } }, fail: (err) reject(err) }); }); }后端约定统一响应格式成功时code为0data携带业务数据。这样小程序端的每个业务方法只需要专注处理数据不需要重复写错误分支。4.2 微信登录换取服务端Session小程序登录的官方流程是wx.login获取临时code把code传到后端后端调用微信接口换取openid和session_key再生成自己的Token返回给小程序。openid是用户在小程序内的唯一标识服务端用它关联本地用户表。// pages/login/login.js wx.login({ success: (res) { if (res.code) { request(/auth/login, POST, { code: res.code }) .then(data { wx.setStorageSync(token, data.token); wx.setStorageSync(userId, data.userId); wx.switchTab({ url: /pages/index/index }); }); } } });后端收到code后的逻辑是用AppID AppSecret code向https://api.weixin.qq.com/sns/jscode2session发起GET请求换取openid拿到openid后查询或新建用户记录最终生成包含userId的JWT返回。注意AppSecret只能放在服务端不能让小程序端直接请求这个接口否则会出现AppSecret泄露导致任意登录。4.3 场地预约页面的实现细节预约页是这个项目中交互最复杂的页面。需要展示场地列表、当前预约状态并提供日期与时间段的选择。时间段采用picker组件配合range数组日期通过modedate限定今天及未来三天。picker modedate start{{today}} bindchangeonDateChange view classdate-picker{{selectedDate}}/view /picker picker modeselector range{{timeSlots}} bindchangeonTimeChange view classtime-picker{{selectedTime || 选择时间段}}/view /picker button typeprimary bindtapsubmitReservation disabled{{!canSubmit}} 提交预约 /buttonJS中timeSlots按固定间隔生成比如从08:00到21:00每1小时一个档位。提交前先校验时间段再显示预约金额确认弹窗。submitReservation() { const token wx.getStorageSync(token); const data { venueId: this.data.selectedVenueId, startTime: ${this.data.selectedDate} ${this.data.selectedTime}:00, endTime: this.calculateEndTime(this.data.selectedTime) }; request(/reservation/submit, POST, data, token) .then(res { wx.showModal({ title: 预约成功, content: 订单号${res.reservationId}请完成支付, showCancel: false, confirmText: 去支付 }); }); }startTime和endTime采用YYYY-MM-DD HH:mm:ss格式传给后端后端直接存DATETIME类型。这里有一个容易踩的坑小程序端Date.parse在iOS上不支持2024-01-01 08:00:00这种带横杠的格式需要先替换为斜杠再解析或者让后端统一返回时间字符串。5. 安全加固与上线前的关键验证清单最后整理几个这套系统上线前必须处理的点每一项都直接影响系统能否在真实环境中运行。SQL注入防御方面MyBatis中#{}和${}的差异要清楚——#{}是预编译参数占位符SQL注入攻击传什么都会被当作字符串处理所以全部查询、插入、更新都应该用#{}。${}会被直接拼接进SQL语句动态排序列名时用${}一定要做白名单校验。XSS防护方面后端在接收用户昵称、公告内容等输入时进行HTML标签过滤可以用Jsoup的Jsoup.clean()把危险标签剥离掉再入库。小程序请求合法域名方面在微信公众平台后台配置request合法域名时需满足HTTPS协议且证书链完整。本地开发是调试后端接口要在开发者工具中勾选“不校验合法域名、web-view业务域名、TLS版本以及HTTPS证书”。生产环境如果使用自签名证书浏览器和微信都会直接拒绝请求。下面这张自测表我每次部署SSM项目都会过一遍检查项验证方式常见失败原因数据库连接池初始化启动日志搜索DruidDataSource initMySQL服务未启动或账号密码错静态资源映射访问/static/index.htmlWebMvcConfig未继承WebMvcConfigurationSupport登录拦截白名单未登录访问/api/venue/list拦截器放行路径未加/api/auth/**事务回滚造一个插入异常触发回滚Mapper方法未被Spring代理需检查ComponentScan日志排查时重点看Tomcat catalina.out中的异常堆栈MyBatis报错通常会给出SQL语句和参数列表可以复制到Navicat里手动执行对比结果。最后一个实用技巧在本地联调时配合Charles抓包查看小程序的HTTP请求能快速定位前端传参格式和后端期望不一致的问题。抓包时注意小程序端默认不开代理需要在微信开发者工具中设置代理指向Charles的端口。前端报错时打开开发者工具的Network面板过滤器切到Fetch/XHR直接看接口返回的Response Body比自己猜更快。系统上线后把Spring的日志级别调成WARN避免生产环境日志中刷满SQL语句导致性能退化。本文还有配套的精品资源点击获取 基于SSM与微信小程序的乒乓球馆预约系统设计与实现
简介一套基于Spring、SpringMVC与MyBatis框架的乒乓球管理系统源码配套微信小程序端。项目面向毕业设计学生、Java Web开发学习者和微信小程序开发者覆盖用户管理、场地预约、赛事安排、积分统计等完整业务模块能有效帮助理解SSM框架整合流程与前后端交互逻辑。压缩包内共有两千个文件整体大小约为三十五点八二兆字节。主要文件类型包括Java后端源码、Vue前端组件、JavaScript脚本、小程序WXML页面和WXSS样式以及数据库SQL脚本、XML配置、样式表、图片和说明文档等目录结构清晰便于按模块查阅。目前已有150人学习或下载。该源码最大的价值在于整套源码可直接导入常用开发工具运行便于观察Spring容器管理、MyBatis动态SQL、SpringMVC请求分发等关键机制小程序端可学习WXML布局与JavaScript业务逻辑配合。包内还附有备份文件、Markdown说明等辅助资料适合用于毕业设计参考、二次开发或课程项目答辩。1. 一个SSM后台加小程序前端乒乓球馆预约可以这样拆接手过一个乒乓球馆的管理需求场地档期排班靠Excel会员预约靠微信群接龙赛事积分靠手工记。当时的第一反应是做个后台管理系统但教练和球友真正想要的是“手机上看场地、点一下就能约”。于是这套基于 SSMSpring SpringMVC MyBatis的乒乓球管理系统配微信小程序前端的方案就成型了。它解决的核心问题有三类场地档期可视化与预约冲突避免、赛事报名与积分统计的线上化、以及管理员后台对会员和订单的统一管理。对做毕业设计或JavaWeb课程设计的同学来说这套源码的价值在于三层架构分工清楚、MyBatis动态SQL处理条件查询很典型、小程序端从登录到支付闭环完整可以直接照着改。2. SSM架构分层与乒乓球场馆数据模型设计2.1 SSM三个组件在系统中的职责切分在拆这套系统之前先把SSM的边界定清楚。Spring是容器负责管理Service层对象的创建和依赖注入比如场地预约Service要被Controller引用不需要手动new全部交给Spring IoC容器装配SpringMVC是Web层入口接收小程序端发来的HTTP请求通过DispatcherServlet把请求映射到对应的Controller方法再返回JSON数据MyBatis负责持久化把Java对象与数据库表字段做映射。项目中五个核心模块——用户管理、场地预约、赛事安排、积分统计、公告发布——都遵循Controller调Service、Service调Mapper、Mapper写SQL的链路。一个典型例子是场地预约小程序端提交预约请求Controller层接收参数并做基础校验Service层判断该场地该时间段是否已被占用需要查预约表再调用Mapper执行插入同时记录一条操作日志。权限控制通过拦截器实现管理员请求会校验Session或Token这一步就是在SpringMVC的拦截器里完成的。2.2 核心表结构设计数据库设计直接决定后续动态SQL的复杂度。下面的建表语句是工程里最常用的五张表字段上做了精简保留了关键业务字段。CREATE TABLE venue ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL COMMENT 场地名称如1号台, type TINYINT DEFAULT 1 COMMENT 1-普通台 2-VIP台, price DECIMAL(6,2) DEFAULT 20.00 COMMENT 每小时价格, status TINYINT DEFAULT 0 COMMENT 0-可预约 1-维护中 ); CREATE TABLE reservation ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL COMMENT 预约用户ID, venue_id INT NOT NULL COMMENT 场地ID, start_time DATETIME NOT NULL, end_time DATETIME NOT NULL, status TINYINT DEFAULT 0 COMMENT 0-待支付 1-已确认 2-已取消, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE match_info ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(100) NOT NULL COMMENT 赛事名称, sign_start DATETIME NOT NULL, sign_end DATETIME NOT NULL, match_time DATETIME NOT NULL, max_players INT DEFAULT 16 COMMENT 报名上限 );表之间的关联很直接reservation通过user_id关联用户表、venue_id关联场地表match_info与报名记录表是一对多关系。这里的核心设计点有两个第一场地状态与预约状态分开存场地status表示当前是否可约预约status表示某条预约单的流转状态避免用一个字段表达两种含义第二预约时间段用start_time和end_time两个字段而不是单存日期这样查询“某天某时段冲突”时可以走范围判断后续MyBatis动态SQL写起来也更直观。2.3 Maven项目骨架与依赖版本选择工程结构按maven标准布局划分src/main/java下分controller、service、mapper、entity四个包resources下放Spring配置、MyBatis映射文件和数据库连接配置。对于SSM项目一个容易踩的坑是Spring与MyBatis的版本兼容问题我常用的组合是Spring 5.1.x MyBatis 3.5.x mybatis-spring 2.0.xMaven编译器指向JDK 1.8。dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.1.20.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.1.20.RELEASE/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.5.6/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.6/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version5.1.49/version /dependency dependency groupIdcom.alibaba/groupId artifactIddruid/artifactId version1.2.8/version /dependency /dependencies上述坐标中druid连接池用于统一管理数据库连接监控SQL执行情况mysql驱动版本需要和自己本机的MySQL对应MySQL 5.7用5.1.x或8.0.x都可以但MySQL 8.0建议换驱动并加serverTimezoneAsia/Shanghai参数。Spring配置里要开启注解驱动和组件扫描否则Controller上的RequestMapping不会被识别。3. 后端核心接口实现与MyBatis动态SQL应用3.1 Controller层接口设计与请求流转小程序端的所有操作最后都落在HTTP接口上。下表整理了这个系统中几个关键接口的定义字段命名要和前端联调时保持严格一致接口路径方法入参说明/api/venue/listGETtype可选按类型获取场地列表及当日预约状态/api/reservation/submitPOSTuserId、venueId、startTime、endTime提交预约并扣减支付金额/api/reservation/myListGETuserId当前用户的预约记录/api/match/signupPOSTuserId、matchId赛事报名/api/admin/venue/updatePUT场地表单管理员修改场地状态或价格以提交预约接口为例Controller接收JSON参数后先做非空与时间先后校验再调Service执行核心逻辑。这里要说明一个容易忽略的点前端传过来的userId不能直接作为可信身份生产环境应从小程序登录态换取的用户身份中获取。毕设阶段如果不想引入完整的OAuth流程至少要在拦截器里校验Token并取出用户ID后覆盖请求参数。RestController RequestMapping(/api/reservation) public class ReservationController { Autowired private ReservationService reservationService; PostMapping(/submit) public Result submit(RequestBody ReservationDTO dto, HttpServletRequest request) { // 从请求头获取token并解析出用户ID避免前端传参伪造 String token request.getHeader(Authorization); Integer userId JwtUtil.parseToken(token); if (userId null) { return Result.error(401, 登录状态过期); } ReservationVO vo reservationService.submitReservation( userId, dto.getVenueId(), dto.getStartTime(), dto.getEndTime()); return Result.success(vo); } }这段代码里有两个关键设计。第一用RestController直接返回对象SpringMVC会通过Jackson自动序列化为JSON第二JWT解析的userId优先于前端传入的userId避免越权操作。Service返回的ReservationVO中包含预约单ID和待支付金额小程序端拿到后直接调起支付。3.2 Service层事务与冲突检测预约接口最容易出现的是超卖问题两人同时抢同一个场地同一时间段。解决方案是加数据库唯一索引配合悲观锁或乐观锁。下面的Service代码采用悲观锁方案selectForUpdate会在事务内锁定满足条件的行直到提交后才释放。Service public class ReservationServiceImpl implements ReservationService { Autowired private ReservationMapper reservationMapper; Autowired private VenueMapper venueMapper; Override Transactional(rollbackFor Exception.class) public ReservationVO submitReservation(Integer userId, Integer venueId, Date startTime, Date endTime) { // 检查场地是否存在且可预约 Venue venue venueMapper.selectByIdForUpdate(venueId); if (venue null || venue.getStatus() 1) { throw new BizException(场地不存在或维护中); } // 查询该场地该时间段是否已有冲突预约 int count reservationMapper.countConflict(venueId, startTime, endTime); if (count 0) { throw new BizException(该时段已被预约); } // 插入预约记录初始状态为待支付 Reservation reservation new Reservation(); reservation.setUserId(userId); reservation.setVenueId(venueId); reservation.setStartTime(startTime); reservation.setEndTime(endTime); reservation.setStatus(0); reservationMapper.insert(reservation); return new ReservationVO(reservation.getId(), venue.getPrice()); } }Transactional保证了冲突检测和插入操作在同一条数据库连接中执行配合selectByIdForUpdate的行锁避免并发下产生双重预约。rollbackFor Exception.class的意思是遇到任何异常都回滚不要只在遇到RuntimeException时才回滚。countConflict这条SQL在做范围重叠判断查询条件是start_time #{endTime} AND end_time #{startTime}这个条件也适用于场地不跨天的情况。3.3 MyBatis动态SQL处理多条件筛选后台管理端最常用的功能是按条件筛选预约记录比如按时间范围、场地类型、订单状态组合查询。如果为每个组合写一条SQL会产生大量重复代码。MyBatis的where和if标签比多条件字符串拼接更安全不会出现多余的WHERE或AND。select idselectReservationList resultTypemap SELECT r.id, u.nickname, v.name AS venue_name, r.start_time, r.end_time, r.status, r.create_time FROM reservation r LEFT JOIN user u ON r.user_id u.id LEFT JOIN venue v ON r.venue_id v.id where if testvenueType ! null and venueType ! AND v.type #{venueType} /if if teststatus ! null AND r.status #{status} /if if teststartDate ! null and startDate ! AND r.start_time gt; #{startDate} /if if testendDate ! null and endDate ! AND r.end_time lt; #{endDate} /if /where ORDER BY r.create_time DESC LIMIT #{offset}, #{pageSize} /select这段XML中where标签会自动判断子条件内是否为空若为空则去掉整个WHERE关键字若不为空则自动去掉第一个多余的AND。时间比较运算符和在XML中需要转义为gt;与lt;否则XML解析报错。利用这套动态SQL后端只需要写一个Mapper方法前端传多传少都能得到正确结果。4. 微信小程序端登录授权与预约流程实现4.1 小程序项目结构与基础配置小程序端的技术结构相对固定WXML负责页面结构、WXSS负责样式、JS负责业务逻辑与请求发送app.json配置页面路由和导航栏。这个项目中用到的页面包括首页场地列表、预约页、我的预约页、赛事活动页、个人中心页。开发之前先在微信公众平台申请测试号获取AppID和AppSecret然后在项目的app.js中做全局配置。utils/request.js封装通用的网络请求方法请求头统一带上登录后获取的Token。// utils/request.js const BASE_URL https://your-server.com/api; function request(path, method, data, token) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL path, method: method, data: data, header: { Content-Type: application/json, Authorization: token || }, success: (res) { if (res.statusCode 401) { wx.navigateTo({ url: /pages/login/login }); reject(res.data); } else if (res.statusCode 200 res.data.code 0) { resolve(res.data.data); } else { wx.showToast({ title: res.data.msg, icon: none }); reject(res.data); } }, fail: (err) reject(err) }); }); }后端约定统一响应格式成功时code为0data携带业务数据。这样小程序端的每个业务方法只需要专注处理数据不需要重复写错误分支。4.2 微信登录换取服务端Session小程序登录的官方流程是wx.login获取临时code把code传到后端后端调用微信接口换取openid和session_key再生成自己的Token返回给小程序。openid是用户在小程序内的唯一标识服务端用它关联本地用户表。// pages/login/login.js wx.login({ success: (res) { if (res.code) { request(/auth/login, POST, { code: res.code }) .then(data { wx.setStorageSync(token, data.token); wx.setStorageSync(userId, data.userId); wx.switchTab({ url: /pages/index/index }); }); } } });后端收到code后的逻辑是用AppID AppSecret code向https://api.weixin.qq.com/sns/jscode2session发起GET请求换取openid拿到openid后查询或新建用户记录最终生成包含userId的JWT返回。注意AppSecret只能放在服务端不能让小程序端直接请求这个接口否则会出现AppSecret泄露导致任意登录。4.3 场地预约页面的实现细节预约页是这个项目中交互最复杂的页面。需要展示场地列表、当前预约状态并提供日期与时间段的选择。时间段采用picker组件配合range数组日期通过modedate限定今天及未来三天。picker modedate start{{today}} bindchangeonDateChange view classdate-picker{{selectedDate}}/view /picker picker modeselector range{{timeSlots}} bindchangeonTimeChange view classtime-picker{{selectedTime || 选择时间段}}/view /picker button typeprimary bindtapsubmitReservation disabled{{!canSubmit}} 提交预约 /buttonJS中timeSlots按固定间隔生成比如从08:00到21:00每1小时一个档位。提交前先校验时间段再显示预约金额确认弹窗。submitReservation() { const token wx.getStorageSync(token); const data { venueId: this.data.selectedVenueId, startTime: ${this.data.selectedDate} ${this.data.selectedTime}:00, endTime: this.calculateEndTime(this.data.selectedTime) }; request(/reservation/submit, POST, data, token) .then(res { wx.showModal({ title: 预约成功, content: 订单号${res.reservationId}请完成支付, showCancel: false, confirmText: 去支付 }); }); }startTime和endTime采用YYYY-MM-DD HH:mm:ss格式传给后端后端直接存DATETIME类型。这里有一个容易踩的坑小程序端Date.parse在iOS上不支持2024-01-01 08:00:00这种带横杠的格式需要先替换为斜杠再解析或者让后端统一返回时间字符串。5. 安全加固与上线前的关键验证清单最后整理几个这套系统上线前必须处理的点每一项都直接影响系统能否在真实环境中运行。SQL注入防御方面MyBatis中#{}和${}的差异要清楚——#{}是预编译参数占位符SQL注入攻击传什么都会被当作字符串处理所以全部查询、插入、更新都应该用#{}。${}会被直接拼接进SQL语句动态排序列名时用${}一定要做白名单校验。XSS防护方面后端在接收用户昵称、公告内容等输入时进行HTML标签过滤可以用Jsoup的Jsoup.clean()把危险标签剥离掉再入库。小程序请求合法域名方面在微信公众平台后台配置request合法域名时需满足HTTPS协议且证书链完整。本地开发是调试后端接口要在开发者工具中勾选“不校验合法域名、web-view业务域名、TLS版本以及HTTPS证书”。生产环境如果使用自签名证书浏览器和微信都会直接拒绝请求。下面这张自测表我每次部署SSM项目都会过一遍检查项验证方式常见失败原因数据库连接池初始化启动日志搜索DruidDataSource initMySQL服务未启动或账号密码错静态资源映射访问/static/index.htmlWebMvcConfig未继承WebMvcConfigurationSupport登录拦截白名单未登录访问/api/venue/list拦截器放行路径未加/api/auth/**事务回滚造一个插入异常触发回滚Mapper方法未被Spring代理需检查ComponentScan日志排查时重点看Tomcat catalina.out中的异常堆栈MyBatis报错通常会给出SQL语句和参数列表可以复制到Navicat里手动执行对比结果。最后一个实用技巧在本地联调时配合Charles抓包查看小程序的HTTP请求能快速定位前端传参格式和后端期望不一致的问题。抓包时注意小程序端默认不开代理需要在微信开发者工具中设置代理指向Charles的端口。前端报错时打开开发者工具的Network面板过滤器切到Fetch/XHR直接看接口返回的Response Body比自己猜更快。系统上线后把Spring的日志级别调成WARN避免生产环境日志中刷满SQL语句导致性能退化。本文还有配套的精品资源点击获取