简介这是一套围绕Springboot、SpringMVC、Mybatis与微信小程序构建的图书捐赠管理系统毕业设计完整资料包面向计算机相关专业学生与初级开发者可用于课程设计、毕业设计或系统学习主流Java服务端框架集成。压缩包共856个文件约42.96MB其中Java源码、class与jar包承载后端业务逻辑xml、properties与json构成配置体系wxml、wxss与js实现小程序前端交互sql脚本用于初始化图书、捐赠者及捐赠记录等数据表。包内除完整项目源码外还包含数据库建表脚本与毕业设计论文相关文档完整展示了Springboot自动配置、SpringMVC分层请求处理、Mybatis持久化映射以及小程序轻量前端等关键实现并涉及社区交流与可视化组件设计。目前已有143人浏览学习适合需要快速搭建同类项目、撰写设计说明或进行二次开发的读者。1. 图书捐赠管理系统毕业设计最缺的不是代码是能跑通的全链路每年到毕设季后台咨询最多的就是这类问题SpringBoot 项目拿到了Maven 依赖也导进去了启动却报一堆红色异常小程序一打开就白屏数据库表对不上。图书捐赠管理系统这种题目胜在业务清楚、前后端分离明确、答辩有东西可讲但也正因为它同时牵到 SpringBoot、SpringMVC、MyBatis 和微信小程序四条线任何一个环节断掉整个项目就瘫在那里。这份资源的价值不在于代码有多花哨而在于它把「用户注册登录、发布图书、发起捐赠、订单流转」这条主链路完整跑通了。适合正在做毕设的本科生或者想快速复现一个前后端分离项目的开发者——你能从里面抄到一套可用的工程结构而不是零散的 Demo。2. SpringBoot SpringMVC MyBatis 后台选型理由与请求链路拆解2.1 为什么这套组合在毕设里几乎成了默认答案很多同学纠结要不要换更新的技术栈比如 SpringCloud 或者 MyBatis-Plus。我的建议是毕设PPT 上写「基于 SpringBoot 的图书捐赠管理系统」就够了SpringBoot、SpringMVC、MyBatis 这套组合有一个别的新潮框架替代不了的优势——它是面试官和答辩老师都看得懂的经典三层架构。SpringBoot 负责自动化配置把原来 Spring 那一堆 XML 配置收敛成 application.yml 里的几十行SpringMVC 负责 HTTP 请求的分发Controller 层接收前端参数通过 Service 层处理业务最后落到 MyBatis 与数据库交互。这三者的边界非常清楚论文里画系统架构图也顺手表现层、业务层、持久层一层一层对应得明明白白。实际做的时候我一般会把工程按这样的包结构拆com.example.donation ├── controller # 接收请求参数校验返回 Result ├── service # 业务逻辑事务控制 ├── mapper # MyBatis 持久层接口 ├── entity # 数据库实体类 ├── dto # 前端交互的入参/出参对象 ├── config # 拦截器、跨域、文件上传等配置 └── common # 统一返回结果、异常处理、工具类这个结构几乎是毕设项目的标准答案。Controller 里不写业务只做参数接收和封装返回Service 里处理捐赠状态流转这种核心逻辑Mapper 只负责 SQL。有人觉得多写一层麻烦但答辩老师问「你的业务逻辑怎么复用的」时没有 Service 层很难自圆其说。2.2 请求全链路从小程序点击到数据库落库以「用户发起捐赠」这个动作举例。小程序端调用POST /api/donation/create携带图书 ID、受赠人 ID、备注。请求进入 SpringMVC 的 DispatcherServlet由 HandlerMapping 找到对应的 Controller 方法RestController RequestMapping(/api/donation) public class DonationController { Autowired private DonationService donationService; PostMapping(/create) public Result create(RequestBody DonationRequest request) { // 参数校验图书是否下架、捐赠人是否本人 if (request.getBookId() null || request.getReceiverId() null) { return Result.error(图书和受赠人不能为空); } return Result.success(donationService.createDonation(request)); } }注意这段代码里RestController注解表示这个类所有方法返回值都会被自动序列化为 JSON而PostMapping(/create)把请求路径和方法绑定。RequestBody告诉 SpringMVC 把请求体里的 JSON 字符串反序列化成DonationRequest对象。Service 层要加事务捐赠操作涉及两张表订单表插入记录、图书表更新状态。一旦第二步失败第一步的订单记录就成了脏数据所以必须用Transactional保证原子性Transactional(rollbackFor Exception.class) public Integer createDonation(DonationRequest request) { DonationOrder order new DonationOrder(); order.setBookId(request.getBookId()); order.setReceiverId(request.getReceiverId()); order.setStatus(0); // 0-待确认 1-已完成 2-已取消 order.setCreateTime(new Date()); donationMapper.insert(order); // 将图书标记为已捐赠避免被其他人重复申请 bookMapper.updateStatusById(request.getBookId(), 1); return order.getId(); }rollbackFor Exception.class指定任何异常都回滚别漏了这一步Spring 默认只回滚 RuntimeException。这里有一个毕设里常见的翻车点订单插入成功了图书状态没更新前端显示「该书已被捐献」但后台根本没那条订单记录。2.3 配置文件数据源、驼峰映射与日志打印资源里的 application.yml 基本可以直接用但有几个参数要按你自己的环境改spring: datasource: url: jdbc:mysql://localhost:3306/book_donation?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 10MB max-request-size: 20MB mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.donation.entity configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl server: port: 8080map-underscore-to-camel-case: true这个配置必须开否则数据库字段create_time映射不到实体的createTime属性查询回来全是 null。log-impl配成 StdOutImpl 后控制台会直接打印每条 SQL 和参数排查问题省一半时间。serverTimezoneAsia/Shanghai是 MySQL 8 的时区坑不配的话连连接都会报错。3. 微信小程序端页面结构、接口联调与登录态设计3.1 小程序端的技术选型原生框架还是 uniapp这套毕设里小程序端用原生微信小程序写不引额外框架。原因很现实原生框架在微信开发者工具里调试最直接报错信息最明确论文里也能写「基于微信小程序原生框架开发」。uniapp 虽然能一套代码多端复用但打包部署链路多一环对毕设来说是多余的复杂度。小程序端目录结构大致是这样miniprogram ├── pages │ ├── index # 首页图书列表、搜索、筛选 │ ├── detail # 图书详情捐赠按钮 │ ├── publish # 发布图书表单 图片上传 │ ├── order # 我的捐赠记录 │ └── mine # 个人中心登录、地址管理 ├── utils │ ├── request.js # wx.request 封装 │ └── auth.js # 登录态管理 └── app.js首页的图书列表走的是分页加载这个在毕设里经常被做成一次性拉全量数据——数据少的时候看不出问题答辩演示时数据一多小程序端明显卡顿老师一问「数据量上万怎么办」就答不上来。规范做法是触底加载下一页onReachBottom() { if (this.data.page * this.data.pageSize this.data.total) { return; // 没有更多数据直接返回 } this.setData({ page: this.data.page 1 }) this.loadBooks() }onReachBottom是微信小程序页面自带的生命周期方法页面滚动到底部时自动触发。page和pageSize控制翻页每次加载后判断当前已加载数量与总数的关系避免重复请求末尾页。3.2 request 封装与 BaseURL 统一管理小程序里所有接口请求都要走wx.request但不做封装的话每个页面都要写完整的 URL、header、success/fail 回调代码冗余不说后端接口路径一旦更换全项目都要改。我一般会单独建一个request.jsconst BASE_URL http://localhost:8080/api 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 200) { 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, BASE_URL }这里用 Promise 包装页面里就能用 async/await 语法避免回调地狱。header 里统一带上 Authorization 字段写死 token 是毕设常见错误——登录态必须从wx.getStorageSync取否则换用户登录后请求头还是旧 token。BASE_URL 单独抽出来真机调试时把localhost改成电脑的局域网 IP 即可。接口联调阶段有一个经验先在开发者工具里把「不校验合法域名」打开调试完再关掉这个选项在「详情-本地设置」里。不是所有毕设项目都有钱部署 HTTPS 域名本地联调阶段放宽校验是业内常规做法但真机预览下不了手。3.3 登录态wx.login 换 openid 与 token 签发图书捐赠系统涉及用户身份小程序端不能用传统的账号密码登录因为微信生态里用户不感知密码。标准做法是wx.login获取临时 code传给后端后端拿 code 调微信接口换 openid再用 openid 生成自定义 token 返回前端。wx.login({ success: async (res) { const data await request({ url: /auth/login, method: POST, data: { code: res.code } }) wx.setStorageSync(token, data.token) wx.setStorageSync(userInfo, data.userInfo) } })后端对应接口的核心逻辑是把 code 发到微信的jscode2session接口微信返回 openid 和 session_key。实际项目里 openid 是用户的唯一标识至少要把 openid 对应的用户记录建好没注册过的自动注册。这个环节答辩老师最爱问的问题「小程序端拿到的 token 有效期多久过期了怎么办」所以实现时不要拍脑袋设一个固定值我一般会在 token 里存入过期时间戳前端请求收到 401 时自动重新执行 wx.login 刷新 token这条链路在论文里写清楚妥妥的加分点。4. 数据库设计图书、用户、捐赠订单三张核心表与关键 SQL4.1 表结构设计订单表为什么要冗余图书快照毕设里数据库如果只建两张表图书表、用户表捐赠记录不存在独立的表里那这个系统的业务闭环就立不住。图书捐赠的核心是「状态流转」一本书从可捐赠变成已捐赠这个过程需要一条记录来承载。所以订单表必须建。CREATE TABLE donation_order ( id int(11) NOT NULL AUTO_INCREMENT, book_id int(11) NOT NULL COMMENT 图书ID, donor_id int(11) NOT NULL COMMENT 捐赠人ID, receiver_id int(11) NOT NULL COMMENT 受赠人ID, book_title varchar(128) DEFAULT NULL COMMENT 冗余图书标题快照, book_cover varchar(255) DEFAULT NULL COMMENT 冗余封面图快照, status tinyint(4) DEFAULT 0 COMMENT 0-待确认 1-已完成 2-已取消, remark varchar(512) DEFAULT NULL COMMENT 备注留言, create_time datetime DEFAULT NULL, update_time datetime DEFAULT NULL, PRIMARY KEY (id), KEY idx_book_id (book_id), KEY idx_donor_id (donor_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;注意book_title和book_cover这两个字段它们是对图书表信息的冗余快照。为什么订单表不直接关联查询图书表因为图书表里的标题和封面可能被管理员修改或下架订单作为历史记录应该保留捐赠发生那一刻的信息。这个设计在答辩时讲出来老师会觉得你有工程经验而不是只会SELECT *。用户表设计只需要覆盖小程序端需要的字段openid、昵称、头像、手机号、注册时间。图书表则要包含标题、作者、ISBN、封面 URL、分类、捐赠人 ID、状态0-在库 1-已捐出、创建时间。4.2 关键 SQL分页查询、捐赠统计与防止重复捐赠图书列表页的分页查询是 MyBatis 里最常见的动态 SQL 场景要在 XML Mapper 里处理select idselectPage resultTypecom.example.donation.entity.Book SELECT * FROM book where if testtitle ! null and title ! AND title LIKE CONCAT(%, #{title}, %) /if if testcategoryId ! null AND category_id #{categoryId} /if if teststatus ! null AND status #{status} /if /where ORDER BY create_time DESC LIMIT #{offset}, #{pageSize} /selectwhere标签会自动去掉多余的 AND这是 MyBatis 最常用的技巧。#{offset}和#{pageSize}对应前端传来的页码参数offset在 Service 层计算为(page - 1) * pageSize。查图书详情时要把捐赠人信息带出来常见做法是关联查询SELECT b.*, u.nickname AS donor_name, u.avatar AS donor_avatar FROM book b LEFT JOIN user u ON b.donor_id u.id WHERE b.id #{bookId}用 LEFT JOIN 而不是 INNER JOIN因为图书可能被管理员手动创建或者原始数据导入没有对应捐赠人信息时 LEFT JOIN 至少能把图书本身查出来。防止重复捐赠的 SQL 层面处理是在捐赠状态流转时加上带条件的更新语句UPDATE book SET status 1 WHERE id #{bookId} AND status 0先查再改在并发场景下会失效两个人同时点捐赠都读到 status0都去更新最后可能形成两条捐赠订单对应同一本书。上面这条 SQL 利用条件更新UPDATE影响行数为 0 时说明书已经被别人抢先捐走了Service 层据此返回「该书已被捐赠」。5. 避坑图书捐赠系统从开发到答辩的常见问题排查5.1 现象SpringBoot 启动失败报Access denied for user rootlocalhost原因这是数据库账号密码或者权限问题。资源包里的 application.yml 用的是本机默认配置如果你的 MySQL 设置的 root 密码不是 123456或者创建了独立账号直接跑就会报这个错。解决先确认你的 MySQL 账号密码mysql -u root -p能登录就没问题。再改 application.yml 里的 username 和 password。如果还不行检查 MySQL 8 的认证插件执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码;SpringBoot 默认驱动对 caching_sha2_password 的兼容性在一些旧版本上会翻车。5.2 现象接口返回的数据里createTime字段全是 null其他字段正常原因数据库字段create_time和实体属性createTime对不上。MyBatis 默认不会自动做驼峰映射如果你没在 application.yml 里配置map-underscore-to-camel-case: true所有下划线字段名都映射不了。解决在 MyBatis 配置块里加这一行配置。如果你嫌全局配置不明确可以在 XML 里给每个字段写 resultMap但那样几十个字段都要手写映射维护成本太高。我一般直接用全局配置只在特殊字段上用Column注解兜底。5.3 现象小程序真机预览时首页数据加载不出来开发者工具里却是好的原因开发者工具默认不校验合法域名所以http://localhost:8080能正常请求真机上微信要求所有请求必须是 HTTPS 并且域名已在小程序后台配置为白名单。解决本地调试阶段用真机时打开微信开发者工具的「详情-本地设置-不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」勾上以后真机预览才能访问局域网 IP 下的后端接口。正式上线则必须走 HTTPS备案域名。注意真机访问电脑服务时localhost要改成电脑的局域网 IP比如http://192.168.1.100:8080。5.4 现象图片上传后小程序端拿到的是本地临时路径真机上图片打不开原因wx.chooseMedia返回的 tempFilePath 是本地临时文件只在当次会话内有效。后端把图片保存到服务器后返回的应该是服务器上可访问的完整 URL而不是直接把临时路径存进数据库。解决前端上传时用wx.uploadFile把文件传给后端后端保存到本地磁盘或云存储返回可访问的 URLwx.uploadFile({ url: BASE_URL /upload/image, filePath: tempFilePath, name: file, success(res) { const data JSON.parse(res.data) this.setData({ coverUrl: data.data.url }) } })后端对应要做静态资源映射SpringBoot 里配置spring.web.resources.static-locations指向你存放上传文件的目录否则浏览器直接访问图片 URL 会 404。5.5 现象XML Mapper 里写了符号启动直接报 SQL 语法错误原因XML 文件里是特殊字符MyBatis 解析 XML 时把它当成标签开头SQL 里常见的create_time #{endTime}就会炸。解决转义为lt;或者使用![CDATA[ SQL 片段 ]]包起来。我一般习惯是写lt;简洁且不容易出错如果 SQL 里有多处小于号用 CDATA 包住整段更省事。6. 进阶验证从能跑到能答辩的收尾几步项目跑通只是第一步答辩时老师看的是「你对自己项目的掌握程度」。按下面这个顺序过一遍能挡住大部分追问。先列接口清单用 Postman 逐个跑一遍确认每个接口的入参、出参、状态码你都清楚——老师随手点开一个接口问「这个参数是干什么的」答不上来很减分。接着生成数据至少往库里塞 20 本书、10 个用户、15 条订单记录演示时列表翻页、详情展示、状态流转都有素材。然后画三张图系统架构图、业务流程图、数据库 ER 图直接放论文里答辩 PPT 也复用。数据验证之后再做功能加固。我建议加一个「捐赠审核」的开关用户发起捐赠后状态先为「待确认」管理员在小程序管理端确认后才变为「已完成」。这个需求改动不大只需要在订单表加一个确认接口但业务复杂度立刻上一个档次论文里可以多写一节「管理员审核模块的设计与实现」。UPDATE donation_order SET status 1, update_time NOW() WHERE id #{orderId} AND status 0条件更新同样防止重复确认。审核通过后再从用户维度统计捐赠数量和受赠数量生成简单的榜单接口小程序端用wx:for渲染即可。我自己的习惯是每次答辩前都强制走一遍全流程新用户注册、发布图书、发起捐赠、管理员确认、双方查询记录。五步走完哪个环节慢或报错心里就有数。做完这套验证你对这份资源的掌握程度就不只是「跑通了」而是「每一行都说得清」。希望帮到你。本文还有配套的精品资源点击获取
SpringBoot+微信小程序图书捐赠管理系统：全链路实现与避坑指南
简介这是一套围绕Springboot、SpringMVC、Mybatis与微信小程序构建的图书捐赠管理系统毕业设计完整资料包面向计算机相关专业学生与初级开发者可用于课程设计、毕业设计或系统学习主流Java服务端框架集成。压缩包共856个文件约42.96MB其中Java源码、class与jar包承载后端业务逻辑xml、properties与json构成配置体系wxml、wxss与js实现小程序前端交互sql脚本用于初始化图书、捐赠者及捐赠记录等数据表。包内除完整项目源码外还包含数据库建表脚本与毕业设计论文相关文档完整展示了Springboot自动配置、SpringMVC分层请求处理、Mybatis持久化映射以及小程序轻量前端等关键实现并涉及社区交流与可视化组件设计。目前已有143人浏览学习适合需要快速搭建同类项目、撰写设计说明或进行二次开发的读者。1. 图书捐赠管理系统毕业设计最缺的不是代码是能跑通的全链路每年到毕设季后台咨询最多的就是这类问题SpringBoot 项目拿到了Maven 依赖也导进去了启动却报一堆红色异常小程序一打开就白屏数据库表对不上。图书捐赠管理系统这种题目胜在业务清楚、前后端分离明确、答辩有东西可讲但也正因为它同时牵到 SpringBoot、SpringMVC、MyBatis 和微信小程序四条线任何一个环节断掉整个项目就瘫在那里。这份资源的价值不在于代码有多花哨而在于它把「用户注册登录、发布图书、发起捐赠、订单流转」这条主链路完整跑通了。适合正在做毕设的本科生或者想快速复现一个前后端分离项目的开发者——你能从里面抄到一套可用的工程结构而不是零散的 Demo。2. SpringBoot SpringMVC MyBatis 后台选型理由与请求链路拆解2.1 为什么这套组合在毕设里几乎成了默认答案很多同学纠结要不要换更新的技术栈比如 SpringCloud 或者 MyBatis-Plus。我的建议是毕设PPT 上写「基于 SpringBoot 的图书捐赠管理系统」就够了SpringBoot、SpringMVC、MyBatis 这套组合有一个别的新潮框架替代不了的优势——它是面试官和答辩老师都看得懂的经典三层架构。SpringBoot 负责自动化配置把原来 Spring 那一堆 XML 配置收敛成 application.yml 里的几十行SpringMVC 负责 HTTP 请求的分发Controller 层接收前端参数通过 Service 层处理业务最后落到 MyBatis 与数据库交互。这三者的边界非常清楚论文里画系统架构图也顺手表现层、业务层、持久层一层一层对应得明明白白。实际做的时候我一般会把工程按这样的包结构拆com.example.donation ├── controller # 接收请求参数校验返回 Result ├── service # 业务逻辑事务控制 ├── mapper # MyBatis 持久层接口 ├── entity # 数据库实体类 ├── dto # 前端交互的入参/出参对象 ├── config # 拦截器、跨域、文件上传等配置 └── common # 统一返回结果、异常处理、工具类这个结构几乎是毕设项目的标准答案。Controller 里不写业务只做参数接收和封装返回Service 里处理捐赠状态流转这种核心逻辑Mapper 只负责 SQL。有人觉得多写一层麻烦但答辩老师问「你的业务逻辑怎么复用的」时没有 Service 层很难自圆其说。2.2 请求全链路从小程序点击到数据库落库以「用户发起捐赠」这个动作举例。小程序端调用POST /api/donation/create携带图书 ID、受赠人 ID、备注。请求进入 SpringMVC 的 DispatcherServlet由 HandlerMapping 找到对应的 Controller 方法RestController RequestMapping(/api/donation) public class DonationController { Autowired private DonationService donationService; PostMapping(/create) public Result create(RequestBody DonationRequest request) { // 参数校验图书是否下架、捐赠人是否本人 if (request.getBookId() null || request.getReceiverId() null) { return Result.error(图书和受赠人不能为空); } return Result.success(donationService.createDonation(request)); } }注意这段代码里RestController注解表示这个类所有方法返回值都会被自动序列化为 JSON而PostMapping(/create)把请求路径和方法绑定。RequestBody告诉 SpringMVC 把请求体里的 JSON 字符串反序列化成DonationRequest对象。Service 层要加事务捐赠操作涉及两张表订单表插入记录、图书表更新状态。一旦第二步失败第一步的订单记录就成了脏数据所以必须用Transactional保证原子性Transactional(rollbackFor Exception.class) public Integer createDonation(DonationRequest request) { DonationOrder order new DonationOrder(); order.setBookId(request.getBookId()); order.setReceiverId(request.getReceiverId()); order.setStatus(0); // 0-待确认 1-已完成 2-已取消 order.setCreateTime(new Date()); donationMapper.insert(order); // 将图书标记为已捐赠避免被其他人重复申请 bookMapper.updateStatusById(request.getBookId(), 1); return order.getId(); }rollbackFor Exception.class指定任何异常都回滚别漏了这一步Spring 默认只回滚 RuntimeException。这里有一个毕设里常见的翻车点订单插入成功了图书状态没更新前端显示「该书已被捐献」但后台根本没那条订单记录。2.3 配置文件数据源、驼峰映射与日志打印资源里的 application.yml 基本可以直接用但有几个参数要按你自己的环境改spring: datasource: url: jdbc:mysql://localhost:3306/book_donation?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 10MB max-request-size: 20MB mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.donation.entity configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl server: port: 8080map-underscore-to-camel-case: true这个配置必须开否则数据库字段create_time映射不到实体的createTime属性查询回来全是 null。log-impl配成 StdOutImpl 后控制台会直接打印每条 SQL 和参数排查问题省一半时间。serverTimezoneAsia/Shanghai是 MySQL 8 的时区坑不配的话连连接都会报错。3. 微信小程序端页面结构、接口联调与登录态设计3.1 小程序端的技术选型原生框架还是 uniapp这套毕设里小程序端用原生微信小程序写不引额外框架。原因很现实原生框架在微信开发者工具里调试最直接报错信息最明确论文里也能写「基于微信小程序原生框架开发」。uniapp 虽然能一套代码多端复用但打包部署链路多一环对毕设来说是多余的复杂度。小程序端目录结构大致是这样miniprogram ├── pages │ ├── index # 首页图书列表、搜索、筛选 │ ├── detail # 图书详情捐赠按钮 │ ├── publish # 发布图书表单 图片上传 │ ├── order # 我的捐赠记录 │ └── mine # 个人中心登录、地址管理 ├── utils │ ├── request.js # wx.request 封装 │ └── auth.js # 登录态管理 └── app.js首页的图书列表走的是分页加载这个在毕设里经常被做成一次性拉全量数据——数据少的时候看不出问题答辩演示时数据一多小程序端明显卡顿老师一问「数据量上万怎么办」就答不上来。规范做法是触底加载下一页onReachBottom() { if (this.data.page * this.data.pageSize this.data.total) { return; // 没有更多数据直接返回 } this.setData({ page: this.data.page 1 }) this.loadBooks() }onReachBottom是微信小程序页面自带的生命周期方法页面滚动到底部时自动触发。page和pageSize控制翻页每次加载后判断当前已加载数量与总数的关系避免重复请求末尾页。3.2 request 封装与 BaseURL 统一管理小程序里所有接口请求都要走wx.request但不做封装的话每个页面都要写完整的 URL、header、success/fail 回调代码冗余不说后端接口路径一旦更换全项目都要改。我一般会单独建一个request.jsconst BASE_URL http://localhost:8080/api 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 200) { 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, BASE_URL }这里用 Promise 包装页面里就能用 async/await 语法避免回调地狱。header 里统一带上 Authorization 字段写死 token 是毕设常见错误——登录态必须从wx.getStorageSync取否则换用户登录后请求头还是旧 token。BASE_URL 单独抽出来真机调试时把localhost改成电脑的局域网 IP 即可。接口联调阶段有一个经验先在开发者工具里把「不校验合法域名」打开调试完再关掉这个选项在「详情-本地设置」里。不是所有毕设项目都有钱部署 HTTPS 域名本地联调阶段放宽校验是业内常规做法但真机预览下不了手。3.3 登录态wx.login 换 openid 与 token 签发图书捐赠系统涉及用户身份小程序端不能用传统的账号密码登录因为微信生态里用户不感知密码。标准做法是wx.login获取临时 code传给后端后端拿 code 调微信接口换 openid再用 openid 生成自定义 token 返回前端。wx.login({ success: async (res) { const data await request({ url: /auth/login, method: POST, data: { code: res.code } }) wx.setStorageSync(token, data.token) wx.setStorageSync(userInfo, data.userInfo) } })后端对应接口的核心逻辑是把 code 发到微信的jscode2session接口微信返回 openid 和 session_key。实际项目里 openid 是用户的唯一标识至少要把 openid 对应的用户记录建好没注册过的自动注册。这个环节答辩老师最爱问的问题「小程序端拿到的 token 有效期多久过期了怎么办」所以实现时不要拍脑袋设一个固定值我一般会在 token 里存入过期时间戳前端请求收到 401 时自动重新执行 wx.login 刷新 token这条链路在论文里写清楚妥妥的加分点。4. 数据库设计图书、用户、捐赠订单三张核心表与关键 SQL4.1 表结构设计订单表为什么要冗余图书快照毕设里数据库如果只建两张表图书表、用户表捐赠记录不存在独立的表里那这个系统的业务闭环就立不住。图书捐赠的核心是「状态流转」一本书从可捐赠变成已捐赠这个过程需要一条记录来承载。所以订单表必须建。CREATE TABLE donation_order ( id int(11) NOT NULL AUTO_INCREMENT, book_id int(11) NOT NULL COMMENT 图书ID, donor_id int(11) NOT NULL COMMENT 捐赠人ID, receiver_id int(11) NOT NULL COMMENT 受赠人ID, book_title varchar(128) DEFAULT NULL COMMENT 冗余图书标题快照, book_cover varchar(255) DEFAULT NULL COMMENT 冗余封面图快照, status tinyint(4) DEFAULT 0 COMMENT 0-待确认 1-已完成 2-已取消, remark varchar(512) DEFAULT NULL COMMENT 备注留言, create_time datetime DEFAULT NULL, update_time datetime DEFAULT NULL, PRIMARY KEY (id), KEY idx_book_id (book_id), KEY idx_donor_id (donor_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;注意book_title和book_cover这两个字段它们是对图书表信息的冗余快照。为什么订单表不直接关联查询图书表因为图书表里的标题和封面可能被管理员修改或下架订单作为历史记录应该保留捐赠发生那一刻的信息。这个设计在答辩时讲出来老师会觉得你有工程经验而不是只会SELECT *。用户表设计只需要覆盖小程序端需要的字段openid、昵称、头像、手机号、注册时间。图书表则要包含标题、作者、ISBN、封面 URL、分类、捐赠人 ID、状态0-在库 1-已捐出、创建时间。4.2 关键 SQL分页查询、捐赠统计与防止重复捐赠图书列表页的分页查询是 MyBatis 里最常见的动态 SQL 场景要在 XML Mapper 里处理select idselectPage resultTypecom.example.donation.entity.Book SELECT * FROM book where if testtitle ! null and title ! AND title LIKE CONCAT(%, #{title}, %) /if if testcategoryId ! null AND category_id #{categoryId} /if if teststatus ! null AND status #{status} /if /where ORDER BY create_time DESC LIMIT #{offset}, #{pageSize} /selectwhere标签会自动去掉多余的 AND这是 MyBatis 最常用的技巧。#{offset}和#{pageSize}对应前端传来的页码参数offset在 Service 层计算为(page - 1) * pageSize。查图书详情时要把捐赠人信息带出来常见做法是关联查询SELECT b.*, u.nickname AS donor_name, u.avatar AS donor_avatar FROM book b LEFT JOIN user u ON b.donor_id u.id WHERE b.id #{bookId}用 LEFT JOIN 而不是 INNER JOIN因为图书可能被管理员手动创建或者原始数据导入没有对应捐赠人信息时 LEFT JOIN 至少能把图书本身查出来。防止重复捐赠的 SQL 层面处理是在捐赠状态流转时加上带条件的更新语句UPDATE book SET status 1 WHERE id #{bookId} AND status 0先查再改在并发场景下会失效两个人同时点捐赠都读到 status0都去更新最后可能形成两条捐赠订单对应同一本书。上面这条 SQL 利用条件更新UPDATE影响行数为 0 时说明书已经被别人抢先捐走了Service 层据此返回「该书已被捐赠」。5. 避坑图书捐赠系统从开发到答辩的常见问题排查5.1 现象SpringBoot 启动失败报Access denied for user rootlocalhost原因这是数据库账号密码或者权限问题。资源包里的 application.yml 用的是本机默认配置如果你的 MySQL 设置的 root 密码不是 123456或者创建了独立账号直接跑就会报这个错。解决先确认你的 MySQL 账号密码mysql -u root -p能登录就没问题。再改 application.yml 里的 username 和 password。如果还不行检查 MySQL 8 的认证插件执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码;SpringBoot 默认驱动对 caching_sha2_password 的兼容性在一些旧版本上会翻车。5.2 现象接口返回的数据里createTime字段全是 null其他字段正常原因数据库字段create_time和实体属性createTime对不上。MyBatis 默认不会自动做驼峰映射如果你没在 application.yml 里配置map-underscore-to-camel-case: true所有下划线字段名都映射不了。解决在 MyBatis 配置块里加这一行配置。如果你嫌全局配置不明确可以在 XML 里给每个字段写 resultMap但那样几十个字段都要手写映射维护成本太高。我一般直接用全局配置只在特殊字段上用Column注解兜底。5.3 现象小程序真机预览时首页数据加载不出来开发者工具里却是好的原因开发者工具默认不校验合法域名所以http://localhost:8080能正常请求真机上微信要求所有请求必须是 HTTPS 并且域名已在小程序后台配置为白名单。解决本地调试阶段用真机时打开微信开发者工具的「详情-本地设置-不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」勾上以后真机预览才能访问局域网 IP 下的后端接口。正式上线则必须走 HTTPS备案域名。注意真机访问电脑服务时localhost要改成电脑的局域网 IP比如http://192.168.1.100:8080。5.4 现象图片上传后小程序端拿到的是本地临时路径真机上图片打不开原因wx.chooseMedia返回的 tempFilePath 是本地临时文件只在当次会话内有效。后端把图片保存到服务器后返回的应该是服务器上可访问的完整 URL而不是直接把临时路径存进数据库。解决前端上传时用wx.uploadFile把文件传给后端后端保存到本地磁盘或云存储返回可访问的 URLwx.uploadFile({ url: BASE_URL /upload/image, filePath: tempFilePath, name: file, success(res) { const data JSON.parse(res.data) this.setData({ coverUrl: data.data.url }) } })后端对应要做静态资源映射SpringBoot 里配置spring.web.resources.static-locations指向你存放上传文件的目录否则浏览器直接访问图片 URL 会 404。5.5 现象XML Mapper 里写了符号启动直接报 SQL 语法错误原因XML 文件里是特殊字符MyBatis 解析 XML 时把它当成标签开头SQL 里常见的create_time #{endTime}就会炸。解决转义为lt;或者使用![CDATA[ SQL 片段 ]]包起来。我一般习惯是写lt;简洁且不容易出错如果 SQL 里有多处小于号用 CDATA 包住整段更省事。6. 进阶验证从能跑到能答辩的收尾几步项目跑通只是第一步答辩时老师看的是「你对自己项目的掌握程度」。按下面这个顺序过一遍能挡住大部分追问。先列接口清单用 Postman 逐个跑一遍确认每个接口的入参、出参、状态码你都清楚——老师随手点开一个接口问「这个参数是干什么的」答不上来很减分。接着生成数据至少往库里塞 20 本书、10 个用户、15 条订单记录演示时列表翻页、详情展示、状态流转都有素材。然后画三张图系统架构图、业务流程图、数据库 ER 图直接放论文里答辩 PPT 也复用。数据验证之后再做功能加固。我建议加一个「捐赠审核」的开关用户发起捐赠后状态先为「待确认」管理员在小程序管理端确认后才变为「已完成」。这个需求改动不大只需要在订单表加一个确认接口但业务复杂度立刻上一个档次论文里可以多写一节「管理员审核模块的设计与实现」。UPDATE donation_order SET status 1, update_time NOW() WHERE id #{orderId} AND status 0条件更新同样防止重复确认。审核通过后再从用户维度统计捐赠数量和受赠数量生成简单的榜单接口小程序端用wx:for渲染即可。我自己的习惯是每次答辩前都强制走一遍全流程新用户注册、发布图书、发起捐赠、管理员确认、双方查询记录。五步走完哪个环节慢或报错心里就有数。做完这套验证你对这份资源的掌握程度就不只是「跑通了」而是「每一行都说得清」。希望帮到你。本文还有配套的精品资源点击获取
