简介这套校园汉服租赁系统以SSM框架与微信小程序为核心面向Java后端开发、小程序开发及毕业设计/课程设计人群涵盖用户注册登录、汉服商品上架展示、租赁订单处理、第三方支付对接与后台数据维护等完整业务闭环适合用作毕设选题、课程项目或SSM整合实训的参考蓝本。压缩包共1133个文件包括java后端源码、vue后台管理页面、js小程序逻辑、wxml/wxss界面结构、sql数据库脚本以及png/svg切图资源附有install/run/build批处理脚本、数据库与配置文件压缩包仅16.86MB结构清晰便于快速导入运行。已有93人学习下载。项目在微信平台对接、订单状态流转、后台权限管理等模块均有可复用代码能帮助读者理解SSM三层架构与小程序前端的协同方式并可直接基于现有工程二次开发或改造扩展。1. 校园汉服租赁系统为什么值得用 SSM 做每年三月到六月高校里的汉服社、摄影协会和毕业季活动会把租赁需求推得很集中。纸质登记和表格排期撑不住这种短时高峰一个挂在微信平台上的校园汉服租赁系统就成了很现实的运维对象学生打开微信就能看款、预约、支付管理员在后端维护库存和档期。而 ssm 框架Spring Spring MVC MyBatis在高校和中小企业里存量极大资料多、招人容易和微信平台对接时也不需要刻意引入微服务一台 Tomcat 加一个 MySQL 实例就能把预约、订单、支付回调这些链路跑稳。这篇文章按我实际做这类项目的顺序从 SSM 三层职责拆起一直讲到部署后的排错技巧适合正在做课程设计、毕业设计或接手校内信息系统的同学。2. SSM 三层职责拆解微信平台的请求怎么穿过 Controller、Service、Mapper很多人在网上搜“ssm 框架”教程第一步就去看配置其实配置只是骨架真正决定系统能不能改的是职责边界。基于微信平台的校园汉服租赁系统请求链路上有三类角色微信端小程序或 H5、SSM 服务端、MySQL 数据库。微信端发请求Spring MVC 的 Controller 只负责接和返Service 负责拼业务规则MyBatis 的 Mapper 负责把 Java 对象映射成 SQL。下面一层一层拆。2.1 Controller 层只做参数接收与 JSON 输出我一般把 Controller 写得尽量薄里面不放任何租期计算和金额逻辑。微信端不管是小程序还是公众号 H5最终都是请求/api开头的接口后端返回统一 JSON 结构。RestController RequestMapping(/api/order) public class RentOrderController { private final RentOrderService rentOrderService; public RentOrderController(RentOrderService rentOrderService) { this.rentOrderService rentOrderService; } PostMapping(/create) public Result create(RequestBody RentOrderDTO dto, HttpServletRequest request) { String openid (String) request.getAttribute(openid); if (openid null) { return Result.fail(401, 未登录); } RentOrder order rentOrderService.createOrder(openid, dto); return Result.ok(order); } }这里有几个值得注意的参数约定路径前缀用/api加业务名方便后续小程序端升级后按版本兼容旧接口openid 不从前端传而是由拦截器在微信登录校验后写入 request 属性避免客户端伪造用户身份RentOrderDTO里只放服装编号、租借开始时间、结束时间、件数和备注金额不信任前端到 Service 层按价格表重算。2.1.1 接口统一返回体返回体用Result包装至少包含code、message、data三个字段。微信端拿到 code 后先判断成功还是失败不要在失败时强行解析 data。这样一个约定能让前端少写很多空值判断也方便后面接微信支付回调时直接复用同一套序列化逻辑。2.2 Service 层看住订单状态机租赁订单不像普通商品订单那么简单同一件汉服在重叠时间不能租给两个人用户可能下单后不付款管理员还要确认取衣和归还。这些规则放 Controller 会乱放 Mapper 又写不出必须在 Service 层用一个状态机管住。Transactional public RentOrder createOrder(String openid, RentOrderDTO dto) { LocalDateTime startTime dto.getStartTime(); LocalDateTime endTime dto.getEndTime(); if (!rentOrderMapper.isAvailable(dto.getCostumeId(), startTime, endTime)) { throw new BizException(该汉服在所选时段已被预约); } BigDecimal amount costumeMapper.selectPrice(dto.getCostumeId()); RentOrder order new RentOrder(); order.setOpenid(openid); order.setCostumeId(dto.getCostumeId()); order.setStartTime(startTime); order.setEndTime(endTime); order.setAmount(amount); order.setStatus(0); rentOrderMapper.insert(order); return order; }Transactional保证后续如果用户重复点击创建按钮不会插入两条一模一样的待支付订单。状态流转建议在数据库里也定义成约定而不是随意填字符串。状态值含义触发动作0待支付用户提交预约后生成超时未付自动取消1已支付 / 待取衣微信支付回调成功后置为 12租赁中管理员确认取衣后置为 23已归还管理员确认归还并检查无破损后置为 34已取消用户主动取消或超时未支付由定时任务关闭这套状态机要写成 Service 里的独立方法每一步都校验“当前状态是否允许跳到目标状态”比如状态 2 不能直接跳到状态 4。微信端的按钮显隐也根据这个字段判断前后端共用同一份语义表。2.3 Mapper 层用条件更新防超租很多租赁系统会犯一个错先select stock判断库存再update stock扣减。这个做法在低并发下能跑但遇上校园活动宣传后同一分钟几百人抢五一档期判断和扣减之间会发生超租。正确做法是把扣减条件放进 SQL。update iddeductStock UPDATE costume_copy SET stock stock - #{count} WHERE id #{costumeId} AND stock #{count} /updateUPDATE返回的影响行数只有 1 时才算扣减成功为 0 说明库存不足或这件汉服已下架Service 层直接抛业务异常。这条 SQL 看起来简单但对 MySQL 来说是一条原子操作比先查后改安全得多。再把时间段冲突查询也放在 Mapper 层SELECT COUNT(*) FROM rent_order WHERE costume_id #{costumeId} AND status IN (1, 2) AND start_time lt; #{endTime} AND end_time gt; #{startTime}判断结果大于 0 就说明这个时段已经被占了。注意条件是start_time 新结束时间 AND end_time 新开始时间这才是“两个区间重叠”的完整判断少写一个等于会漏掉边界情况。XML 里小于号要写成lt;这是 MyBatis 新手最容易踩的坑。3. 用 Maven 搭出可运行的 SSM 骨架依赖版本、Spring 配置与微信登录对接SSM 项目的搭建难点不在代码量而在版本协调。Spring 5.3 之前用javax.servletSpring 6 开始换jakarta.servlet微信平台很多老接口素材还停留在旧命名空间所以我建议新项目也不要盲目追新先让骨架稳定跑起来。3.1 Maven 依赖怎么锁定版本一个最小可跑的 SSM 工程核心依赖是 Spring、Spring MVC、MyBatis 和 MyBatis-Spring 桥接包。我会在pom.xml里把版本统一写在 properties 里避免多个 jar 版本不一致。properties spring.version5.3.39/spring.version mybatis.version3.5.16/mybatis.version mybatis-spring.version2.1.2/mybatis-spring.version /properties dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version${spring.version}/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version${spring.version}/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version${mybatis.version}/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version${mybatis-spring.version}/version /dependency /dependencies不要直接把所有 Spring 相关 jar 都列出来按需引用。比如用 Spring Web 做定时取消订单可以加spring-tx和spring-jdbcspring-webmvc会传递依赖一部分 spring-core但没有spring-jdbc时DataSourceTransactionManager会启动报错。3.2 Spring 配置只做三件事SSM 的 XML 配置网上教程很多但关键点就三个组件扫描、数据源、Mapper 扫描。用注解替代大部分配置后applicationContext.xml可以精简成下面这样。context:component-scan base-packagecom.campus.hanfu/ bean iddataSource classcom.alibaba.druid.pool.DruidDataSource property nameurl valuejdbc:mysql://localhost:3306/hanfu_rent?useUnicodetrueamp;characterEncodingutf8/ property nameusername valueroot/ property namepassword valueyour_password/ /bean bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property namemapperLocations valueclasspath*:mapper/*.xml/ /bean bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.campus.hanfu.mapper/ /bean3.2.1 数据源连接参数useUnicodetruecharacterEncodingutf8必须写汉服名称、款式备注里全是中文不指定编码会出现乱码在 XML 里要转义成amp;。Druid 不是 SSM 的必需品但它自带监控页排查慢 SQL 时能少写很多代码校园项目用默认配置足够。组件扫描路径要控制好范围。如果让ComponentScan扫到 Controller又在这个 XML 里同时启用 Spring MVC 的注解驱动会出现一个 Bean 被初始化两次的现象表现是登录拦截器时灵时不灵。我的经验是applicationContext.xml只管 Service、Mapper 和工具类spring-mvc.xml只扫 Controller 包。3.3 微信登录小程序 code 换 session 的落地微信平台登录是这套系统里最容易让新手卡住的地方。如果面向微信小程序流程是前端wx.login()拿到临时code后端拿 code 去微信官方接口换openid。如果面向公众号 H5则换成网页授权code调用的是另一个接口但返回结构里同样有openid。public String wxLogin(String code) { String url String.format( https://api.weixin.qq.com/sns/jscode2session?appid%ssecret%sjs_code%sgrant_typeauthorization_code, appId, appSecret, code); RestTemplate rest new RestTemplate(); String json rest.getForObject(url, String.class); JSONObject obj JSON.parseObject(json); String openid obj.getString(openid); if (StringUtils.isEmpty(openid)) { log.error(weixin login failed: {}, json); throw new BizException(微信登录失败); } return createUserAndToken(openid); }appId和appSecret不要硬编码在 Service 里放到application.properties由 Spring 注入。code是一次性的前端不能缓存所以登录接口要做防重同一个 code 被调用两次微信官方会报invalid code这个错误出现在日志里是正常的不代表代码坏了。拿到 openid 后不要直接把 openid 当 token 返回给前端。我一般生成一个自签的 JWT 或 UUID token把 openid 存在 Redis 里设置 7 天过期。微信端的每次请求带上Authorization头拦截器解析 token 后把 openid 塞进 request 属性前面 Controller 里取 openid 就是走这条链路。4. 租赁订单核心链路库存扣减、租期冲突与支付回调的幂等处理校园汉服租赁和普通电商最大的区别是商品有“时间属性”。一件汉服周五被借走周日下午才归还周六就不能再挂出去。所以订单链路里必须先解决三个问题库存按什么维度扣、租期怎么判冲突、支付回调怎么保证不重复入账。4.1 用唯一索引兜底租期冲突前面给了区间重叠查询但那只能挡住同一件服饰在同一时段的重复预约。真正线上环境里管理员可能在商品详情页配了“同款多件”数据库里虽然库存有 3但同一款式的排期表是共享的。这时候只查单件库存还不够必须给租期字段加约束。ALTER TABLE rent_order ADD COLUMN schedule_key VARCHAR(64) NOT NULL DEFAULT ; UPDATE rent_order SET schedule_key CONCAT(costume_id, _, date(start_time), _, date(end_time));把“款式编号 起始日期 结束日期”拼成一个schedule_key然后对这个字段建唯一索引。插入订单前先尝试扣库存再插入预约记录。如果插入时数据库报唯一键冲突说明同一时间区间已经有人占了直接返回“该时段已被预约”。这种方式比单纯靠SELECT COUNT(*)更可靠因为数据库唯一约束是并发环境下最后的底线。实践里要注意唯一索引会让同一天不同时间段的订单也被锁死。比如早上十点到十二点和下午两点到四点date部分相同就会冲突。解决办法是把粒度细化成hour(start_time)具体粒度取决于租赁计费单位。按小时租就拼小时按天租就只拼日期不要偷懒统一用 day。4.2 分布式扣库存的顺序问题前面给了deductStock的 UPDATE现在补完整调用顺序。Transactional public RentOrder createOrder(String openid, RentOrderDTO dto) { int rows costumeMapper.deductStock(dto.getCostumeId(), dto.getCount()); if (rows ! 1) { throw new BizException(库存不足请重新选择); } if (!rentOrderMapper.isAvailable(dto.getCostumeId(), dto.getStartTime(), dto.getEndTime())) { throw new BizException(该时段已被预约); } RentOrder order new RentOrder(); order.setOpenid(openid); order.setStatus(0); rentOrderMapper.insert(order); return order; }顺序不能反先扣库存再查排期冲突失败时事务回滚会自动把库存加回来。反过来先查排期再扣库存遇到两个人同时抢最后一件且同一时段查的时候都通过扣的时候只有一个成功另一个虽然库存没扣上但已经拿到了预约资格必然出问题。4.2.1 事务配置的最小注意事项deductStock返回 0 时抛异常事务会回滚但 MyBatis 的更新语句如果写成了SET stock stock - #{count} WHERE id #{costumeId}就永远能更新成功返回 1库存会变成负数。判断库存充足必须把AND stock #{count}放进 SQL不是靠 Java 里 if。4.3 支付回调必须做幂等微信支付成功后微信服务器会把结果异步 POST 到你配置的回调地址而且同一个订单可能回调不止一次。回调接口不能假设“我只收到一次”否则第二回调会把订单金额重复累计也会再次给用户发状态变更通知。RestController public class WxPayNotifyController { PostMapping(/api/pay/notify) public String notify(RequestBody String xmlBody) { MapString, String params WxPayUtil.parseXml(xmlBody); if (!WxPayUtil.verifySign(params, apiKey)) { return WxPayUtil.failResult(sign error); } String orderNo params.get(out_trade_no); String transactionId params.get(transaction_id); int rows rentOrderMapper.markPaidIfWaiting(orderNo, transactionId); if (rows 1) { log.info(order paid: {}, orderNo); } return WxPayUtil.successResult(); } }markPaidIfWaiting对应的 SQL 是UPDATE rent_order SET status 1 WHERE order_no #{orderNo} AND status 0只有状态还是待支付时才更新。这样第二次回调进来时 rows 为 0不会重复操作也不会影响订单号对应的改动。回调验签必须放在业务逻辑之前。apiKey是商户 API 密钥不能写死在前端验签失败直接返回“失败”字符串微信会认为回调未成功继续重试。可以把验签的逻辑单独抽成工具类所有支付相关模块共用避免将来换了微信支付版本后到处改。回调字段说明必须注意out_trade_no商户订单号用它查本地订单不要用备注替代transaction_id微信支付订单号存到订单表里方便对账total_fee金额单位是分不要直接转 float 比较用 String 和订单金额对比result_code支付结果不为 SUCCESS 时直接 return failsign签名验签通过前不要操作任何订单数据5. 部署上线后的排错技巧微信内置浏览器兜底与快速定位问题系统跑起来只是开始真正让人头疼的是微信平台环境差异。校园里学生会用微信内置浏览器打开 H5 管理端或租借页企业微信的员工点链接时还会遇到“无法通过‘微信进入’打开平台”的提示。这类问题不是后端代码能完全解决的但前端可以主动兜底。5.1 微信内置浏览器打不开时引导用户复制链接到手机浏览器H5 在微信内置浏览器里经常出现登录态失效或支付环境不兼容。我一般会在入口页加一段检测代码发现当前页面运行在微信内置浏览器时直接把可用的链接复制到剪贴板并提示用户到手机浏览器打开。function openInBrowserFallback() { let ua navigator.userAgent.toLowerCase(); if (ua.indexOf(micromessenger) ! -1) { let url location.href; navigator.clipboard.writeText(url).then(() { showGuide(请复制当前链接在手机浏览器中打开); }).catch(() { showManualGuide(url); }); } }这段逻辑要放在页面最前面执行并且不能阻塞正常入口。用户从微信内打开进来如果后续要跳微信支付window.WeixinJSBridge存在才行不存在就说明当前环境受限直接走复制链接这条路比反复刷新有效。若剪贴板 API 需要 HTTPS 权限就退化成直接展示完整 URL 让用户长按复制。5.2 用日志和 curl 快速定位租借失败部署后最常收到的问题是“学生说点提交没反应”。这种时候不要直接拉数据库按下面几步定位很快。tail -f /opt/tomcat/logs/catalina.out | grep RentOrderController先看 Controller 有没有收到请求。如果收到再看 Service 层日志有没有业务异常比如“时段已被预约”如果 Service 没执行断点就放在拦截器里看登录 token 有没有被解析出来。前端报错信息也要看微信端的 fail 回调里 code 是 401 还是 500定位思路完全不同。慢 SQL 排查用 Druid 监控页最方便登录后能看到每条 SQL 的执行时间。租期冲突查询如果 scan 行数很大优先检查rent_order表的costume_id start_time end_time复合索引没有就补上这个索引对预约高峰期帮助最大。curl -i -H Authorization: Bearer test-token \ -H Content-Type: application/json \ -d {costumeId:1,startTime:2025-05-01 10:00,endTime:2025-05-01 12:00,count:1} \ http://localhost:8080/api/order/create用 curl 直连后端接口可以排除一切微信环境干扰把问题缩小到“服务端逻辑”还是“微信端兼容”。这条命令里的 JSON 字段要和RentOrderDTO完全一致否则 Spring MVC 反序列化会直接报 400这也是新手最容易混淆的边界。本文还有配套的精品资源点击获取