微信小程序+Java后端互助学习毕设项目：架构设计与源码解析

简介基于微信小程序与Java后端实现的互助学习平台毕业设计适合计算机相关专业学生用于毕业设计与课程设计参考。包内提供完整项目源码、演示视频、说明文档及数据库文件覆盖管理员端个人中心、学生管理、课程分类、课程信息、课程评价、学习计划、留言板、学习论坛等核心功能模块小程序端支持注册登录、查看课程、评价课程、制定学习计划与留言操作。资源共1306个文件以png、js、vue、java、json、wxss、wxml等类型为主包含前端页面、后端逻辑、接口配置与数据库脚本压缩包约25.37MB目录结构清晰便于按模块学习。已有127人学习适合需要快速搭建同类项目、理解前后端交互与部署流程的读者。1. 互助学习小程序与 Java 后端的毕设项目这份压缩包里到底是什么每年毕业季的选题清单里商城、博客、外卖已经排成了同质化重灾区互助学习是少数能把“内容发布、多人申请、结果评价、积分闭环”串起来的题目。标题里的“微信小程序Java后端”把端与服务切得很干净小程序负责展示和交互后端负责登录鉴权、互助单流转和图片存储括号里的“源码演示视频说明数据库”意味着交付物不是几张效果图而是一套解压后能初始化数据库、能编译、能对着视频复现流程的完整工程。这篇文章会顺着这类项目的通用做法把技术选型、表结构、接口设计、小程序联调和上线排错拆开讲适合正在做同类毕设的人也适合想把毕业设计当成面试项目讲清楚的前后端开发者。2. 技术选型与工程结构为什么是原生微信小程序与 Spring Boot2.1 原生小程序、Spring Boot、MySQL毕设里的默认答案拿到标题先要判断一件事前端的“微信小程序”是原生还是 uniapp 编译产物。原生小程序工程里会有 pages、app.json、app.wxss、project.config.json 这些文件如果是用 HBuilderX 开发 uniapp 微信小程序上传到微信开发者工具的其实是 unpackage/dist/dev/mp-weixin 目录下的编译结果。判断方法很简单打开小程序根目录看有没有 app.json 和 sitemap.json有就是原生再去项目配置里看有没有 manifest.json有就是 uniapp 工程。原生写法的好处是少一层编译页面生命周期、组件行为跟微信开发者工具完全同步缺点是只活在微信生态里。但对一个毕设来说把精力花在业务逻辑上更重要所以我不建议在这个时候为了“跨端”选 uniapp。uniapp 的价值在多端复用而互助学习这类题目的典型使用场景就两个微信里找搭子、微信里看进度没有同时上 App 和 H5 的硬需求。后端侧几乎不用纠结。标题里的“Java 后端”在绝大多数源码包里落成 Spring Boot 工程配合 MyBatis-Plus 简化单表 CRUD。这一点很符合 java 后端学习路线的节奏JDK 只是运行环境Spring 解决对象管理Spring Boot 解决自动装配MyBatis 解决 SQL 与 Java 的映射。拿到源码之后先别急着读 Controller先在 IDEA 里打开工程等 Maven 把依赖下载完改一下数据库账号密码能启动之后再谈改代码——这是接手一个 Java Spring Boot 项目最快上手的顺序。2.2 数据库引擎默认 MySQL但别把话说死标题上只写“数据库”没指定厂商这是绝大多数毕设源码包的常态。脚本默认按 MySQL 写AUTO_INCREMENT 自增主键、tinyint 状态位、utf8mb4 字符集。如果你的学校要求写国产数据库方向的论文需要把达梦数据库或 Oracle 当作迁移目标而不是重写。三者的差异集中在三处自增主键MySQL 的 AUTO_INCREMENT 在达梦里用 IDENTITY在 Oracle 里要用序列、字符串拼接||在 MySQL 默认不开 PIPES_AS_CONCAT、表名大小写Oracle 默认大写MySQL 在 Linux 下区分大小写。我一般会把业务 SQL 严格小写表名、用标准 LEFT JOIN 而不是 Oracle 专有的()写法这样换库的成本最低。2.3 源码包里的标准结构与验证命令通常情况下rar 解压之后会得到这么一层东西后端工程目录、微信小程序端目录、数据库脚本、说明文档、演示视频。一个好的后端工程至少包含 src 主代码、pom.xml、application.yml小程序端至少包含 app.js、app.json、pages 目录。目录/文件内容在毕设里的作用server/ 或 backend/Spring Boot 源码含 Controller、Service、Mapper提供接口运行在 8080 端口miniprogram/原生微信小程序页面pages、utils、app.*用户端交互界面sql/mutual_learning.sql建库建表脚本与演示数据答辩前恢复环境用说明文档部署步骤、接口说明、账号信息给评审老师看操作路径演示视频从登录到发布互助单的录屏环境出问题时兜底先确认里面是这些内容再往后走。如果一个“源码包”里只有页面截图没有 pom.xml 和 app.json那它连工程都算不上更没法改。在本地我通常跑一遍这个命令确认目录结构没缺东西# 先看压缩包内容再检查三个关键文件是否齐全 unrar l 互助学习毕设.rar 2/dev/null || 7z l 互助学习毕设.rar ls server/pom.xml 2/dev/null echo backend ok ls miniprogram/app.json 2/dev/null echo mp ok ls sql/mutual_learning.sql 2/dev/null echo database ok这个命令先列出压缩包内容再检查三个关键文件pom.xml 是 Java 后端能编译的标志app.json 是微信小程序端能导入开发者工具的标志.sql 是数据库能恢复的标志。三样都在源码才可复现。2.4 环境准备只需要 JDK、Maven、IDEA 和微信开发者工具后端要跑起来只需要 JDK 8/11/17 与 Maven 3.6IDEA 负责提供编译和调试环境。数据库用 Navicat 或命令行导入都行。微信端用微信开发者工具导入 miniprogram 目录把 AppID 换成你注册的测试号在详情设置里勾选“不校验合法域名”就能在本机联调不用等域名备案。3. 互助学习核心表设计数据库脚本不是随便写的3.1 先把业务实体拆成四张表互助学习和普通预约类应用的差别在多人申请一个求助帖可以被多个人申请帮忙但最后只能有一人接单。因此不能把所有信息堆进一张订单表拆表是第一步。我一般会拆出这几张表用户表存账号资料互助单表存求助内容与状态接单表存所有申请记录学习记录表存互助完成后的评价与积分。把申请记录单独拆出来的意义是保留“谁申请过、谁被拒绝了”的历史评审老师翻开数据库课程设计要的就是这种能讲出道理的关联关系而不是单纯的增删改查。3.2 最小可用的建表脚本CREATE DATABASE IF NOT EXISTS mutual_learning DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE mutual_learning; -- 用户表openid 对应小程序登录身份points 放积分 CREATE TABLE t_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, openid VARCHAR(64) NOT NULL UNIQUE, nickname VARCHAR(50) NOT NULL DEFAULT , avatar VARCHAR(255) NOT NULL DEFAULT , points INT NOT NULL DEFAULT 0, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, KEY idx_create_time (create_time) ) ENGINEInnoDB; -- 互助单status 0待接单 1进行中 2已完成 3已取消 CREATE TABLE t_help_order ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, title VARCHAR(100) NOT NULL, description TEXT NOT NULL, subject VARCHAR(20) NOT NULL DEFAULT , expect_time DATETIME DEFAULT NULL, status TINYINT NOT NULL DEFAULT 0, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, KEY idx_user_id (user_id), KEY idx_status_create (status, create_time) ) ENGINEInnoDB; -- 接单表一条互助单可以有多条申请accepted 标记最终接单人 CREATE TABLE t_help_accept ( id BIGINT PRIMARY KEY AUTO_INCREMENT, order_id BIGINT NOT NULL, user_id BIGINT NOT NULL, accepted TINYINT NOT NULL DEFAULT 0, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_order_user (order_id, user_id) ) ENGINEInnoDB; -- 学习记录互助完成后给评价与积分积分回到 t_user.points CREATE TABLE t_learn_record ( id BIGINT PRIMARY KEY AUTO_INCREMENT, order_id BIGINT NOT NULL, helper_id BIGINT NOT NULL, owner_id BIGINT NOT NULL, rating TINYINT NOT NULL DEFAULT 5, comment VARCHAR(500) NOT NULL DEFAULT , points INT NOT NULL DEFAULT 1, create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB;这套建表脚本直接复制进 Navicat 执行即可。字段名保持小写下划线风格和 Java 实体里的驼峰命名靠 MyBatis-Plus 的驼峰映射自动转换不需要手写 resultMap。3.3 字段设计里值得注意的细节字段类型设计理由openidVARCHAR(64)微信登录后拿到的是 28 位左右的字符串加唯一约束避免重复注册statusTINYINT用数字存状态前端拿枚举值映射文案别直接用中文descriptionTEXT求助内容可能超过 255 字节用 TEXT 而不是 VARCHAR(255)pointsINT积分是聚合数据保留在用户表里查询个人中心时不用再做 SUMaccept 表唯一键(order_id, user_id)防止同一个人重复申请同一个互助单时间字段DATETIME用 TIMESTAMP 在跨时区部署时容易差 8 小时毕设用 DATETIME 更省心这里有一个很典型的坑MySQL 5.7 里如果建表没指定字符集默认可能是拉丁字符集插入中文直接报错或变问号。所以在 CREATE DATABASE 阶段就写死 utf8mb4之后导入文件也要在 Navicat 里把字符集选成 utf8mb4。要是评审要求迁到达梦数据库自增主键要改成 IDENTITY(1,1)再删掉 KEY 索引的命名语法就能兼容。3.4 演示数据里必须包含的内容数据库脚本除了 DDL还应该有一段 INSERT 演示数据至少包括一个管理员账号、两个普通用户、三条不同状态的互助单。这样答辩演示“发布、接单、互相评价”流程时不需要现场填表单。账号密码不要存明文用 BCrypt 加密后再写进 INSERT评分字段给 4-5 分的数据避免全 5 分显得假。注意演示数据的 id 必须显式写在 INSERT 里否则外键关系会在导入时全断前端页面也会关联不到发布人。4. Java 后端接口实现登录、互助单、上传三个绕不开的模块4.1 登录与 JWT小程序 code 换 token 的链路微信小程序端先调 wx.login 拿到临时 code后端拿这个 code 去微信接口换 openid。毕设阶段如果没有正式的小程序 AppID很多源码会退化为“根据昵称直接注册或登录”但正规路径应该这么写RestController RequestMapping(/api/auth) public class AuthController { Resource private UserService userService; // 入参{ code: wx.login返回的临时凭证 } PostMapping(/login) public RString login(RequestBody LoginParam param) { // 实际开发中用 code 换 openid这里模拟从 code 解析出固定测试 openid String openid WxOpenIdResolver.resolve(param.getCode()); User user userService.findOrCreate(openid); String token JwtUtil.generateToken(user.getId()); return R.ok(token); } }参数说明wx.login 的 code 有效期只有五分钟所以不能存数据库拿到就要立刻换 openidtoken 的有效期一般设置 7 天前端把它放 storage 里每次请求通过 Authorization 头带回。JwtUtil 的核心逻辑是设置过期时间和用户标识两个字段签名时统一用同一把密钥密钥不要写在源码里读 application.yml 里的配置项。4.2 互助单的分页接口列表要能按科目和状态筛列表接口是微信小程序首页的数据来源接口设计要同时满足分页、筛选、排序三个诉求GetMapping(/api/help/list) public RPageResultHelpOrderVO list( RequestParam(defaultValue 1) int page, RequestParam(defaultValue 10) int size, RequestParam(required false) String subject, RequestParam(required false) Integer status) { // page 从 1 开始计数SQL 里换算成 offset (page - 1) * size PageResultHelpOrderVO result helpOrderService.queryPage(page, size, subject, status); return R.ok(result); }这里的 page/size 是后端最常见的参数命名前端翻页时把 scroll-view 的触底事件绑定到 page1 即可。subject 和 status 都允许为空为空表示不过滤状态码的枚举值前后端要约定死0 是待接单1 是进行中2 是已完成3 是已取消。SQL 层用动态 WHERE 拼条件MyBatis-Plus 里用 LambdaQueryWrapper 写。4.3 图片上传存哪里比怎么存更重要互助单可以带图片上传接口用 MultipartFile 接收PostMapping(/api/upload) public RString upload(RequestParam(file) MultipartFile file) throws IOException { if (file.isEmpty() || file.getSize() 5 * 1024 * 1024) { return R.fail(文件不能为空且不超过5MB); } String dir uploadPath / LocalDate.now().toString(); Files.createDirectories(Paths.get(dir)); String filename UUID.randomUUID().toString().replace(-, ) getExt(file.getOriginalFilename()); file.transferTo(Paths.get(dir, filename)); return R.ok(/uploads/ LocalDate.now() / filename); }注意三件事文件名不能用用户原始名称必须 UUID 重命名否则有重名覆盖和路径穿越问题大小限制放在后端做小程序端压缩只是前置访问路径和保存路径要分开Spring Boot 里通过 ResourceHandler 把 /uploads/** 映射到本地磁盘目录。小程序端要显示这张图片需要在小程序后台配置 downloadFile 合法域名本地调试可以临时勾选“不校验合法域名”。4.4 拦截器与统一返回体校验 token 不该写在每个接口里接口多了之后每个方法里都判断 Authorization 头会写吐。用一个 HandlerInterceptor 统一校验public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest req, HttpServletResponse resp, Object handler) { if (!(handler instanceof HandlerMethod)) return true; String token req.getHeader(Authorization); Long userId JwtUtil.parseToken(token); if (userId null) { resp.setStatus(401); return false; } req.setAttribute(userId, userId); return true; } }逻辑说明先放行静态资源再从请求头解析 token解析失败直接返回 401成功就把用户 ID 塞进 request 属性后续 Controller 里用 RequestAttribute(userId) 取。注册拦截器时要把 /api/auth/** 和 /api/upload 放进白名单否则登录和上传还没带 token 就被拦住了。4.5 application.yml 里和数据库连接的五个配置后端跑不起来的问题大多出在数据库连接这一行spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/mutual_learning?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: 你的数据库密码 hikari: maximum-pool-size: 10 minimum-idle: 2 servlet: multipart: max-file-size: 5MB max-request-size: 20MB参数逐个说characterEncoding 决定中文不乱码serverTimezone 必须和服务器时区一致否则时间差八小时allowPublicKeyRetrieval 是 MySQL 8.0 用 caching_sha2_password 认证时必要的参数Hikari 的 maximum-pool-size 对毕设场景 10 个连接足够multipart 大小限制要和上传代码里的 5MB 保持一致。接口对应的完整清单可以整理成一张表写论文附接口设计时直接用前端页面后端接口说明pages/index/indexGET /api/help/list互助单列表pages/publish/publishPOST /api/help/create发布互助单pages/detail/detailPOST /api/help/accept接单/申请pages/my/myGET /api/user/info个人中心pages/my/myPOST /api/upload上传头像或截图5. 微信小程序端实现从自定义导航栏到互助单筛选5.1 自定义导航栏先算高度不要写死 64px默认导航栏样式有限制互助学习首页需要在一个页面里放 logo、分类标签和搜索入口通常要自定义导航栏。最常踩的坑是把高度写死成 64px换机型直接错位。正确做法是运行时拿胶囊按钮位置来计算const menuRect wx.getMenuButtonBoundingClientRect(); const sysInfo wx.getSystemInfoSync(); const statusBarHeight sysInfo.statusBarHeight; const navBarHeight (menuRect.top - statusBarHeight) * 2 menuRect.height;说明一下这两行胶囊按钮的 top 减去状态栏高度得到的是导航栏上下留白乘 2 是因为上下留白相同再加上胶囊自身高度就是自定义导航栏应有的总高。这个值在页面 onLoad 里算一次存到 data 里给 view 设置 styleheight: {{navBarHeight}}px。5.2 封装 wx.requesttoken 注入和错误提示只写一遍不封装的话每个页面都要重复写 header 和 fail 回调。我习惯在 utils/request.js 里做统一入口const BASE_URL http://localhost:8080; function request(url, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL url, method, data, header: { Content-Type: application/json, Authorization: wx.getStorageSync(token) || }, success(res) { if (res.data.code 0) { resolve(res.data.data); } else { wx.showToast({ title: res.data.msg, icon: none }); reject(res.data); } }, fail(err) { wx.showToast({ title: 网络异常, icon: none }); reject(err); } }); }); } module.exports { request };逻辑说明成功与否不按 HTTP 状态码判断而是按后端统一返回体里的 code 字段token 每次从 storage 现取避免登录超时后还拿旧 token403、401 这类情况可以在 success 里加一层跳转登录页的处理毕设阶段不做也不会影响主流程。5.3 互助单筛选用单选框科目切换不重新拉页列表页除了滚动加载还要按科目筛选。radio-group 比 picker 更直观改选后直接把选中值传给后端radio-group classfilter-bar bindchangeonSubjectChange label wx:for{{subjects}} wx:key*this radio value{{item}} checked{{currentSubject item}} / text{{item}}/text /label /radio-grouponSubjectChange(e) { this.setData({ currentSubject: e.detail.value, page: 1, list: [] }); this.loadList(); }参数说明radio 的 value 不能带对象只传字符串科目名比如“Java”“数据结构”切换科目时把 page 重置为 1 并且清空现有列表否则会看到上一科目的数据拼接在下面。选中状态由 radio-group 内部管理不需要手动处理单个 radio 的取消事件。5.4 发布页与个人中心的边界发布页要处理表单校验标题、科目、描述三个必填个人中心展示积分和接单记录这些数据来自第 4 章的接口。如果产品里设计了虚拟支付或充值积分要提前想到个人主体小程序开通不了微信支付 V3而且微信对虚拟支付有严格限制互助学习这种场景尽量走“发布、接单、评分、得积分”的闭环不碰真实资金答辩也少一个风险点。6. 部署、抓包与把毕设讲成项目的三个技巧6.1 云服务器最小部署命令后端打包后上传到服务器最小执行路径只有三行mvn clean package -DskipTests nohup java -jar target/study-0.0.1-SNAPSHOT.jar --server.port8080 app.log 21 第一行跳过测试打包第二行用 nohup 让进程在 ssh 断开后继续跑日志写到 app.log。如果 8080 被占改 --server.port数据库地址要同步改成服务器地址。防火墙和安全组只放行 80、443、8080 三个端口。提示小程序真机请求必须是 HTTPS临时测试可以手机开调试模式并勾选“不校验合法域名”。上线前再去小程序后台配置 request 合法域名。6.2 抓包看请求体联调出错先看 Network 面板前后端联调时最常见的问题不是代码逻辑而是参数对不上。打开微信开发者工具的调试器切到 Network 面板找到那条请求能看到实际发出的请求体、方法和状态码。常见的幕后黑手是后端接口要求 POST JSON前端却用了表单格式页码从 0 开始后端却按 1 解析SQL 能在数据库工具里查到数据接口查不到往往是查询条件拼错。如果要用独立抓包工具看 HTTPS 流量需要先安装并信任证书这一步和开发者工具 Network 面板能看到的信息基本重合毕设联调一般用不上那么多。6.3 修改刚进入的加载页面“修改刚进入的加载页面”是拿到毕设源码后必改的几处之一。入口页由 app.json 里的 entryPagePath 控制新建一个启动页后把它指过去同时把旧入口页从 pages 数组挪到后面。如果只是想在原入口页加一层加载状态就在该页面的 onLoad 里先 setData 一个 loadingtrue接口成功后再置 false。这里注意不要靠调整 pages 数组第一项来实现入口切换pages 数组第一项只决定初始加载页entryPagePath 才是显式配置入口的行为两者含义不同。6.4 把毕设讲成面试项目被追问时怎么接面试官看到“互助学习”通常会顺着问三个问题并发申请同一互助单怎么处理积分发放怎么保证不重复列表卡了怎么优化每个问题都有落点并发可以用接单表的唯一键兜底数据库层面拒绝重复申请积分发放放到事务里同时更新 t_learn_record 和 t_user加幂等标记列表卡了先看 explain 有没有用到 statuscreate_time 联合索引再考虑缓存热点科目数据。回答“我用接单表的唯一键兜住了并发积分走事务并加了幂等控制列表慢先调 SQL 再谈缓存”比背一圈八股更能说明你碰过真实问题。本文还有配套的精品资源点击获取