简介一份基于微信小程序的马拉松运动会报名系统毕业论文面向计算机相关专业毕业生、需要完成SSM框架与小程序结合项目的开发者。文档围绕马拉松赛事报名场景针对传统报名方式信息收集不准确、管理复杂等问题设计了包含个人中心、用户管理、赛事信息管理、赛事报名管理、活动商场管理、留言板管理、系统管理、订单管理等功能模块的完整方案。技术上采用Java的SSM框架处理后台逻辑MySQL存储赛事、用户、报名等核心数据微信开发者工具构建小程序前端并介绍了可行性分析、系统功能设计和数据库设计等内容。资源包共1个文件为doc格式论文大小1.83MB适合作为毕业设计选题参考、论文撰写模板或系统开发蓝本。目前已有315人学习下载从中可以获取系统架构思路、模块划分方式、数据库表设计要点以及前后端交互流程帮助快速理清同类报名系统的开发脉络。1. 马拉松报名小程序为什么要用SSM做后端城市马拉松报名入口开放后热门组别几分钟内就会从“有名额”变“候补”。从跑者视角只是刷新小程序、填表背后真正扛住并发的是后端那几条扣名额的SQL和一张报名记录表。这也是大量毕业设计和中小赛事把技术栈选为“微信小程序SSM”的原因小程序管触达SSM管业务规则、事务和持久化。SSM由Spring、SpringMVC、MyBatis组成它没有花哨架构但“接口事务SQL”刚好能把赛事发布、身份验证、名额扣减、报名记录串成一条完整链路。这里顺着这条链路展开先设计数据表再对接微信登录然后在SSM里实现报名核心流程最后补上联调与防重复的实战细节。2. 微信小程序与SSM的数据表、登录态和请求封装很多入门设计会把精力先放在前端页面上结果后端接口一拆就发现缺字段、缺状态。做报名系统我一般先把服务端的三张主体表想清楚再回头写小程序页面这样前端调什么接口、后端给什么数据就都有了。2.1 跑者、赛事、报名记录最少三张表就够了报名系统的核心是建立“人”和“赛事”的关联设计时不用急着加新闻表、留言表先把基础关系落稳。第一版我建议建三张表runner保存微信身份和报名人资料race保存赛事基础信息和剩余名额registration保存一次具体的报名行为。CREATE TABLE runner ( id BIGINT PRIMARY KEY AUTO_INCREMENT, openid VARCHAR(64) NOT NULL UNIQUE, nickname VARCHAR(64) DEFAULT , avatar VARCHAR(255) DEFAULT , real_name VARCHAR(32) DEFAULT , id_card VARCHAR(32) DEFAULT , phone VARCHAR(20) DEFAULT , emergency_contact VARCHAR(32) DEFAULT , create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE race ( id BIGINT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(128) NOT NULL, event_date DATETIME NOT NULL, start_point VARCHAR(255), total_quota INT NOT NULL DEFAULT 0, remain_quota INT NOT NULL DEFAULT 0, version INT NOT NULL DEFAULT 0, status TINYINT NOT NULL DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE registration ( id BIGINT PRIMARY KEY AUTO_INCREMENT, runner_id BIGINT NOT NULL, race_id BIGINT NOT NULL, status TINYINT NOT NULL DEFAULT 0, apply_time DATETIME DEFAULT CURRENT_TIMESTAMP, payment_status TINYINT DEFAULT 0, UNIQUE KEY uk_runner_race (runner_id, race_id), CONSTRAINT fk_reg_runner FOREIGN KEY (runner_id) REFERENCES runner(id), CONSTRAINT fk_reg_race FOREIGN KEY (race_id) REFERENCES race(id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这三张表里runner.openid要和微信登录打通race.remain_quota是后续并发扣减的关键字段registration的联合唯一索引用来挡住重复报名。很多同学会漏掉uk_runner_race出问题后只能靠Java代码里先查再插这在并发下并不可靠。字段关系可以简化成下面这个表理解关键字段所属表用途注意点openidrunner微信身份绑定只能由后端通过code2session换取remain_quotarace剩余可报名数扣减成功后才插入报名记录runner_id race_idregistration报名关系联合唯一索引防重复2.2 微信登录code2session换openidSSM再发自己的token小程序端wx.login()拿到的 code 是一次性的不能把 openid 暴露给前端。正确的做法是把 code 传给 SSM 后端由后端请求微信接口换取 openid再生成一个业务 token 返回给小程序。RestController RequestMapping(/api/auth) public class AuthController { Autowired private RestTemplate restTemplate; Autowired private AppConfig appConfig; Autowired private RunnerService runnerService; Autowired private TokenStore tokenStore; PostMapping(/login) public Result login(RequestBody MapString, String body) { String code body.get(code); String url https://api.weixin.qq.com/sns/jscode2session?appid{appid}secret{secret}js_code{js_code}grant_typeauthorization_code; MapString, String params new HashMap(); params.put(appid, appConfig.getAppId()); params.put(secret, appConfig.getAppSecret()); params.put(js_code, code); String result restTemplate.getForObject(url, String.class, params); JSONObject json JSON.parseObject(result); String openid json.getString(openid); if (openid null) { return Result.error(微信登录失败: json.getString(errmsg)); } Long runnerId runnerService.getOrCreateByOpenid(openid); String token tokenStore.create(runnerId); return Result.ok(token); } }这段代码里AppConfig保存小程序的 appid 和 secretTokenStore可以先用ConcurrentHashMapString, Long实现把 token 映射到 runnerId。注意 secret 只能出现在服务端绝对不能写进小程序代码。后续每个业务接口都带token请求头由 SpringMVC 拦截器统一解析。public class LoginInterceptor implements HandlerInterceptor { private TokenStore tokenStore; Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token request.getHeader(token); if (token ! null tokenStore.isValid(token)) { request.setAttribute(runnerId, tokenStore.getRunnerId(token)); return true; } response.setStatus(401); return false; } }之后你开发的/api/registration/**接口就无需关心“当前用户是谁”直接从 request 取runnerId即可。这里也解释了为什么报名接口不能信任前端传的 userId只要 token 有效身份就是可信的。2.3 小程序端封装wx.request统一带token并处理401小程序的wx.request每次调用都很啰嗦我会在项目里单独封装一个request.js把 token、错误码、登录失效跳转集中处理。这样报名、查询、取消报名页面调用时只需要关心成功数据。const request (url, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: getApp().globalData.baseUrl url, method, data, header: { token: wx.getStorageSync(token) }, success: (res) { if (res.statusCode 401) { wx.removeStorageSync(token); wx.showToast({ title: 请重新登录, icon: none }); setTimeout(() wx.reLaunch({ url: /pages/login/login }), 600); return; } 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: reject }); }); };这里的关键是401分支只在拦截器返回时触发前端不需要在每个页面重复写登录失效逻辑。baseUrl放在globalData里开发环境用http://localhost:8080换真机调试时改成局域网IP后面会专门说这个坑。3. 用SSM实现马拉松报名核心流程名额扣减与报名记录数据表和登录态就绪后报名接口的逻辑链是“查询赛事列表 → 查看详情 → 点击报名 → 扣名额 → 生成报名记录”。其中“扣名额”是并发问题的焦点写法和普通insert完全不同。3.1 报名接口从Controller到Service的参数流报名接口接收raceId以及报名人资料但 runnerId 必须从拦截器里取。Controller 只做参数接收和结果包装业务逻辑放到 Service 层。RestController RequestMapping(/api/registration) public class RegistrationController { Autowired private RegistrationService registrationService; PostMapping(/apply) public Result apply(RequestBody Valid ApplyDTO dto, HttpServletRequest request) { Long runnerId (Long) request.getAttribute(runnerId); return Result.ok(registrationService.apply(runnerId, dto)); } }ApplyDTO里建议带上NotBlank、NotNull注解SpringMVC 通过Valid自动校验。注意这里没有接收前端传来的 runnerId因为只要 token 有效后台就能确定身份避免一个用户传别人的ID完成报名。3.2 用MyBatis条件更新扣减名额一行update挡住并发超卖当两个跑者同时点“报名”程序不能先 select 再 update因为两个请求可能都读到remain_quota1然后都认为有名额。常见做法是把扣减写成一个原子 SQL用remain_quota 0作为条件影响行数为0就表示没抢到。update iddecreaseQuota UPDATE race SET remain_quota remain_quota - 1, version version 1 WHERE id #{raceId} AND status 1 AND remain_quota 0 /update这里更新的是剩余名额和版本号MySQL/InnoDB 的行锁会保证同一时间只有一个事务能成功更新这行数据。调用这个 update 后如果返回 0说明名额已经没了。Service 层把防重、扣减、插入记录串成一个事务Transactional(rollbackFor Exception.class) public RegistrationVO apply(Long runnerId, ApplyDTO dto) { // 1. 防重同一个跑者同一场赛事只能报一次 if (registrationMapper.countByRunnerAndRace(runnerId, dto.getRaceId()) 0) { throw new BizException(你已经报过这场赛事); } // 2. 原子扣减名额 int rows raceMapper.decreaseQuota(dto.getRaceId()); if (rows 0) { throw new BizException(名额已满请选择其他组别); } // 3. 生成报名记录 Registration reg new Registration(); reg.setRunnerId(runnerId); reg.setRaceId(dto.getRaceId()); reg.setStatus(1); reg.setApplyTime(new Date()); registrationMapper.insert(reg); return buildVO(reg); }顺序不能乱先做业务防重再扣减名额最后插入报名记录。如果第3步插入失败抛出异常事务回滚会连第2步的扣减一起回滚不会出现“名额扣了但记录没生成”的状态。3.3 报名状态机和免费、收费两种场景马拉松报名分免费和收费两种状态设计可以统一状态值含义触发时机0待支付提交报名但未支付名额预占1已支付/报名成功免费赛事直接进入或支付成功后2取消报名用户主动取消释放名额3已过期/未支付释放超时未支付自动释放免费赛事处理很简单扣减名额后直接置 status1。收费赛事则先置为 0等支付回调成功后再改为 1。取消时执行一次“归还名额”的 update把remain_quota 1回去同时把 registration 状态改成 2。小程序端报名页只需要调用封装好的request方法async submitApply() { const raceId this.data.raceId; const form this.data.form; if (!form.realName || !form.idCard || !form.phone) { wx.showToast({ title: 请完善报名信息, icon: none }); return; } request(/api/registration/apply, POST, { raceId, ...form }) .then(() { wx.showToast({ title: 报名成功, icon: success }); this.setData({ applied: true }); wx.navigateTo({ url: /pages/mine/mine }); }) .catch(e { wx.showToast({ title: e.msg || 报名失败, icon: none }); }); }前端只做非空校验真正的身份证格式、重复报名校验都在 SSM 端做。这样就算有人绕过小程序直接发 HTTP 请求后端也能挡住非法提交。4. 微信小程序联调SSM真机请求失败、Long精度与上线配置接口写完不等于能跑通微信小程序和后端联调时最容易出问题的是网络和数据类型。这里把我在实际项目里踩过的三个高频问题列出来。4.1 本地用“不校验域名”真机却连不上后端本地开发者工具中勾选“不校验合法域名”后页面调http://localhost:8080很顺畅但点“真机调试”后请求报错最常见的现象就是“真机调试请求无法到达后端”。原因通常是后端没有监听局域网地址或者手机和电脑不在同一个网络。按这个顺序排查检查 SpringMVC/Tomcat 启动日志确认监听在0.0.0.0:8080而不是127.0.0.1:8080。真机和电脑连同一个 Wi-Fi然后用电脑的局域网 IP 替换baseUrl里的localhost。在微信开发者工具“详情 → 本地设置”勾选“不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书”。如果之前开过系统防火墙放行 8080 端口再用手机浏览器直接访问http://192.168.x.x:8080/api/race/list验证。提示出现“请求无法到达后端”时先别急着折腾小程序用手机浏览器打开上面的接口地址能拿到 JSON 再回来查小程序配置效率高很多。另外要注意真机调试只能用 HTTP 访问局域网 IP这属于开发态特权。正式发布后request合法域名强制要求 HTTPS并且不能带端口和 IP。4.2 SSM返回Long和日期字段小程序端精度丢失MyBatis 自增主键是 BIGINTJSON 序列化成 number 后小程序端用 JavaScript 处理超过Number.MAX_SAFE_INTEGER的数字会丢精度。比如后端返回id: 1650123456789前端可能解析成1650123456790导致后续查询永远匹配不上。解决方案是让 SSM 序列化时把 Long 统一转成字符串。SpringMVC 环境下可以自定义ObjectMapper并注册到消息转换器public class CustomObjectMapper extends ObjectMapper { public CustomObjectMapper() { SimpleModule module new SimpleModule(); module.addSerializer(Long.class, ToStringSerializer.instance); module.addSerializer(Long.TYPE, ToStringSerializer.instance); this.registerModule(module); } }然后在 spring-mvc.xml 里替换默认 Jackson 转换器mvc:annotation-driven mvc:message-converters bean classorg.springframework.http.converter.json.MappingJackson2HttpMessageConverter property nameobjectMapper refcustomObjectMapper/ /bean /mvc:message-converters /mvc:annotation-driven日期字段建议在实体类 getter 上直接加JsonFormat(pattern yyyy-MM-dd HH:mm:ss, timezone GMT8)这样小程序端拿到的是2025-05-18 07:30:00字符串不需要再写时间戳转换函数。4.3 用微信开发者工具或HBuilderX发行上线前要改的三处配置原生小程序开发直接在开发者工具点“上传”按钮。用 uni-app 开发的话则在 HBuilderX 里点“发行 → 小程序-微信”生成dist/build/mp-weixin目录然后用微信开发者工具打开这个目录再上传。上线前最容易漏的是三处配置配置项位置要求request 合法域名小程序后台 → 开发管理 → 开发设置必须 HTTPS域名备案不能带端口baseUrlapp.js的 globalData 或单独 config.js改成线上域名如https://api.example.com业务域名小程序后台如果要跳转 H5 页面才需要配置小程序后台的合法域名没有配置好时正式版请求直接报url not in domain list。开发版和体验版还能勾选“不校验合法域名”绕过线上发布绕不过去。所以毕设演示如果只在本地点域名问题不大真要部署到云服务器这一步是必须提前准备的。5. 防重复报名与毕设演示自检脚本同一个身份证只允许报一场马拉松赛事通常限制同一个身份证只能报名其中一个组别。业务层只靠 count 查询判断重复在高并发下不保险我会在数据库和代码两层都加上约束。5.1 唯一索引兜底registration 表加联合唯一键前文已经提到registration表有uk_runner_race唯一索引这一步还能继续收紧给runner.id_card加唯一索引保证同一个身份证号只能注册一次。注意 MySQL 唯一索引不会拦截多个 NULL 值所以没填身份证的用户不受影响。ALTER TABLE registration ADD UNIQUE KEY uk_runner_race (runner_id, race_id); ALTER TABLE runner ADD UNIQUE KEY uk_id_card (id_card);如果代码漏判数据库会抛出DuplicateKeyException。在 Spring 的全局异常处理器里捕获这个异常统一返回“请勿重复报名”即可。双重防御比只靠一种方式稳得多。5.2 报名信息校验手机号、身份证号、紧急联系人报名表单里最容易造假的是手机号和身份证号。我会在 Service 层再做一次正则校验防止绕过前端直接调接口。private static final Pattern PHONE Pattern.compile(^1[3-9]\\d{9}$); private static final Pattern ID_CARD Pattern.compile(^\\d{17}[0-9Xx]$); if (!PHONE.matcher(dto.getPhone()).matches()) { throw new BizException(手机号格式不正确); } if (!ID_CARD.matcher(dto.getIdCard()).matches()) { throw new BizException(身份证号格式不正确); } if (dto.getEmergencyContact().equals(dto.getPhone())) { throw new BizException(紧急联系人不能与本人手机号相同); }身份证号还可以继续做最后一位校验位计算代码量不大但毕设答辩时能明显拉开“只会增删改查”和“考虑过数据完整性”的差距。5.3 演示前用bash脚本跑通“发布-报名-查询”全链路答辩演示最怕现场点按钮时才暴露接口问题。我会在src/test/resources下放一个 bash 脚本把发布赛事、模拟登录、报名、查剩余名额全部跑一遍每次启动项目后执行一次作为自检。#!/bin/bash BASEhttp://127.0.0.1:8080 # 1. 管理员发布赛事名额给3个 curl -X POST $BASE/api/race \ -H Content-Type: application/json \ -d {name:测试跑,eventDate:2025-05-18 07:30:00,quota:3} # 2. 模拟登录拿到token token$(curl -X POST $BASE/api/auth/login \ -H Content-Type: application/json \ -d {code:dev} \ | jq -r .data.token) # 3. 两次并发报名验证只有一个成功 curl -X POST $BASE/api/registration/apply \ -H Content-Type: application/json -H token:$token \ -d {raceId:1,realName:张三,idCard:110101199901011234} curl -X POST $BASE/api/registration/apply \ -H Content-Type: application/json -H token:$token \ -d {raceId:1,realName:李四,idCard:110101199902022345} wait # 4. 查询该赛事剩余名额 curl -X GET $BASE/api/race/1 | jq .data.remainQuota这个脚本用的是真实 HTTP 请求不经过小程序的封装层所以能直接验证 Controller 到 Mapper 的链路。把 JVM 参数的随机 token 问题绕开后它还能帮你快速复现并发场景观察最终剩余名额是否只少了一个。Windows 上如果没有jq装一个 Git Bash 内置的jq或者换成python3 -c import sys,json; print(json.load(sys.stdin)...)都可以达到同样效果。本文还有配套的精品资源点击获取
简介一份基于微信小程序的马拉松运动会报名系统毕业论文面向计算机相关专业毕业生、需要完成SSM框架与小程序结合项目的开发者。文档围绕马拉松赛事报名场景针对传统报名方式信息收集不准确、管理复杂等问题设计了包含个人中心、用户管理、赛事信息管理、赛事报名管理、活动商场管理、留言板管理、系统管理、订单管理等功能模块的完整方案。技术上采用Java的SSM框架处理后台逻辑MySQL存储赛事、用户、报名等核心数据微信开发者工具构建小程序前端并介绍了可行性分析、系统功能设计和数据库设计等内容。资源包共1个文件为doc格式论文大小1.83MB适合作为毕业设计选题参考、论文撰写模板或系统开发蓝本。目前已有315人学习下载从中可以获取系统架构思路、模块划分方式、数据库表设计要点以及前后端交互流程帮助快速理清同类报名系统的开发脉络。1. 马拉松报名小程序为什么要用SSM做后端城市马拉松报名入口开放后热门组别几分钟内就会从“有名额”变“候补”。从跑者视角只是刷新小程序、填表背后真正扛住并发的是后端那几条扣名额的SQL和一张报名记录表。这也是大量毕业设计和中小赛事把技术栈选为“微信小程序SSM”的原因小程序管触达SSM管业务规则、事务和持久化。SSM由Spring、SpringMVC、MyBatis组成它没有花哨架构但“接口事务SQL”刚好能把赛事发布、身份验证、名额扣减、报名记录串成一条完整链路。这里顺着这条链路展开先设计数据表再对接微信登录然后在SSM里实现报名核心流程最后补上联调与防重复的实战细节。2. 微信小程序与SSM的数据表、登录态和请求封装很多入门设计会把精力先放在前端页面上结果后端接口一拆就发现缺字段、缺状态。做报名系统我一般先把服务端的三张主体表想清楚再回头写小程序页面这样前端调什么接口、后端给什么数据就都有了。2.1 跑者、赛事、报名记录最少三张表就够了报名系统的核心是建立“人”和“赛事”的关联设计时不用急着加新闻表、留言表先把基础关系落稳。第一版我建议建三张表runner保存微信身份和报名人资料race保存赛事基础信息和剩余名额registration保存一次具体的报名行为。CREATE TABLE runner ( id BIGINT PRIMARY KEY AUTO_INCREMENT, openid VARCHAR(64) NOT NULL UNIQUE, nickname VARCHAR(64) DEFAULT , avatar VARCHAR(255) DEFAULT , real_name VARCHAR(32) DEFAULT , id_card VARCHAR(32) DEFAULT , phone VARCHAR(20) DEFAULT , emergency_contact VARCHAR(32) DEFAULT , create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE race ( id BIGINT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(128) NOT NULL, event_date DATETIME NOT NULL, start_point VARCHAR(255), total_quota INT NOT NULL DEFAULT 0, remain_quota INT NOT NULL DEFAULT 0, version INT NOT NULL DEFAULT 0, status TINYINT NOT NULL DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE registration ( id BIGINT PRIMARY KEY AUTO_INCREMENT, runner_id BIGINT NOT NULL, race_id BIGINT NOT NULL, status TINYINT NOT NULL DEFAULT 0, apply_time DATETIME DEFAULT CURRENT_TIMESTAMP, payment_status TINYINT DEFAULT 0, UNIQUE KEY uk_runner_race (runner_id, race_id), CONSTRAINT fk_reg_runner FOREIGN KEY (runner_id) REFERENCES runner(id), CONSTRAINT fk_reg_race FOREIGN KEY (race_id) REFERENCES race(id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这三张表里runner.openid要和微信登录打通race.remain_quota是后续并发扣减的关键字段registration的联合唯一索引用来挡住重复报名。很多同学会漏掉uk_runner_race出问题后只能靠Java代码里先查再插这在并发下并不可靠。字段关系可以简化成下面这个表理解关键字段所属表用途注意点openidrunner微信身份绑定只能由后端通过code2session换取remain_quotarace剩余可报名数扣减成功后才插入报名记录runner_id race_idregistration报名关系联合唯一索引防重复2.2 微信登录code2session换openidSSM再发自己的token小程序端wx.login()拿到的 code 是一次性的不能把 openid 暴露给前端。正确的做法是把 code 传给 SSM 后端由后端请求微信接口换取 openid再生成一个业务 token 返回给小程序。RestController RequestMapping(/api/auth) public class AuthController { Autowired private RestTemplate restTemplate; Autowired private AppConfig appConfig; Autowired private RunnerService runnerService; Autowired private TokenStore tokenStore; PostMapping(/login) public Result login(RequestBody MapString, String body) { String code body.get(code); String url https://api.weixin.qq.com/sns/jscode2session?appid{appid}secret{secret}js_code{js_code}grant_typeauthorization_code; MapString, String params new HashMap(); params.put(appid, appConfig.getAppId()); params.put(secret, appConfig.getAppSecret()); params.put(js_code, code); String result restTemplate.getForObject(url, String.class, params); JSONObject json JSON.parseObject(result); String openid json.getString(openid); if (openid null) { return Result.error(微信登录失败: json.getString(errmsg)); } Long runnerId runnerService.getOrCreateByOpenid(openid); String token tokenStore.create(runnerId); return Result.ok(token); } }这段代码里AppConfig保存小程序的 appid 和 secretTokenStore可以先用ConcurrentHashMapString, Long实现把 token 映射到 runnerId。注意 secret 只能出现在服务端绝对不能写进小程序代码。后续每个业务接口都带token请求头由 SpringMVC 拦截器统一解析。public class LoginInterceptor implements HandlerInterceptor { private TokenStore tokenStore; Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token request.getHeader(token); if (token ! null tokenStore.isValid(token)) { request.setAttribute(runnerId, tokenStore.getRunnerId(token)); return true; } response.setStatus(401); return false; } }之后你开发的/api/registration/**接口就无需关心“当前用户是谁”直接从 request 取runnerId即可。这里也解释了为什么报名接口不能信任前端传的 userId只要 token 有效身份就是可信的。2.3 小程序端封装wx.request统一带token并处理401小程序的wx.request每次调用都很啰嗦我会在项目里单独封装一个request.js把 token、错误码、登录失效跳转集中处理。这样报名、查询、取消报名页面调用时只需要关心成功数据。const request (url, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: getApp().globalData.baseUrl url, method, data, header: { token: wx.getStorageSync(token) }, success: (res) { if (res.statusCode 401) { wx.removeStorageSync(token); wx.showToast({ title: 请重新登录, icon: none }); setTimeout(() wx.reLaunch({ url: /pages/login/login }), 600); return; } 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: reject }); }); };这里的关键是401分支只在拦截器返回时触发前端不需要在每个页面重复写登录失效逻辑。baseUrl放在globalData里开发环境用http://localhost:8080换真机调试时改成局域网IP后面会专门说这个坑。3. 用SSM实现马拉松报名核心流程名额扣减与报名记录数据表和登录态就绪后报名接口的逻辑链是“查询赛事列表 → 查看详情 → 点击报名 → 扣名额 → 生成报名记录”。其中“扣名额”是并发问题的焦点写法和普通insert完全不同。3.1 报名接口从Controller到Service的参数流报名接口接收raceId以及报名人资料但 runnerId 必须从拦截器里取。Controller 只做参数接收和结果包装业务逻辑放到 Service 层。RestController RequestMapping(/api/registration) public class RegistrationController { Autowired private RegistrationService registrationService; PostMapping(/apply) public Result apply(RequestBody Valid ApplyDTO dto, HttpServletRequest request) { Long runnerId (Long) request.getAttribute(runnerId); return Result.ok(registrationService.apply(runnerId, dto)); } }ApplyDTO里建议带上NotBlank、NotNull注解SpringMVC 通过Valid自动校验。注意这里没有接收前端传来的 runnerId因为只要 token 有效后台就能确定身份避免一个用户传别人的ID完成报名。3.2 用MyBatis条件更新扣减名额一行update挡住并发超卖当两个跑者同时点“报名”程序不能先 select 再 update因为两个请求可能都读到remain_quota1然后都认为有名额。常见做法是把扣减写成一个原子 SQL用remain_quota 0作为条件影响行数为0就表示没抢到。update iddecreaseQuota UPDATE race SET remain_quota remain_quota - 1, version version 1 WHERE id #{raceId} AND status 1 AND remain_quota 0 /update这里更新的是剩余名额和版本号MySQL/InnoDB 的行锁会保证同一时间只有一个事务能成功更新这行数据。调用这个 update 后如果返回 0说明名额已经没了。Service 层把防重、扣减、插入记录串成一个事务Transactional(rollbackFor Exception.class) public RegistrationVO apply(Long runnerId, ApplyDTO dto) { // 1. 防重同一个跑者同一场赛事只能报一次 if (registrationMapper.countByRunnerAndRace(runnerId, dto.getRaceId()) 0) { throw new BizException(你已经报过这场赛事); } // 2. 原子扣减名额 int rows raceMapper.decreaseQuota(dto.getRaceId()); if (rows 0) { throw new BizException(名额已满请选择其他组别); } // 3. 生成报名记录 Registration reg new Registration(); reg.setRunnerId(runnerId); reg.setRaceId(dto.getRaceId()); reg.setStatus(1); reg.setApplyTime(new Date()); registrationMapper.insert(reg); return buildVO(reg); }顺序不能乱先做业务防重再扣减名额最后插入报名记录。如果第3步插入失败抛出异常事务回滚会连第2步的扣减一起回滚不会出现“名额扣了但记录没生成”的状态。3.3 报名状态机和免费、收费两种场景马拉松报名分免费和收费两种状态设计可以统一状态值含义触发时机0待支付提交报名但未支付名额预占1已支付/报名成功免费赛事直接进入或支付成功后2取消报名用户主动取消释放名额3已过期/未支付释放超时未支付自动释放免费赛事处理很简单扣减名额后直接置 status1。收费赛事则先置为 0等支付回调成功后再改为 1。取消时执行一次“归还名额”的 update把remain_quota 1回去同时把 registration 状态改成 2。小程序端报名页只需要调用封装好的request方法async submitApply() { const raceId this.data.raceId; const form this.data.form; if (!form.realName || !form.idCard || !form.phone) { wx.showToast({ title: 请完善报名信息, icon: none }); return; } request(/api/registration/apply, POST, { raceId, ...form }) .then(() { wx.showToast({ title: 报名成功, icon: success }); this.setData({ applied: true }); wx.navigateTo({ url: /pages/mine/mine }); }) .catch(e { wx.showToast({ title: e.msg || 报名失败, icon: none }); }); }前端只做非空校验真正的身份证格式、重复报名校验都在 SSM 端做。这样就算有人绕过小程序直接发 HTTP 请求后端也能挡住非法提交。4. 微信小程序联调SSM真机请求失败、Long精度与上线配置接口写完不等于能跑通微信小程序和后端联调时最容易出问题的是网络和数据类型。这里把我在实际项目里踩过的三个高频问题列出来。4.1 本地用“不校验域名”真机却连不上后端本地开发者工具中勾选“不校验合法域名”后页面调http://localhost:8080很顺畅但点“真机调试”后请求报错最常见的现象就是“真机调试请求无法到达后端”。原因通常是后端没有监听局域网地址或者手机和电脑不在同一个网络。按这个顺序排查检查 SpringMVC/Tomcat 启动日志确认监听在0.0.0.0:8080而不是127.0.0.1:8080。真机和电脑连同一个 Wi-Fi然后用电脑的局域网 IP 替换baseUrl里的localhost。在微信开发者工具“详情 → 本地设置”勾选“不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书”。如果之前开过系统防火墙放行 8080 端口再用手机浏览器直接访问http://192.168.x.x:8080/api/race/list验证。提示出现“请求无法到达后端”时先别急着折腾小程序用手机浏览器打开上面的接口地址能拿到 JSON 再回来查小程序配置效率高很多。另外要注意真机调试只能用 HTTP 访问局域网 IP这属于开发态特权。正式发布后request合法域名强制要求 HTTPS并且不能带端口和 IP。4.2 SSM返回Long和日期字段小程序端精度丢失MyBatis 自增主键是 BIGINTJSON 序列化成 number 后小程序端用 JavaScript 处理超过Number.MAX_SAFE_INTEGER的数字会丢精度。比如后端返回id: 1650123456789前端可能解析成1650123456790导致后续查询永远匹配不上。解决方案是让 SSM 序列化时把 Long 统一转成字符串。SpringMVC 环境下可以自定义ObjectMapper并注册到消息转换器public class CustomObjectMapper extends ObjectMapper { public CustomObjectMapper() { SimpleModule module new SimpleModule(); module.addSerializer(Long.class, ToStringSerializer.instance); module.addSerializer(Long.TYPE, ToStringSerializer.instance); this.registerModule(module); } }然后在 spring-mvc.xml 里替换默认 Jackson 转换器mvc:annotation-driven mvc:message-converters bean classorg.springframework.http.converter.json.MappingJackson2HttpMessageConverter property nameobjectMapper refcustomObjectMapper/ /bean /mvc:message-converters /mvc:annotation-driven日期字段建议在实体类 getter 上直接加JsonFormat(pattern yyyy-MM-dd HH:mm:ss, timezone GMT8)这样小程序端拿到的是2025-05-18 07:30:00字符串不需要再写时间戳转换函数。4.3 用微信开发者工具或HBuilderX发行上线前要改的三处配置原生小程序开发直接在开发者工具点“上传”按钮。用 uni-app 开发的话则在 HBuilderX 里点“发行 → 小程序-微信”生成dist/build/mp-weixin目录然后用微信开发者工具打开这个目录再上传。上线前最容易漏的是三处配置配置项位置要求request 合法域名小程序后台 → 开发管理 → 开发设置必须 HTTPS域名备案不能带端口baseUrlapp.js的 globalData 或单独 config.js改成线上域名如https://api.example.com业务域名小程序后台如果要跳转 H5 页面才需要配置小程序后台的合法域名没有配置好时正式版请求直接报url not in domain list。开发版和体验版还能勾选“不校验合法域名”绕过线上发布绕不过去。所以毕设演示如果只在本地点域名问题不大真要部署到云服务器这一步是必须提前准备的。5. 防重复报名与毕设演示自检脚本同一个身份证只允许报一场马拉松赛事通常限制同一个身份证只能报名其中一个组别。业务层只靠 count 查询判断重复在高并发下不保险我会在数据库和代码两层都加上约束。5.1 唯一索引兜底registration 表加联合唯一键前文已经提到registration表有uk_runner_race唯一索引这一步还能继续收紧给runner.id_card加唯一索引保证同一个身份证号只能注册一次。注意 MySQL 唯一索引不会拦截多个 NULL 值所以没填身份证的用户不受影响。ALTER TABLE registration ADD UNIQUE KEY uk_runner_race (runner_id, race_id); ALTER TABLE runner ADD UNIQUE KEY uk_id_card (id_card);如果代码漏判数据库会抛出DuplicateKeyException。在 Spring 的全局异常处理器里捕获这个异常统一返回“请勿重复报名”即可。双重防御比只靠一种方式稳得多。5.2 报名信息校验手机号、身份证号、紧急联系人报名表单里最容易造假的是手机号和身份证号。我会在 Service 层再做一次正则校验防止绕过前端直接调接口。private static final Pattern PHONE Pattern.compile(^1[3-9]\\d{9}$); private static final Pattern ID_CARD Pattern.compile(^\\d{17}[0-9Xx]$); if (!PHONE.matcher(dto.getPhone()).matches()) { throw new BizException(手机号格式不正确); } if (!ID_CARD.matcher(dto.getIdCard()).matches()) { throw new BizException(身份证号格式不正确); } if (dto.getEmergencyContact().equals(dto.getPhone())) { throw new BizException(紧急联系人不能与本人手机号相同); }身份证号还可以继续做最后一位校验位计算代码量不大但毕设答辩时能明显拉开“只会增删改查”和“考虑过数据完整性”的差距。5.3 演示前用bash脚本跑通“发布-报名-查询”全链路答辩演示最怕现场点按钮时才暴露接口问题。我会在src/test/resources下放一个 bash 脚本把发布赛事、模拟登录、报名、查剩余名额全部跑一遍每次启动项目后执行一次作为自检。#!/bin/bash BASEhttp://127.0.0.1:8080 # 1. 管理员发布赛事名额给3个 curl -X POST $BASE/api/race \ -H Content-Type: application/json \ -d {name:测试跑,eventDate:2025-05-18 07:30:00,quota:3} # 2. 模拟登录拿到token token$(curl -X POST $BASE/api/auth/login \ -H Content-Type: application/json \ -d {code:dev} \ | jq -r .data.token) # 3. 两次并发报名验证只有一个成功 curl -X POST $BASE/api/registration/apply \ -H Content-Type: application/json -H token:$token \ -d {raceId:1,realName:张三,idCard:110101199901011234} curl -X POST $BASE/api/registration/apply \ -H Content-Type: application/json -H token:$token \ -d {raceId:1,realName:李四,idCard:110101199902022345} wait # 4. 查询该赛事剩余名额 curl -X GET $BASE/api/race/1 | jq .data.remainQuota这个脚本用的是真实 HTTP 请求不经过小程序的封装层所以能直接验证 Controller 到 Mapper 的链路。把 JVM 参数的随机 token 问题绕开后它还能帮你快速复现并发场景观察最终剩余名额是否只少了一个。Windows 上如果没有jq装一个 Git Bash 内置的jq或者换成python3 -c import sys,json; print(json.load(sys.stdin)...)都可以达到同样效果。本文还有配套的精品资源点击获取
