简介面向毕业设计与课程设计场景的微信小程序活动报名管理系统基于Java与SSM框架搭建后台搭配uniapp/原生小程序前端覆盖站内新闻、活动信息展示、在线报名、个人中心以及管理员端的活动管理、报名审核与用户管理等完整业务流程适合Java或小程序方向的学生直接参考或二次开发。资源共424个文件压缩包34.59MB以java源码、class编译文件、jar依赖库、xml配置与SQL脚本为主同时包含wxml/wxss/js等小程序页面文件及说明文档前后端代码与数据库脚本齐全导入Eclipse/Idea并用MySQL 5.7即可运行。已有84人浏览学习对需要快速搭建可演示的报名类小程序课题、理解SSM与小程序联调过程会有直接帮助。1. 微信小程序的活动报名管理系统拿到压缩包后先做哪三件事打开压缩包的那一瞬间绝大多数人的反应是懵的前端文件夹、后端文件夹、sql 文件还有个说明文档LW不知道先运行哪个。这套微信小程序的活动报名管理系统说白了就是一套能直接演示的毕业设计工程小程序端负责报名和展示后端负责业务逻辑MySQL 存数据说明文档告诉你启动步骤和数据库怎么导入。它要解决的不是「学会开发」而是「在有限时间里交付一个能答辩、能写论文、能演示的完整闭环」。适合时间紧的计算机类本科毕设也适合拿去练前后端联调。我建议拿到手先做三件事确认 SQL 脚本能导入、确认后端能启动、确认小程序端能连上后端。这三件事走通剩下的都是改参数和造数据的工作量。2. 功能边界与数据模型接口清单、核心 MySQL 表和报名事务2.1 功能模块与小程序页面怎么拆一个小程序活动报名系统业务上至少要拆出两类角色。普通用户浏览活动、看详情、报名、取消报名、查看自己的报名记录。管理员发布活动、设置名额和截止时间、查看报名名单。在毕业设计里通常不单独做一套 Web 管理后台而是共用一个小程序后端登录接口拿到 openid 后去管理员表里查一下命中就把 isAdmin 字段放进返回参数小程序首页条件渲染一个「管理入口」。这样角色权限也能写进论文的模块设计里。页面一般这么分pages/index/index活动列表、pages/detail/detail活动详情与报名入口、pages/apply/apply报名表单、pages/my/my我的报名、pages/admin/admin管理员页。列表页想做得完整一点可以加分类 tabs下面接 onReachBottom 触底加载更多对应后端分页参数 page 和 pageSize。报名表单里选票种或场次用 radio 组件就行字段对应活动表里的一个类型字段这样论文里能写「表单组件与数据绑定」这一段。2.2 接口清单先想清楚小程序要调哪些后端能力接口设计直接决定前后端联调顺不顺畅。常见的拆分是六个到八个接口小程序端的每个页面都能找到对应的接口而不是一个接口包打天下。下面这张表是我在同类项目里常用的接口划分方式接口路径以你压缩包里的源码为准但职责基本一致。方法路径说明关键参数GET/api/activity/list分页活动列表page, pageSize, categoryIdGET/api/activity/detail活动详情idPOST/api/signup/add提交报名activityId, phone, remarkPOST/api/signup/cancel取消报名signupIdGET/api/signup/my我的报名列表无openid 由后端解析POST/api/activity/add新增活动管理员title, location, quota 等GET/api/signup/list某活动的报名名单activityId接口约定里有一个安全细节容易被忽略用户身份不应该由小程序端把 openid 传过来而是前端调 wx.login 拿 code后端拿 code 去微信接口换 openid再把这个身份状态记在会话里。毕设答辩时老师问到「用户身份怎么识别」这就是一个加分回答。2.3 MySQL 表设计四张表撑起一个闭环数据库是整个系统最先要落地的东西。这类系统常见的表结构是四张活动表 activity、用户表 user、报名表 signup、管理员表 admin。活动表承载业务主体报名表连接用户和活动用户表存 openid 和昵称头像管理员表用来判断权限。先看核心的活动表和报名表。CREATE TABLE activity ( id int(11) NOT NULL AUTO_INCREMENT, title varchar(100) NOT NULL COMMENT 活动标题, cover varchar(255) DEFAULT COMMENT 封面图URL, location varchar(100) DEFAULT COMMENT 活动地点, start_time datetime DEFAULT NULL COMMENT 开始时间, end_time datetime DEFAULT NULL COMMENT 结束时间, quota int(11) DEFAULT 0 COMMENT 名额上限0表示不限, signup_count int(11) DEFAULT 0 COMMENT 已报名人数, status tinyint(4) DEFAULT 1 COMMENT 0下架 1上架 2截止, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_status (status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT活动表; CREATE TABLE signup ( id int(11) NOT NULL AUTO_INCREMENT, activity_id int(11) NOT NULL, user_id int(11) NOT NULL, phone varchar(20) DEFAULT COMMENT 联系电话, remark varchar(255) DEFAULT COMMENT 备注, status tinyint(4) DEFAULT 1 COMMENT 1已报名 0已取消, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_activity_user (activity_id, user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT报名表;这两张表的关键字段解释一下。activity 表里的 quota 是名额上限signup_count 是已报名人数status 字段用来控制活动在首页是否展示答辩演示时可以把一个活动的 status 改成 2 演示「报名截止」逻辑。signup 表加一个 (activity_id, user_id) 的唯一索引是为了防止同一个用户对同一个活动重复报名这个索引在并发场景下比什么后端判断都管用。字符集统一用 utf8mb4不要用 utf8否则用户填的生僻字和表情符号会变成问号。user 表和 admin 表的结构通常是 id、openid、昵称、头像、创建时间admin 表可以额外加一个 role 字段方便扩展。2.4 后端三层结构与报名接口的事务后端代码一般是 controller-service-mapper 三层结构。Java Spring Boot 工程里的目录通常是这种src/main/java/com/example/activity/ controller/ ActivityController.java SignupController.java service/ ActivityService.java SignupService.java mapper/ ActivityMapper.java SignupMapper.java entity/ Activity.java Signup.javaController 只做参数接收和返回Service 写业务逻辑Mapper 管数据库操作。一个典型的活动列表接口长这样RestController RequestMapping(/api/activity) public class ActivityController { Autowired private ActivityService activityService; GetMapping(/list) public Result list(RequestParam(defaultValue 1) int page, RequestParam(defaultValue 10) int pageSize, Integer categoryId) { return Result.ok(activityService.page(page, pageSize, categoryId)); } }这里 RequestParam(defaultValue 1) 的作用是前端不传 page 时不报错categoryId 用了包装类型 Integer 而不是 int是因为它允许为空。报名接口是另一个重点名额扣减和报名记录插入必须放在一个事务里否则会出现「报名记录插进去了名额却没减」或者反过来。常见的写法是Transactional public boolean addSignup(Integer activityId, Integer userId) { int updated activityMapper.increaseSignupCount(activityId); if (updated 0) { throw new BusinessException(活动名额已满); } signupMapper.insert(activityId, userId); return true; }increaseSignupCount 对应的 SQL 是一个带条件的更新update activity set signup_count signup_count 1 where id ? and signup_count quota。这样用影响行数判断名额是否足够比先 select 再 update 安全得多。前端配合做防重复提交报名按钮点击后立刻置 loading 和 disabled后端再靠唯一索引兜底这就是「前端防重复 后端幂等」的标准做法答辩时这一套说清楚老师基本不会再追问业务细节。3. 本地跑通的三步MySQL 导入、后端配置与小程序的 baseURL3.1 第一步把 MySQL 环境弄到「能连」的状态这类压缩包 90% 的坑都集中在数据库这一步。所以先别碰后端和小程序先把 MySQL 弄成能连接的状态。第一步是确认本机 MySQL 可用在命令行里执行mysql --version如果提示 mysql 不是内部命令或未找到命令说明装了 MySQL 但没配环境变量Windows 上要去 MySQL 安装目录的 bin 文件夹里执行或者手动把路径加到 PATH。确认命令可用后登录并导入数据库脚本mysql -u root -p # 输入密码后进入 mysql 客户端然后执行 CREATE DATABASE IF NOT EXISTS activity DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;更省事的方式是直接写一条命令建库再写一条命令导入 sql 文件mysql -u root -p -e CREATE DATABASE IF NOT EXISTS activity DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p activity db/activity.sql这里的 db/activity.sql 是你解压后实际的 sql 文件路径以压缩包里的目录为准。如果 sql 文件里已经包含了 CREATE DATABASE 和 USE 语句那么省略手动建库这一步直接执行文件即可。提示第二次导入前如果报「表已存在」说明上次导入已经成功不需要反复执行。想重来就先把库删掉再重新建库DROP DATABASE activity然后按上面的两条命令顺序执行。3.2 第二步后端启动前只改一个配置文件就够了后端的配置文件一般叫 application.yml 或者 application.properties路径在 src/main/resources 下。用文本编辑器打开把数据库连接部分改成你的本机配置。server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/activity?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456这三项是必改的对照一下你本机的情况port 是后端端口不冲突就不用动url 里的 activity 对应你刚建的数据库名username 和 password 换成你自己 MySQL 的账号密码。url 后面那一串参数不要删useSSLfalse 避免 SSL 握手告警刷日志serverTimezoneAsia/Shanghai 解决 MySQL 8 的时区问题这俩在第五章还会再提。启动方式以压缩包里的说明文档为准。如果是打包好的 jar 包命令行执行 java -jar xxx.jar 就能起如果是 Maven 源码工程用 IDEA 打开等依赖下载完找到带有 SpringBootApplication 注解的启动类直接运行如果是 Node.js 版本的后端那就是 npm install 之后再 npm start。启动成功的标志是控制台出现 Started Application 之类的日志端口被监听。验证一下curl http://127.0.0.1:8080/api/activity/list能返回一段 JSON 就说明后端已经活了。如果返回 404优先检查接口路径前缀对不对比如后端项目是不是配了 context-path。3.3 第三步微信开发者工具导入项目并改 baseURL打开微信开发者工具选择「导入项目」选中压缩包里的小程序前端目录。AppID 可以先用测试号不影响本地开发调试。导入后第一件事是去「详情 - 本地设置」勾选「不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」这一步不做后面所有 http 请求都会被拦下来。然后找到小程序的配置文件通常叫 utils/config.js 或 utils/request.js里面会有一个 BASE_URL。改成这样// utils/config.js module.exports { BASE_URL: http://127.0.0.1:8080 };这里用 127.0.0.1 而不是 localhost是因为 Windows 上 localhost 有可能被解析成 IPv6 的 ::1而后端只监听了 IPv4导致连接失败。改完后模拟器编译首页能刷出活动列表说明这条链路已经打通。这时候你已经完成了拿到压缩包后最关键的验证数据库能导、后端能起、前端能连。4. 前后端联调真机预览为什么要换成局域网 IP以及 request 封装与排查4.1 别在 wx.request 里写回调地狱先封装一个 Promise 版 request直接在每个页面里写 wx.request 也能跑但代码会越来越难维护尤其是报名、取消报名、加载列表这些操作混在一起的时候。我一般会在 utils 目录下放一个 request.js统一处理请求头、状态码和错误提示。// utils/request.js const { BASE_URL } require(./config); const request (url, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL url, method, data, header: { content-type: application/json }, success: (res) { if (res.statusCode 200 res.statusCode 300 res.data.code 0) { resolve(res.data.data); } else { reject(res.data || { msg: 请求失败 }); } }, fail: (err) { reject(err); } }); }); }; module.exports request;这个封装做了三件事把 wx.request 包成 Promise页面里可以用 then/catch 而不是嵌套回调对后端统一返回结构 { code: 0, data: ..., msg: ... } 做判断只有 code 为 0 时才走 resolvefail 回调里直接 reject页面可以统一弹 toast。使用的时候页面代码会清爽得多// pages/index/index.js const request require(../../utils/request); Page({ data: { list: [], loading: false }, onLoad() { this.loadList(); }, loadList(page 1) { this.setData({ loading: true }); request(/api/activity/list, GET, { page, pageSize: 10 }) .then(data this.setData({ list: data.records })) .catch(err wx.showToast({ title: err.msg || 加载失败, icon: none })) .finally(() this.setData({ loading: false })); } });这里的关键点在于 loading 状态请求开始时置为 true结束时在 finally 里置回 false。这样既避免了重复点击也给下拉刷新和加载更多留了状态判断的口子对应了后端的防重复设计。4.2 真机预览为什么手机上请求不到 localhost这是前后端分离项目里最常见的一个翻车点开发者工具里一切正常切到真机预览就白屏控制台一水的 request:fail。原因很简单手机上的 127.0.0.1 指向的是手机自己不是你的电脑。真机要和电脑连通BASE_URL 必须换成电脑的局域网 IP。可以先在电脑上查 IPWindows 命令行执行 ipconfig找「IPv4 地址」那一栏Mac 或 Linux 执行 ifconfig | grep inet 排除 127.0.0.1 之外的那个地址。然后把 config.js 里的 BASE_URL 改成这个局域网地址。运行场景baseURL 写法说明开发者工具模拟器http://127.0.0.1:8080后端在本机模拟器与电脑共享网络真机预览http://192.168.x.x:8080手机与电脑连同一个 WiFiIP 为电脑局域网 IP生产环境https://你的域名小程序后台配置 request 合法域名且必须 HTTPS改完地址还有一个隐藏关卡Windows 防火墙默认会拦截外部设备对 Java 或 Node 端口的访问。第一次启动后端时如果弹过防火墙授权要勾选「专用网络允许访问」如果没弹就去「控制面板 - 防火墙 - 允许应用通过防火墙」把对应程序放行。验证手机和电脑能不能通可以手机浏览器直接访问 http://192.168.x.x:8080/某个接口能出 JSON 就说明网络通问题在小程序配置打不开则先解决防火墙。4.3 请求失败先按顺序查这四个位置联调出问题不要瞎猜按顺序来。第一后端到底起没起来看控制台有没有监听端口的日志。第二端口通不通命令行执行netstat -ano | findstr :8080能看到 LISTENING 说明端口在监听。第三直接用 curl 打接口排除微信开发者工具的因素。第四再看小程序端的请求打开调试器的 Network 面板看发出去的请求 URL 是什么、返回的状态码是多少。404 大概率是路径写错了对照后端 Controller 里的 RequestMapping 前缀和 GetMapping 路径逐一核对。500 是后端内部出错去后端控制台翻堆栈。超时基本是网络不通也就是局域网地址或防火墙的问题。这套排查顺序背下来答辩现场演示出问题也能稳住场面。5. 避坑记录乱码、时区、防火墙与答辩时连不上后端的五个翻车点5.1 导入 SQL 后列表全是?????字符集没对齐现象sql 文件执行成功后端也启动了但小程序里活动标题显示成一串问号数据库直接查也是问号。原因建库语句没有指定字符集MySQL 默认用了 latin1 或者没有真正落到 utf8mb4导入时客户端连接字符集和库字符集不一致。解决删库重建建库时显式指定字符集CREATE DATABASE activity DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci然后重新导入 sql 文件。同时检查后端连接串里有没有 characterEncodingutf8。这两处都对齐了中文基本不会乱。5.2 MySQL 8 启动后端报错The server time zone value现象后端一启动就抛出 java.sql.SQLException提示 The server time zone value ... is unrecognized or represents more than one time zone。原因MySQL 8 的时区信息和 JDBC 驱动之间没对齐这是版本差异不是代码 bug。解决在数据源连接 URL 里加 serverTimezoneAsia/Shanghai顺手把 useSSLfalse 也带上。改完如果还报错检查是不是改了 application.yml 但启动时加载的是 application-prod.yml这里容易看错文件。5.3 真机预览全部请求失败127.0.0.1 指向了手机自己现象开发者工具模拟器一切正常手机预览所有接口都请求失败控制台没有任何 HTTP 状态码。原因手机上的 127.0.0.1 是手机本机请求根本没发到电脑上即使地址改成电脑局域网 IPWindows 防火墙拦截也会导致失败。解决BASE_URL 换成电脑局域网 IP手机和电脑连同一个 WiFi防火墙放行后端端口。改完先手机浏览器访问接口测通再回小程序预览。5.4 开发者工具里 request:fail后端明明活着现象后端确认已在运行curl 也通但小程序里所有请求 statusCode 都没有直接 fail。原因微信开发者工具默认校验 HTTPS 和合法域名本地 http 请求会被拦。AppID 如果是正式小程序账号还会有域名白名单限制。解决进「详情 - 本地设置」勾选「不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」。本地开发阶段这个开关必须开着上线前再关掉。5.5 后端报了 500控制台却看不到堆栈原因现象小程序里看到 500后端控制台只有一行状态码日志没有异常堆栈。原因日志级别配得比较高DEBUG 信息被过滤或者源码里有全局异常处理器把异常吞掉后只返回了统一错误码。解决先把日志级别调成 debug看有没有更多输出如果没有用 curl 复现一次请求再去后端日志文件里找 ERROR 行。还找不到就去看全局异常处理类临时注释掉堆栈就会重新打到控制台。黑匣子不怕怕的是不愿意打开看。6. 给答辩留一手演示数据脚本、接口自测清单与启动手册演示环节最尴尬的不是代码报错而是页面上空荡荡没数据或者活动时间全部过期。答辩前建议生成一批「永远不过期」的演示数据用存储过程一次插入 20 条相对时间活动时间以 NOW() 为基准什么时候演示都有效。DROP PROCEDURE IF EXISTS gen_demo_data; DELIMITER $$ CREATE PROCEDURE gen_demo_data() BEGIN DECLARE i INT DEFAULT 1; WHILE i 20 DO INSERT INTO activity(title, cover, location, start_time, end_time, quota, status) VALUES(CONCAT(示例活动, i), , CONCAT(报告厅, i), NOW(), DATE_ADD(NOW(), INTERVAL 3 HOUR), 50, 1); SET i i 1; END WHILE; END$$ DELIMITER ; CALL gen_demo_data();这段 SQL 里有几个小心思CONCAT(示例活动, i) 生成标题不用手打 20 条NOW() 作为开始时间演示当天插入当天就有效end_time 用 DATE_ADD 加 3 小时保证活动处于「报名中」状态。手动造数据也行但字段容易漏不如脚本一次到位。接口自测清单照着跑一遍确认每个核心接口都没问题再进答辩现场。接口测试命令期望结果活动列表curl http://127.0.0.1:8080/api/activity/list?page1pageSize5返回 JSON包含 5 条活动活动详情curl http://127.0.0.1:8080/api/activity/detail?id1返回 id1 的活动对象提交报名curl -X POST http://127.0.0.1:8080/api/signup/add -H Content-Type: application/json -d {activityId:1}code 为 0库里 signup_count 加 1我的报名curl http://127.0.0.1:8080/api/signup/my返回刚才的报名记录取消报名curl -X POST http://127.0.0.1:8080/api/signup/cancel -H Content-Type: application/json -d {signupId:1}code 为 0名额减 1新增活动curl -X POST http://127.0.0.1:8080/api/activity/add -H Content-Type: application/json -d {title:测试活动}code 为 0列表页能看到新活动最后提一个启动手册的习惯把启动顺序写在一个文本文件里从启动 MySQL、导入最新 sql、启动后端到编译小程序四步每一步写清命令和验证方式。答辩前一天按这个顺序从零跑一遍不要临时改数据库密码、不要换端口、不要动 IP。这是我自己的血泪经验当年答辩前一天顺手改了个 MySQL 密码第二天现场死活连不上最后发现是密码记混了。从那以后我养成了这个习惯答辩前只做一件事按启动手册在另一台电脑上从零跑一遍。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/13 5:16:09 · 阅读 1.2k 微信小程序活动报名管理系统：本地部署与联调避坑指南
简介面向毕业设计与课程设计场景的微信小程序活动报名管理系统基于Java与SSM框架搭建后台搭配uniapp/原生小程序前端覆盖站内新闻、活动信息展示、在线报名、个人中心以及管理员端的活动管理、报名审核与用户管理等完整业务流程适合Java或小程序方向的学生直接参考或二次开发。资源共424个文件压缩包34.59MB以java源码、class编译文件、jar依赖库、xml配置与SQL脚本为主同时包含wxml/wxss/js等小程序页面文件及说明文档前后端代码与数据库脚本齐全导入Eclipse/Idea并用MySQL 5.7即可运行。已有84人浏览学习对需要快速搭建可演示的报名类小程序课题、理解SSM与小程序联调过程会有直接帮助。1. 微信小程序的活动报名管理系统拿到压缩包后先做哪三件事打开压缩包的那一瞬间绝大多数人的反应是懵的前端文件夹、后端文件夹、sql 文件还有个说明文档LW不知道先运行哪个。这套微信小程序的活动报名管理系统说白了就是一套能直接演示的毕业设计工程小程序端负责报名和展示后端负责业务逻辑MySQL 存数据说明文档告诉你启动步骤和数据库怎么导入。它要解决的不是「学会开发」而是「在有限时间里交付一个能答辩、能写论文、能演示的完整闭环」。适合时间紧的计算机类本科毕设也适合拿去练前后端联调。我建议拿到手先做三件事确认 SQL 脚本能导入、确认后端能启动、确认小程序端能连上后端。这三件事走通剩下的都是改参数和造数据的工作量。2. 功能边界与数据模型接口清单、核心 MySQL 表和报名事务2.1 功能模块与小程序页面怎么拆一个小程序活动报名系统业务上至少要拆出两类角色。普通用户浏览活动、看详情、报名、取消报名、查看自己的报名记录。管理员发布活动、设置名额和截止时间、查看报名名单。在毕业设计里通常不单独做一套 Web 管理后台而是共用一个小程序后端登录接口拿到 openid 后去管理员表里查一下命中就把 isAdmin 字段放进返回参数小程序首页条件渲染一个「管理入口」。这样角色权限也能写进论文的模块设计里。页面一般这么分pages/index/index活动列表、pages/detail/detail活动详情与报名入口、pages/apply/apply报名表单、pages/my/my我的报名、pages/admin/admin管理员页。列表页想做得完整一点可以加分类 tabs下面接 onReachBottom 触底加载更多对应后端分页参数 page 和 pageSize。报名表单里选票种或场次用 radio 组件就行字段对应活动表里的一个类型字段这样论文里能写「表单组件与数据绑定」这一段。2.2 接口清单先想清楚小程序要调哪些后端能力接口设计直接决定前后端联调顺不顺畅。常见的拆分是六个到八个接口小程序端的每个页面都能找到对应的接口而不是一个接口包打天下。下面这张表是我在同类项目里常用的接口划分方式接口路径以你压缩包里的源码为准但职责基本一致。方法路径说明关键参数GET/api/activity/list分页活动列表page, pageSize, categoryIdGET/api/activity/detail活动详情idPOST/api/signup/add提交报名activityId, phone, remarkPOST/api/signup/cancel取消报名signupIdGET/api/signup/my我的报名列表无openid 由后端解析POST/api/activity/add新增活动管理员title, location, quota 等GET/api/signup/list某活动的报名名单activityId接口约定里有一个安全细节容易被忽略用户身份不应该由小程序端把 openid 传过来而是前端调 wx.login 拿 code后端拿 code 去微信接口换 openid再把这个身份状态记在会话里。毕设答辩时老师问到「用户身份怎么识别」这就是一个加分回答。2.3 MySQL 表设计四张表撑起一个闭环数据库是整个系统最先要落地的东西。这类系统常见的表结构是四张活动表 activity、用户表 user、报名表 signup、管理员表 admin。活动表承载业务主体报名表连接用户和活动用户表存 openid 和昵称头像管理员表用来判断权限。先看核心的活动表和报名表。CREATE TABLE activity ( id int(11) NOT NULL AUTO_INCREMENT, title varchar(100) NOT NULL COMMENT 活动标题, cover varchar(255) DEFAULT COMMENT 封面图URL, location varchar(100) DEFAULT COMMENT 活动地点, start_time datetime DEFAULT NULL COMMENT 开始时间, end_time datetime DEFAULT NULL COMMENT 结束时间, quota int(11) DEFAULT 0 COMMENT 名额上限0表示不限, signup_count int(11) DEFAULT 0 COMMENT 已报名人数, status tinyint(4) DEFAULT 1 COMMENT 0下架 1上架 2截止, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_status (status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT活动表; CREATE TABLE signup ( id int(11) NOT NULL AUTO_INCREMENT, activity_id int(11) NOT NULL, user_id int(11) NOT NULL, phone varchar(20) DEFAULT COMMENT 联系电话, remark varchar(255) DEFAULT COMMENT 备注, status tinyint(4) DEFAULT 1 COMMENT 1已报名 0已取消, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_activity_user (activity_id, user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT报名表;这两张表的关键字段解释一下。activity 表里的 quota 是名额上限signup_count 是已报名人数status 字段用来控制活动在首页是否展示答辩演示时可以把一个活动的 status 改成 2 演示「报名截止」逻辑。signup 表加一个 (activity_id, user_id) 的唯一索引是为了防止同一个用户对同一个活动重复报名这个索引在并发场景下比什么后端判断都管用。字符集统一用 utf8mb4不要用 utf8否则用户填的生僻字和表情符号会变成问号。user 表和 admin 表的结构通常是 id、openid、昵称、头像、创建时间admin 表可以额外加一个 role 字段方便扩展。2.4 后端三层结构与报名接口的事务后端代码一般是 controller-service-mapper 三层结构。Java Spring Boot 工程里的目录通常是这种src/main/java/com/example/activity/ controller/ ActivityController.java SignupController.java service/ ActivityService.java SignupService.java mapper/ ActivityMapper.java SignupMapper.java entity/ Activity.java Signup.javaController 只做参数接收和返回Service 写业务逻辑Mapper 管数据库操作。一个典型的活动列表接口长这样RestController RequestMapping(/api/activity) public class ActivityController { Autowired private ActivityService activityService; GetMapping(/list) public Result list(RequestParam(defaultValue 1) int page, RequestParam(defaultValue 10) int pageSize, Integer categoryId) { return Result.ok(activityService.page(page, pageSize, categoryId)); } }这里 RequestParam(defaultValue 1) 的作用是前端不传 page 时不报错categoryId 用了包装类型 Integer 而不是 int是因为它允许为空。报名接口是另一个重点名额扣减和报名记录插入必须放在一个事务里否则会出现「报名记录插进去了名额却没减」或者反过来。常见的写法是Transactional public boolean addSignup(Integer activityId, Integer userId) { int updated activityMapper.increaseSignupCount(activityId); if (updated 0) { throw new BusinessException(活动名额已满); } signupMapper.insert(activityId, userId); return true; }increaseSignupCount 对应的 SQL 是一个带条件的更新update activity set signup_count signup_count 1 where id ? and signup_count quota。这样用影响行数判断名额是否足够比先 select 再 update 安全得多。前端配合做防重复提交报名按钮点击后立刻置 loading 和 disabled后端再靠唯一索引兜底这就是「前端防重复 后端幂等」的标准做法答辩时这一套说清楚老师基本不会再追问业务细节。3. 本地跑通的三步MySQL 导入、后端配置与小程序的 baseURL3.1 第一步把 MySQL 环境弄到「能连」的状态这类压缩包 90% 的坑都集中在数据库这一步。所以先别碰后端和小程序先把 MySQL 弄成能连接的状态。第一步是确认本机 MySQL 可用在命令行里执行mysql --version如果提示 mysql 不是内部命令或未找到命令说明装了 MySQL 但没配环境变量Windows 上要去 MySQL 安装目录的 bin 文件夹里执行或者手动把路径加到 PATH。确认命令可用后登录并导入数据库脚本mysql -u root -p # 输入密码后进入 mysql 客户端然后执行 CREATE DATABASE IF NOT EXISTS activity DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;更省事的方式是直接写一条命令建库再写一条命令导入 sql 文件mysql -u root -p -e CREATE DATABASE IF NOT EXISTS activity DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p activity db/activity.sql这里的 db/activity.sql 是你解压后实际的 sql 文件路径以压缩包里的目录为准。如果 sql 文件里已经包含了 CREATE DATABASE 和 USE 语句那么省略手动建库这一步直接执行文件即可。提示第二次导入前如果报「表已存在」说明上次导入已经成功不需要反复执行。想重来就先把库删掉再重新建库DROP DATABASE activity然后按上面的两条命令顺序执行。3.2 第二步后端启动前只改一个配置文件就够了后端的配置文件一般叫 application.yml 或者 application.properties路径在 src/main/resources 下。用文本编辑器打开把数据库连接部分改成你的本机配置。server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/activity?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456这三项是必改的对照一下你本机的情况port 是后端端口不冲突就不用动url 里的 activity 对应你刚建的数据库名username 和 password 换成你自己 MySQL 的账号密码。url 后面那一串参数不要删useSSLfalse 避免 SSL 握手告警刷日志serverTimezoneAsia/Shanghai 解决 MySQL 8 的时区问题这俩在第五章还会再提。启动方式以压缩包里的说明文档为准。如果是打包好的 jar 包命令行执行 java -jar xxx.jar 就能起如果是 Maven 源码工程用 IDEA 打开等依赖下载完找到带有 SpringBootApplication 注解的启动类直接运行如果是 Node.js 版本的后端那就是 npm install 之后再 npm start。启动成功的标志是控制台出现 Started Application 之类的日志端口被监听。验证一下curl http://127.0.0.1:8080/api/activity/list能返回一段 JSON 就说明后端已经活了。如果返回 404优先检查接口路径前缀对不对比如后端项目是不是配了 context-path。3.3 第三步微信开发者工具导入项目并改 baseURL打开微信开发者工具选择「导入项目」选中压缩包里的小程序前端目录。AppID 可以先用测试号不影响本地开发调试。导入后第一件事是去「详情 - 本地设置」勾选「不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」这一步不做后面所有 http 请求都会被拦下来。然后找到小程序的配置文件通常叫 utils/config.js 或 utils/request.js里面会有一个 BASE_URL。改成这样// utils/config.js module.exports { BASE_URL: http://127.0.0.1:8080 };这里用 127.0.0.1 而不是 localhost是因为 Windows 上 localhost 有可能被解析成 IPv6 的 ::1而后端只监听了 IPv4导致连接失败。改完后模拟器编译首页能刷出活动列表说明这条链路已经打通。这时候你已经完成了拿到压缩包后最关键的验证数据库能导、后端能起、前端能连。4. 前后端联调真机预览为什么要换成局域网 IP以及 request 封装与排查4.1 别在 wx.request 里写回调地狱先封装一个 Promise 版 request直接在每个页面里写 wx.request 也能跑但代码会越来越难维护尤其是报名、取消报名、加载列表这些操作混在一起的时候。我一般会在 utils 目录下放一个 request.js统一处理请求头、状态码和错误提示。// utils/request.js const { BASE_URL } require(./config); const request (url, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL url, method, data, header: { content-type: application/json }, success: (res) { if (res.statusCode 200 res.statusCode 300 res.data.code 0) { resolve(res.data.data); } else { reject(res.data || { msg: 请求失败 }); } }, fail: (err) { reject(err); } }); }); }; module.exports request;这个封装做了三件事把 wx.request 包成 Promise页面里可以用 then/catch 而不是嵌套回调对后端统一返回结构 { code: 0, data: ..., msg: ... } 做判断只有 code 为 0 时才走 resolvefail 回调里直接 reject页面可以统一弹 toast。使用的时候页面代码会清爽得多// pages/index/index.js const request require(../../utils/request); Page({ data: { list: [], loading: false }, onLoad() { this.loadList(); }, loadList(page 1) { this.setData({ loading: true }); request(/api/activity/list, GET, { page, pageSize: 10 }) .then(data this.setData({ list: data.records })) .catch(err wx.showToast({ title: err.msg || 加载失败, icon: none })) .finally(() this.setData({ loading: false })); } });这里的关键点在于 loading 状态请求开始时置为 true结束时在 finally 里置回 false。这样既避免了重复点击也给下拉刷新和加载更多留了状态判断的口子对应了后端的防重复设计。4.2 真机预览为什么手机上请求不到 localhost这是前后端分离项目里最常见的一个翻车点开发者工具里一切正常切到真机预览就白屏控制台一水的 request:fail。原因很简单手机上的 127.0.0.1 指向的是手机自己不是你的电脑。真机要和电脑连通BASE_URL 必须换成电脑的局域网 IP。可以先在电脑上查 IPWindows 命令行执行 ipconfig找「IPv4 地址」那一栏Mac 或 Linux 执行 ifconfig | grep inet 排除 127.0.0.1 之外的那个地址。然后把 config.js 里的 BASE_URL 改成这个局域网地址。运行场景baseURL 写法说明开发者工具模拟器http://127.0.0.1:8080后端在本机模拟器与电脑共享网络真机预览http://192.168.x.x:8080手机与电脑连同一个 WiFiIP 为电脑局域网 IP生产环境https://你的域名小程序后台配置 request 合法域名且必须 HTTPS改完地址还有一个隐藏关卡Windows 防火墙默认会拦截外部设备对 Java 或 Node 端口的访问。第一次启动后端时如果弹过防火墙授权要勾选「专用网络允许访问」如果没弹就去「控制面板 - 防火墙 - 允许应用通过防火墙」把对应程序放行。验证手机和电脑能不能通可以手机浏览器直接访问 http://192.168.x.x:8080/某个接口能出 JSON 就说明网络通问题在小程序配置打不开则先解决防火墙。4.3 请求失败先按顺序查这四个位置联调出问题不要瞎猜按顺序来。第一后端到底起没起来看控制台有没有监听端口的日志。第二端口通不通命令行执行netstat -ano | findstr :8080能看到 LISTENING 说明端口在监听。第三直接用 curl 打接口排除微信开发者工具的因素。第四再看小程序端的请求打开调试器的 Network 面板看发出去的请求 URL 是什么、返回的状态码是多少。404 大概率是路径写错了对照后端 Controller 里的 RequestMapping 前缀和 GetMapping 路径逐一核对。500 是后端内部出错去后端控制台翻堆栈。超时基本是网络不通也就是局域网地址或防火墙的问题。这套排查顺序背下来答辩现场演示出问题也能稳住场面。5. 避坑记录乱码、时区、防火墙与答辩时连不上后端的五个翻车点5.1 导入 SQL 后列表全是?????字符集没对齐现象sql 文件执行成功后端也启动了但小程序里活动标题显示成一串问号数据库直接查也是问号。原因建库语句没有指定字符集MySQL 默认用了 latin1 或者没有真正落到 utf8mb4导入时客户端连接字符集和库字符集不一致。解决删库重建建库时显式指定字符集CREATE DATABASE activity DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci然后重新导入 sql 文件。同时检查后端连接串里有没有 characterEncodingutf8。这两处都对齐了中文基本不会乱。5.2 MySQL 8 启动后端报错The server time zone value现象后端一启动就抛出 java.sql.SQLException提示 The server time zone value ... is unrecognized or represents more than one time zone。原因MySQL 8 的时区信息和 JDBC 驱动之间没对齐这是版本差异不是代码 bug。解决在数据源连接 URL 里加 serverTimezoneAsia/Shanghai顺手把 useSSLfalse 也带上。改完如果还报错检查是不是改了 application.yml 但启动时加载的是 application-prod.yml这里容易看错文件。5.3 真机预览全部请求失败127.0.0.1 指向了手机自己现象开发者工具模拟器一切正常手机预览所有接口都请求失败控制台没有任何 HTTP 状态码。原因手机上的 127.0.0.1 是手机本机请求根本没发到电脑上即使地址改成电脑局域网 IPWindows 防火墙拦截也会导致失败。解决BASE_URL 换成电脑局域网 IP手机和电脑连同一个 WiFi防火墙放行后端端口。改完先手机浏览器访问接口测通再回小程序预览。5.4 开发者工具里 request:fail后端明明活着现象后端确认已在运行curl 也通但小程序里所有请求 statusCode 都没有直接 fail。原因微信开发者工具默认校验 HTTPS 和合法域名本地 http 请求会被拦。AppID 如果是正式小程序账号还会有域名白名单限制。解决进「详情 - 本地设置」勾选「不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」。本地开发阶段这个开关必须开着上线前再关掉。5.5 后端报了 500控制台却看不到堆栈原因现象小程序里看到 500后端控制台只有一行状态码日志没有异常堆栈。原因日志级别配得比较高DEBUG 信息被过滤或者源码里有全局异常处理器把异常吞掉后只返回了统一错误码。解决先把日志级别调成 debug看有没有更多输出如果没有用 curl 复现一次请求再去后端日志文件里找 ERROR 行。还找不到就去看全局异常处理类临时注释掉堆栈就会重新打到控制台。黑匣子不怕怕的是不愿意打开看。6. 给答辩留一手演示数据脚本、接口自测清单与启动手册演示环节最尴尬的不是代码报错而是页面上空荡荡没数据或者活动时间全部过期。答辩前建议生成一批「永远不过期」的演示数据用存储过程一次插入 20 条相对时间活动时间以 NOW() 为基准什么时候演示都有效。DROP PROCEDURE IF EXISTS gen_demo_data; DELIMITER $$ CREATE PROCEDURE gen_demo_data() BEGIN DECLARE i INT DEFAULT 1; WHILE i 20 DO INSERT INTO activity(title, cover, location, start_time, end_time, quota, status) VALUES(CONCAT(示例活动, i), , CONCAT(报告厅, i), NOW(), DATE_ADD(NOW(), INTERVAL 3 HOUR), 50, 1); SET i i 1; END WHILE; END$$ DELIMITER ; CALL gen_demo_data();这段 SQL 里有几个小心思CONCAT(示例活动, i) 生成标题不用手打 20 条NOW() 作为开始时间演示当天插入当天就有效end_time 用 DATE_ADD 加 3 小时保证活动处于「报名中」状态。手动造数据也行但字段容易漏不如脚本一次到位。接口自测清单照着跑一遍确认每个核心接口都没问题再进答辩现场。接口测试命令期望结果活动列表curl http://127.0.0.1:8080/api/activity/list?page1pageSize5返回 JSON包含 5 条活动活动详情curl http://127.0.0.1:8080/api/activity/detail?id1返回 id1 的活动对象提交报名curl -X POST http://127.0.0.1:8080/api/signup/add -H Content-Type: application/json -d {activityId:1}code 为 0库里 signup_count 加 1我的报名curl http://127.0.0.1:8080/api/signup/my返回刚才的报名记录取消报名curl -X POST http://127.0.0.1:8080/api/signup/cancel -H Content-Type: application/json -d {signupId:1}code 为 0名额减 1新增活动curl -X POST http://127.0.0.1:8080/api/activity/add -H Content-Type: application/json -d {title:测试活动}code 为 0列表页能看到新活动最后提一个启动手册的习惯把启动顺序写在一个文本文件里从启动 MySQL、导入最新 sql、启动后端到编译小程序四步每一步写清命令和验证方式。答辩前一天按这个顺序从零跑一遍不要临时改数据库密码、不要换端口、不要动 IP。这是我自己的血泪经验当年答辩前一天顺手改了个 MySQL 密码第二天现场死活连不上最后发现是密码记混了。从那以后我养成了这个习惯答辩前只做一件事按启动手册在另一台电脑上从零跑一遍。希望帮到你。本文还有配套的精品资源点击获取