简介微信阅读小程序毕设源码资料包基于微信开发者工具开发用户前端以 SSM 框架和 Java 实现管理后台、MySQL 存储数据管理员可管理书城、图书订单、章节、留言与资讯用户支持购买支付图书、查看章节、发布留言、管理收藏适合软件工程、计算机等相关专业学生用于毕设、课设或二次开发。包内含 1082 个文件压缩包约 15.7MBjava、vue、js 为业务代码wxml、wxss、svg、png 为小程序页面与素材sql 提供建库数据docx、doc、pptx 等文档含论文、开题报告与答辩 PPT。已有 151 人学习下载。代码均测试运行通过包内附 README 与 1-install.bat、2-run.bat、3-build.bat 脚本便于导入环境并启动调试可整体作为毕设或课程设计参考也能在其上继续扩展功能。1. “微信阅读小程序SSM”毕业设计包到底是一份能用的档案还是一次性模板这类资源包的正面意义是“全”源码、文档说明、论文、SQL 文件、开题报告、答辩 PPT 全都有理论上能按图索骥把微信阅读小程序从数据库一路跑到微信开发者工具。但反面上大多数人拿到后的第一反应是把它当成一次性模板——SQL 文件双击导入、源码改个包名、PPT 换一页封面就等着答辩。这个方法放到 SSM 框架下基本行不通因为 SQL 文件、后端 jdbc 配置、小程序端请求地址这三者只要有一环对不上整条链路就断给你看。微信阅读小程序业务本身不复杂微信授权登录、书城列表、分类筛选、书籍详情、加入书架、阅读记录SSM 后端提供接口与数据MySQL 存书籍、用户、收藏关系小程序做展示与交互。接下来我把这套流程拆开讲从如何用 SQL 文件初始化数据库到小程序联调再到答辩前怎么验证代码链路。2. 如何用 SQL 文件初始化微信阅读小程序项目先建库再配 SSM 后端2.1 拿到代码包先做三件事理目录、看 SQL 表结构、找配置文件很多人拿到源码第一件事是启动 Tomcat结果控制台报 500、数据库连不上然后开始怀疑代码包是坏的。正确顺序应该是先确认 SQL 文件要建哪些库、每张表大概存什么再看 SSM 后端连的库名和账号最后才启动服务。我一般先把sql/目录下的.sql文件用文本编辑器打开搜索CREATE DATABASE和CREATE TABLE确认库名、表名、字符集。这类微信阅读小程序的 SSM 工程通常有这五块内容结构大致如下wx-reader/ ├── sql/ │ └── wx_reader.sql ├── server/ # SSM 后端Maven 工程 │ ├── pom.xml │ └── src/main/ │ ├── java/com/xxx/ │ │ ├── controller/ # SpringMVC 控制层 │ │ ├── service/ # 业务层 │ │ ├── mapper/ # MyBatis DAO 层 │ │ └── entity/ # 实体类 │ └── resources/ │ ├── jdbc.properties # 数据库连接参数 │ ├── spring-mvc.xml │ ├── mybatis-config.xml │ └── mapper/*.xml # SQL 映射文件 ├── miniprogram/ # 微信开发者工具打开的前端 └── docs/ # 论文、开题报告、答辩 PPT这个目录里最关键的文件只有两个sql/wx_reader.sql和resources/jdbc.properties。前者决定数据库里有哪些表和初始数据后者决定 SSM 后端用哪个账号、哪个密码去连接数据库。小程序前端那部分可以晚一点再看先把后端这条线跑通。2.2 用 SQL 文件建库命令行导入比图形化导入更可控微信阅读小程序涉及的典型表有用户表、分类表、书籍表、书架表、评论表和阅读记录表。SQL 文件里一般会带着CREATE DATABASE、CREATE TABLE和一批INSERT INTO在图形化工具里双击导入时经常报“Unknown command”或者编码错乱所以我更推荐命令行方式mysql -uroot -p # 登录 MySQL 后执行以下 SQL 语句 CREATE DATABASE IF NOT EXISTS wx_reader DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE wx_reader; SOURCE D:/codes/wx-reader/sql/wx_reader.sql;这里有个容易理解错的点SOURCE命令后面的路径是客户端本机路径不是 MySQL 服务器上的路径。如果你用的是远程数据库路径要换成服务器能访问到的位置。字符集统一用utf8mb4否则小程序端输入中文书名、用户昵称含 emoji 时会直接写入失败或者变成问号。导入完成后用一条简单查询验证表是否真的建出来了SHOW TABLES; SELECT COUNT(*) FROM book; SELECT * FROM user LIMIT 5;执行结果如果显示表名列表和书籍数量说明 SQL 文件初始化成功。这一步是整条链路里最容易跳过的一步但也是最值得花十分钟确认的一步因为后面所有报错都可能是“库没建对”引起的连锁反应。为了把两种导入方式说透我做了一个对比。实际使用时按你的操作系统和工具习惯选一种就行方式命令行 mysqlNavicat/Workbench 导入向导适用场景服务器部署、快速反复重建库需要看表结构、手工补数据编码控制导入前手动指定 utf8mb4可控依赖文件头注释容易出错报错定位按行号直接看第几条 SQL 出错有时只提示“导入失败”信息模糊权限问题使用 root 直接在终端操作反馈直接连接配置不对时容易被工具缓存误导2.3 改 jdbc.properties参数名、密码、时区三项最容易引发“许可”类报错SSM 后端的数据库连接参数集中在jdbc.properties或者applicationContext.xml里。常见写法如下jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/wx_reader?useUnicodetruecharacterEncodingutf8mb4useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456这几个参数里最容易被忽略的是serverTimezone。如果你的 MySQL 是 5.7而本地 JDK 8 连的是 8.0 驱动不带serverTimezone会直接报 “The server time zone value” 的异常。另一个高频坑是password本地 MySQL 安装时设的密码和你从代码包里看到的往往不一样这是一个必须改成你自己的密码的位置。有一点想特别说明很多人把数据库连接失败统称为“SQL 访问许可验证文件出错”但这类报错绝大多数不是文件损坏而是账号密码不匹配或者权限没授权。排查顺序应该是先确认jdbc.username和jdbc.password是当前数据库真实账号再用命令行mysql -u账号 -p密码手动登录测试。命令行能登录代码里就一定也能连上剩下的只是 URL 或驱动版本问题。改完配置执行mvn clean package打包成 WAR 包丢到 Tomcat 的webapps目录下启动。如果你的代码包不是 Maven 工程而是 Eclipse/IDEA 里的一个目录也可以直接在 Tomcat 里 add deployment效果一样。2.4 启动后先别开小程序用 curl 验证后端接口是否活着微信阅读小程序的前端页面要跑起来依赖后端接口。所以在打开微信开发者工具之前我建议先用一个最简单的方式验证后端请求一个只读接口比如书籍列表。假设 Tomcat 端口是 8080项目名是wx-reader后端的 Controller 映射是/book/list那么完整路径就是http://localhost:8080/wx-reader/book/list。curl -X GET http://localhost:8080/wx-reader/book/list?pageNum1pageSize10 \ -H Content-Type: application/json返回结果如果是一段 JSON 数组说明后端、数据库、SQL 文件三者已经连通。这一步也暴露了第一个容易踩的坑URL 里的项目名wx-reader必须和 WAR 包名一致如果 IDEA 里 artifact 叫wx_reader_war路径就变成/wx_reader/前端请求时少写一段就 404。3. 小程序端调通 SSM 接口登录、书城列表、个人书架的最小联调3.1 先把接口契约梳理出来路径、方法、入参、出参SSM 后端是 SpringMVC 写的Controller 里每个RequestMapping都对应一个小程序页面动作。这类微信阅读小程序最常见的接口差不多就是这么几张表功能请求路径方法关键入参返回内容微信登录/user/wxloginPOSTcodetoken、用户信息书城列表/book/listGETpageNum、pageSize、categoryId书籍列表、总数书籍详情/book/detail/{id}GET路径参数 id书籍详情、章节列表加入书架/shelf/addPOSTbookId、token操作结果书架列表/shelf/listGETtoken收藏书籍列表阅读记录/record/listGETtoken历史阅读列表注意这里有个很容易被忽略的点小程序端写url: /book/list是不够的请求最终会拼成http://localhost:8080/wx-reader/book/list。如果前后端联调时看到 404不要先怀疑代码先看控制台里实际请求的完整 URL 是什么。3.2 封装 wx.request登录态与 token 的处理方式微信小程序里没有 axios官方提供的是wx.request。它的底层是 XMLHttpRequest天然有跨域限制不过在微信开发者工具里可以通过“不校验合法域名”暂时绕开。拿到代码包后我建议所有请求都封装到一个公共函数里避免每个页面各写一套。下面是登录接口的最小实现// utils/request.js const BASE_URL http://localhost:8080/wx-reader; function request(path, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL path, method: method, data: data, // 从本地缓存取 token后端拦截器校验登录态 header: { Content-Type: application/json, token: wx.getStorageSync(token) || }, success: (res) { if (res.statusCode 200) { resolve(res.data); } else { reject(res); } }, fail: (err) reject(err) }); }); } // 登录页调用 wx.login({ success: (res) { request(/user/wxlogin, POST, { code: res.code }).then((data) { // 后端校验 code 后返回自定义 token wx.setStorageSync(token, data.token); wx.setStorageSync(userInfo, data.userInfo); }); } });这段代码里有几个对 SSM 项目特别重要的细节。第一header里的token字段名要和后端拦截器一致如果后端从request.getHeader(Authorization)里取值前端写token就永远拦截表现就是“请求能到后端但总是未登录”。第二wx.login拿到的code是一次性的5 分钟内有效不能缓存。第三这类毕业设计项目的简化实现里后端经常不真的调用微信接口换openid而是直接用code生成一个随机 token这在答辩演示里没问题但开题报告里最好写清楚你做了哪些扩展。3.3 开发者工具的本地联调设置域名校验、局域网 IP 与真机预览微信开发者工具默认要求小程序请求的 URL 必须配置到后台的合法域名列表里否则报 “url not in domain list”。本地开发阶段不用真的去微信公众平台配置直接在开发者工具右上角“详情 → 本地设置”里勾选“不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书”就能请求http://localhost:8080。但如果要拿手机真机预览localhost就不行了因为手机访问的是你的电脑。这时候要改BASE_URL为电脑的局域网 IP比如http://192.168.1.101:8080/wx-reader同时确认 Tomcat 监听地址不是127.0.0.1防火墙放行了 8080 端口。这里有个经验改完 IP 后先在电脑浏览器访问一次相同的 URL浏览器能打开再拿手机试否则问题大概率不在小程序端而在网络层。另外许多代码包为了省事把BASE_URL写死成了别人的服务器地址比如https://example.com/api。这种情况下你看到的页面可能是有数据的但一旦断网或者别人的服务停了整站就废了。我拿到任何代码包都会先全局搜索http://和https://把每处远程地址都找出来逐个替换成自己的本地地址。4. 避坑排查SQL 访问许可报错、接口 404 与数据渲染异常4.1 SQL 文件导入或 JDBC 连接时报“访问被拒绝”类错误现象执行SOURCE导入时提示Access denied for user rootlocalhost或者后端启动后报Access denied for user有人习惯把它理解为“SQL 访问许可验证文件出错”。原因绝大多数情况下jdbc.properties里的数据库密码和安装 MySQL 时设置的管理员密码不一致或者当前用户对wx_reader库没有权限。文件本身没坏。解决用命令行手动登录一次验证账号密码。如果密码确实不对重置密码后再改jdbc.properties。如果不想让后端用 root可以单独建一个账号并授权CREATE USER wx_userlocalhost IDENTIFIED BY wx_pass_2024; GRANT ALL PRIVILEGES ON wx_reader.* TO wx_userlocalhost; FLUSH PRIVILEGES;4.2 后端正常启动小程序请求一直 404 或 405现象Tomcat 控制台打出Starting ProtocolHandler没有异常但前端每个请求都 404或者接口路径对却提示 405 Method Not Allowed。原因404 一般是项目名不一致比如 WAR 包叫wx-reader.war前端请求却少了/wx-reader这段。405 一般是请求方式不匹配后端只写了GetMapping前端用了POST。解决在浏览器里直接输完整路径测试。浏览器能访问说明后端没问题接下来检查前端BASE_URL是否漏了项目名浏览器报 405 就把wx.request的method改成和后端一致。4.3 接口返回 JSON但小程序页面里的字段全是空白现象wx.request请求成功console.log能看到数据但页面列表渲染为空。原因最常见是 MyBatis 开启了驼峰映射但实体类属性是bookName数据库列名是book_name中间没对上或者后端返回的字段用的是Map而不是实体类序列化后字段名大小写不一致。解决在mybatis-config.xml里确认开启驼峰转换settings setting namemapUnderscoreToCamelCase valuetrue/ /settings如果上面这个配置已经存在就用AS别名把 SQL 查询结果的列名改成实体类字段名。经验法则字段对不上的问题永远先打印后端实际返回的 JSON再逐字段比对前端使用的字段名不要用肉眼去猜。4.4 时间字段出现 8 小时时差或格式不是 “2025-03-11 14:30:00”现象阅读记录的时间、评论时间比本地时间慢了 8 小时或者返回的是2025-03-11T14:30:00.00008:00这种带 T 的格式。原因MySQL 连接 URL 里没带serverTimezoneAsia/Shanghai默认用的是服务器 UTC 时区同时 SpringMVC 的 Jackson 没有配置日期格式。解决在jdbc.properties的 URL 末尾加上serverTimezoneAsia/Shanghai并在 Spring 配置文件里给 Jackson 指定格式bean idjacksonObjectMapper classcom.fasterxml.jackson.databind.ObjectMapper property namedateFormat valueyyyy-MM-dd HH:mm:ss/ /bean4.5 代码包版本太老和当前环境不匹配现象用 Tomcat 10 跑 Spring 老项目启动直接报Servlet相关类找不到用 MySQL 8 的驱动连 MySQL 5.7提示认证插件不兼容用 JDK 17 编译 JDK 8 写的代码一堆注解报错。原因SSM 毕业设计代码包多数基于 JDK 8、Spring 4/5、Tomcat 8.5/9、MySQL 5.7 编写和 2025 年的新环境有版本代差。解决不要在这个项目里硬上新版本环境。最省事的方式是装一套对应版本矩阵JDK 8、Tomcat 8.5、MySQL 5.7。如果必须用 MySQL 8就把驱动升级到 8.0.x同时在 URL 中增加allowPublicKeyRetrievaltrueuseSSLfalse如果用 Tomcat 10建议把 Spring 升级到 5.3 并替换javax.servlet为jakarta.servlet但这一步改动很大不推荐临答辩前做。5. 答辩前的验证技巧用一条接口链路证明“这套代码是我的”答辩现场最尴尬的事不是被问倒而是演示到一半接口挂了、页面白屏、登录不上去。我习惯在答辩前一天做一次“冒烟验证”把整条链路的每一步用最快速度过一遍启动 MySQL用命令行查询确认数据在启动 Tomcat用 curl 请求书籍列表接口并保存返回的 JSON打开微信开发者工具走一遍“微信登录 → 书城列表 → 书籍详情 → 加入书架 → 书架列表”的完整流程。这里有一个成本低但效果很好的技巧不要只演示页面而是当场展示“页面数据来自数据库”。比如在书城页面翻到某本书然后切到数据库里SELECT * FROM book WHERE id 5;让老师看到这条记录确实存在而且修改数据库里的书名后小程序刷新就变了。这比任何口头解释都更有说服力。更进一步如果时间允许做一个最小改造把 SQL 文件里的书籍数据替换成有辨识度的内容比如换入一套本地图书馆的书目或者在book表里加一个recommend字段控制首页推荐位。这类小改动代码量不大但能让答辩老师明显感觉到你不是原封不动下载的模板。我的习惯是凡是答辩要用的功能提前一天用 curl 脚本把主要接口全部请求一遍输出保存成文本现场即使网络波动也能有据可查。按这个方法来哪怕某一步崩了也不会影响整体印象。这套验证思路陪我过了不少类似项目希望帮到你。本文还有配套的精品资源点击获取
微信阅读小程序+SSM毕业设计：SQL初始化、接口联调与避坑指南
简介微信阅读小程序毕设源码资料包基于微信开发者工具开发用户前端以 SSM 框架和 Java 实现管理后台、MySQL 存储数据管理员可管理书城、图书订单、章节、留言与资讯用户支持购买支付图书、查看章节、发布留言、管理收藏适合软件工程、计算机等相关专业学生用于毕设、课设或二次开发。包内含 1082 个文件压缩包约 15.7MBjava、vue、js 为业务代码wxml、wxss、svg、png 为小程序页面与素材sql 提供建库数据docx、doc、pptx 等文档含论文、开题报告与答辩 PPT。已有 151 人学习下载。代码均测试运行通过包内附 README 与 1-install.bat、2-run.bat、3-build.bat 脚本便于导入环境并启动调试可整体作为毕设或课程设计参考也能在其上继续扩展功能。1. “微信阅读小程序SSM”毕业设计包到底是一份能用的档案还是一次性模板这类资源包的正面意义是“全”源码、文档说明、论文、SQL 文件、开题报告、答辩 PPT 全都有理论上能按图索骥把微信阅读小程序从数据库一路跑到微信开发者工具。但反面上大多数人拿到后的第一反应是把它当成一次性模板——SQL 文件双击导入、源码改个包名、PPT 换一页封面就等着答辩。这个方法放到 SSM 框架下基本行不通因为 SQL 文件、后端 jdbc 配置、小程序端请求地址这三者只要有一环对不上整条链路就断给你看。微信阅读小程序业务本身不复杂微信授权登录、书城列表、分类筛选、书籍详情、加入书架、阅读记录SSM 后端提供接口与数据MySQL 存书籍、用户、收藏关系小程序做展示与交互。接下来我把这套流程拆开讲从如何用 SQL 文件初始化数据库到小程序联调再到答辩前怎么验证代码链路。2. 如何用 SQL 文件初始化微信阅读小程序项目先建库再配 SSM 后端2.1 拿到代码包先做三件事理目录、看 SQL 表结构、找配置文件很多人拿到源码第一件事是启动 Tomcat结果控制台报 500、数据库连不上然后开始怀疑代码包是坏的。正确顺序应该是先确认 SQL 文件要建哪些库、每张表大概存什么再看 SSM 后端连的库名和账号最后才启动服务。我一般先把sql/目录下的.sql文件用文本编辑器打开搜索CREATE DATABASE和CREATE TABLE确认库名、表名、字符集。这类微信阅读小程序的 SSM 工程通常有这五块内容结构大致如下wx-reader/ ├── sql/ │ └── wx_reader.sql ├── server/ # SSM 后端Maven 工程 │ ├── pom.xml │ └── src/main/ │ ├── java/com/xxx/ │ │ ├── controller/ # SpringMVC 控制层 │ │ ├── service/ # 业务层 │ │ ├── mapper/ # MyBatis DAO 层 │ │ └── entity/ # 实体类 │ └── resources/ │ ├── jdbc.properties # 数据库连接参数 │ ├── spring-mvc.xml │ ├── mybatis-config.xml │ └── mapper/*.xml # SQL 映射文件 ├── miniprogram/ # 微信开发者工具打开的前端 └── docs/ # 论文、开题报告、答辩 PPT这个目录里最关键的文件只有两个sql/wx_reader.sql和resources/jdbc.properties。前者决定数据库里有哪些表和初始数据后者决定 SSM 后端用哪个账号、哪个密码去连接数据库。小程序前端那部分可以晚一点再看先把后端这条线跑通。2.2 用 SQL 文件建库命令行导入比图形化导入更可控微信阅读小程序涉及的典型表有用户表、分类表、书籍表、书架表、评论表和阅读记录表。SQL 文件里一般会带着CREATE DATABASE、CREATE TABLE和一批INSERT INTO在图形化工具里双击导入时经常报“Unknown command”或者编码错乱所以我更推荐命令行方式mysql -uroot -p # 登录 MySQL 后执行以下 SQL 语句 CREATE DATABASE IF NOT EXISTS wx_reader DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE wx_reader; SOURCE D:/codes/wx-reader/sql/wx_reader.sql;这里有个容易理解错的点SOURCE命令后面的路径是客户端本机路径不是 MySQL 服务器上的路径。如果你用的是远程数据库路径要换成服务器能访问到的位置。字符集统一用utf8mb4否则小程序端输入中文书名、用户昵称含 emoji 时会直接写入失败或者变成问号。导入完成后用一条简单查询验证表是否真的建出来了SHOW TABLES; SELECT COUNT(*) FROM book; SELECT * FROM user LIMIT 5;执行结果如果显示表名列表和书籍数量说明 SQL 文件初始化成功。这一步是整条链路里最容易跳过的一步但也是最值得花十分钟确认的一步因为后面所有报错都可能是“库没建对”引起的连锁反应。为了把两种导入方式说透我做了一个对比。实际使用时按你的操作系统和工具习惯选一种就行方式命令行 mysqlNavicat/Workbench 导入向导适用场景服务器部署、快速反复重建库需要看表结构、手工补数据编码控制导入前手动指定 utf8mb4可控依赖文件头注释容易出错报错定位按行号直接看第几条 SQL 出错有时只提示“导入失败”信息模糊权限问题使用 root 直接在终端操作反馈直接连接配置不对时容易被工具缓存误导2.3 改 jdbc.properties参数名、密码、时区三项最容易引发“许可”类报错SSM 后端的数据库连接参数集中在jdbc.properties或者applicationContext.xml里。常见写法如下jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/wx_reader?useUnicodetruecharacterEncodingutf8mb4useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456这几个参数里最容易被忽略的是serverTimezone。如果你的 MySQL 是 5.7而本地 JDK 8 连的是 8.0 驱动不带serverTimezone会直接报 “The server time zone value” 的异常。另一个高频坑是password本地 MySQL 安装时设的密码和你从代码包里看到的往往不一样这是一个必须改成你自己的密码的位置。有一点想特别说明很多人把数据库连接失败统称为“SQL 访问许可验证文件出错”但这类报错绝大多数不是文件损坏而是账号密码不匹配或者权限没授权。排查顺序应该是先确认jdbc.username和jdbc.password是当前数据库真实账号再用命令行mysql -u账号 -p密码手动登录测试。命令行能登录代码里就一定也能连上剩下的只是 URL 或驱动版本问题。改完配置执行mvn clean package打包成 WAR 包丢到 Tomcat 的webapps目录下启动。如果你的代码包不是 Maven 工程而是 Eclipse/IDEA 里的一个目录也可以直接在 Tomcat 里 add deployment效果一样。2.4 启动后先别开小程序用 curl 验证后端接口是否活着微信阅读小程序的前端页面要跑起来依赖后端接口。所以在打开微信开发者工具之前我建议先用一个最简单的方式验证后端请求一个只读接口比如书籍列表。假设 Tomcat 端口是 8080项目名是wx-reader后端的 Controller 映射是/book/list那么完整路径就是http://localhost:8080/wx-reader/book/list。curl -X GET http://localhost:8080/wx-reader/book/list?pageNum1pageSize10 \ -H Content-Type: application/json返回结果如果是一段 JSON 数组说明后端、数据库、SQL 文件三者已经连通。这一步也暴露了第一个容易踩的坑URL 里的项目名wx-reader必须和 WAR 包名一致如果 IDEA 里 artifact 叫wx_reader_war路径就变成/wx_reader/前端请求时少写一段就 404。3. 小程序端调通 SSM 接口登录、书城列表、个人书架的最小联调3.1 先把接口契约梳理出来路径、方法、入参、出参SSM 后端是 SpringMVC 写的Controller 里每个RequestMapping都对应一个小程序页面动作。这类微信阅读小程序最常见的接口差不多就是这么几张表功能请求路径方法关键入参返回内容微信登录/user/wxloginPOSTcodetoken、用户信息书城列表/book/listGETpageNum、pageSize、categoryId书籍列表、总数书籍详情/book/detail/{id}GET路径参数 id书籍详情、章节列表加入书架/shelf/addPOSTbookId、token操作结果书架列表/shelf/listGETtoken收藏书籍列表阅读记录/record/listGETtoken历史阅读列表注意这里有个很容易被忽略的点小程序端写url: /book/list是不够的请求最终会拼成http://localhost:8080/wx-reader/book/list。如果前后端联调时看到 404不要先怀疑代码先看控制台里实际请求的完整 URL 是什么。3.2 封装 wx.request登录态与 token 的处理方式微信小程序里没有 axios官方提供的是wx.request。它的底层是 XMLHttpRequest天然有跨域限制不过在微信开发者工具里可以通过“不校验合法域名”暂时绕开。拿到代码包后我建议所有请求都封装到一个公共函数里避免每个页面各写一套。下面是登录接口的最小实现// utils/request.js const BASE_URL http://localhost:8080/wx-reader; function request(path, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL path, method: method, data: data, // 从本地缓存取 token后端拦截器校验登录态 header: { Content-Type: application/json, token: wx.getStorageSync(token) || }, success: (res) { if (res.statusCode 200) { resolve(res.data); } else { reject(res); } }, fail: (err) reject(err) }); }); } // 登录页调用 wx.login({ success: (res) { request(/user/wxlogin, POST, { code: res.code }).then((data) { // 后端校验 code 后返回自定义 token wx.setStorageSync(token, data.token); wx.setStorageSync(userInfo, data.userInfo); }); } });这段代码里有几个对 SSM 项目特别重要的细节。第一header里的token字段名要和后端拦截器一致如果后端从request.getHeader(Authorization)里取值前端写token就永远拦截表现就是“请求能到后端但总是未登录”。第二wx.login拿到的code是一次性的5 分钟内有效不能缓存。第三这类毕业设计项目的简化实现里后端经常不真的调用微信接口换openid而是直接用code生成一个随机 token这在答辩演示里没问题但开题报告里最好写清楚你做了哪些扩展。3.3 开发者工具的本地联调设置域名校验、局域网 IP 与真机预览微信开发者工具默认要求小程序请求的 URL 必须配置到后台的合法域名列表里否则报 “url not in domain list”。本地开发阶段不用真的去微信公众平台配置直接在开发者工具右上角“详情 → 本地设置”里勾选“不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书”就能请求http://localhost:8080。但如果要拿手机真机预览localhost就不行了因为手机访问的是你的电脑。这时候要改BASE_URL为电脑的局域网 IP比如http://192.168.1.101:8080/wx-reader同时确认 Tomcat 监听地址不是127.0.0.1防火墙放行了 8080 端口。这里有个经验改完 IP 后先在电脑浏览器访问一次相同的 URL浏览器能打开再拿手机试否则问题大概率不在小程序端而在网络层。另外许多代码包为了省事把BASE_URL写死成了别人的服务器地址比如https://example.com/api。这种情况下你看到的页面可能是有数据的但一旦断网或者别人的服务停了整站就废了。我拿到任何代码包都会先全局搜索http://和https://把每处远程地址都找出来逐个替换成自己的本地地址。4. 避坑排查SQL 访问许可报错、接口 404 与数据渲染异常4.1 SQL 文件导入或 JDBC 连接时报“访问被拒绝”类错误现象执行SOURCE导入时提示Access denied for user rootlocalhost或者后端启动后报Access denied for user有人习惯把它理解为“SQL 访问许可验证文件出错”。原因绝大多数情况下jdbc.properties里的数据库密码和安装 MySQL 时设置的管理员密码不一致或者当前用户对wx_reader库没有权限。文件本身没坏。解决用命令行手动登录一次验证账号密码。如果密码确实不对重置密码后再改jdbc.properties。如果不想让后端用 root可以单独建一个账号并授权CREATE USER wx_userlocalhost IDENTIFIED BY wx_pass_2024; GRANT ALL PRIVILEGES ON wx_reader.* TO wx_userlocalhost; FLUSH PRIVILEGES;4.2 后端正常启动小程序请求一直 404 或 405现象Tomcat 控制台打出Starting ProtocolHandler没有异常但前端每个请求都 404或者接口路径对却提示 405 Method Not Allowed。原因404 一般是项目名不一致比如 WAR 包叫wx-reader.war前端请求却少了/wx-reader这段。405 一般是请求方式不匹配后端只写了GetMapping前端用了POST。解决在浏览器里直接输完整路径测试。浏览器能访问说明后端没问题接下来检查前端BASE_URL是否漏了项目名浏览器报 405 就把wx.request的method改成和后端一致。4.3 接口返回 JSON但小程序页面里的字段全是空白现象wx.request请求成功console.log能看到数据但页面列表渲染为空。原因最常见是 MyBatis 开启了驼峰映射但实体类属性是bookName数据库列名是book_name中间没对上或者后端返回的字段用的是Map而不是实体类序列化后字段名大小写不一致。解决在mybatis-config.xml里确认开启驼峰转换settings setting namemapUnderscoreToCamelCase valuetrue/ /settings如果上面这个配置已经存在就用AS别名把 SQL 查询结果的列名改成实体类字段名。经验法则字段对不上的问题永远先打印后端实际返回的 JSON再逐字段比对前端使用的字段名不要用肉眼去猜。4.4 时间字段出现 8 小时时差或格式不是 “2025-03-11 14:30:00”现象阅读记录的时间、评论时间比本地时间慢了 8 小时或者返回的是2025-03-11T14:30:00.00008:00这种带 T 的格式。原因MySQL 连接 URL 里没带serverTimezoneAsia/Shanghai默认用的是服务器 UTC 时区同时 SpringMVC 的 Jackson 没有配置日期格式。解决在jdbc.properties的 URL 末尾加上serverTimezoneAsia/Shanghai并在 Spring 配置文件里给 Jackson 指定格式bean idjacksonObjectMapper classcom.fasterxml.jackson.databind.ObjectMapper property namedateFormat valueyyyy-MM-dd HH:mm:ss/ /bean4.5 代码包版本太老和当前环境不匹配现象用 Tomcat 10 跑 Spring 老项目启动直接报Servlet相关类找不到用 MySQL 8 的驱动连 MySQL 5.7提示认证插件不兼容用 JDK 17 编译 JDK 8 写的代码一堆注解报错。原因SSM 毕业设计代码包多数基于 JDK 8、Spring 4/5、Tomcat 8.5/9、MySQL 5.7 编写和 2025 年的新环境有版本代差。解决不要在这个项目里硬上新版本环境。最省事的方式是装一套对应版本矩阵JDK 8、Tomcat 8.5、MySQL 5.7。如果必须用 MySQL 8就把驱动升级到 8.0.x同时在 URL 中增加allowPublicKeyRetrievaltrueuseSSLfalse如果用 Tomcat 10建议把 Spring 升级到 5.3 并替换javax.servlet为jakarta.servlet但这一步改动很大不推荐临答辩前做。5. 答辩前的验证技巧用一条接口链路证明“这套代码是我的”答辩现场最尴尬的事不是被问倒而是演示到一半接口挂了、页面白屏、登录不上去。我习惯在答辩前一天做一次“冒烟验证”把整条链路的每一步用最快速度过一遍启动 MySQL用命令行查询确认数据在启动 Tomcat用 curl 请求书籍列表接口并保存返回的 JSON打开微信开发者工具走一遍“微信登录 → 书城列表 → 书籍详情 → 加入书架 → 书架列表”的完整流程。这里有一个成本低但效果很好的技巧不要只演示页面而是当场展示“页面数据来自数据库”。比如在书城页面翻到某本书然后切到数据库里SELECT * FROM book WHERE id 5;让老师看到这条记录确实存在而且修改数据库里的书名后小程序刷新就变了。这比任何口头解释都更有说服力。更进一步如果时间允许做一个最小改造把 SQL 文件里的书籍数据替换成有辨识度的内容比如换入一套本地图书馆的书目或者在book表里加一个recommend字段控制首页推荐位。这类小改动代码量不大但能让答辩老师明显感觉到你不是原封不动下载的模板。我的习惯是凡是答辩要用的功能提前一天用 curl 脚本把主要接口全部请求一遍输出保存成文本现场即使网络波动也能有据可查。按这个方法来哪怕某一步崩了也不会影响整体印象。这套验证思路陪我过了不少类似项目希望帮到你。本文还有配套的精品资源点击获取
