微信小程序农产品销售平台毕设：SSM+MySQL源码部署与二次开发指南

简介这是一套面向高校计算机相关专业毕业设计的微信小程序农产品销售平台完整项目源码采用微信开发者工具配合Java、SSM框架与MySQL数据库实现适合正在准备毕设或需要小程序全栈练手的同学参考。压缩包共1195个文件约14.86MB包含127个Java后端源码、166个JavaScript与133个Vue前端文件、80个WXML与82个WXSS小程序页面样式以及PNG、SVG、JPG等图片素材和SQL脚本、配置文件前后端与数据库结构一目了然。功能上用户端支持注册登录、首页浏览、农产品查看与个人中心管理后台覆盖每日特价、农产品及分类、品种、用户、管理员、系统与订单等管理模块业务闭环较为完整。目前已有332人学习下载可帮助读者快速理解小程序与SSM整合思路、数据库表设计及后台管理实现适合作为毕设选题参考或二次开发基础。1. 农产品销售平台毕设从源码包到能跑起来的完整路径如果你正在为计算机毕业设计选题发愁或者手头已经拿到一份基于微信小程序的农产品销售平台源码却卡在“怎么把它跑起来、怎么改成自己的、答辩时怎么讲清楚”这几个问题上那这篇笔记值得你花十分钟看完。这份资源是一套完整的微信小程序毕业设计项目技术栈是微信开发者工具 Java SSM MySQL功能覆盖用户注册登录、首页浏览、农产品展示、每日特价、订单管理以及后台的商品分类、品种、用户、管理员、系统配置等模块。它适合三类人一是选题定了农产品电商方向、需要一套能跑通全流程的毕设底座的同学二是想拿一个真实小程序项目练手、理解前后端分离怎么落地的开发者三是需要快速搭出演示环境、把精力留给论文和答辩的毕业生。源码包里除了前后端代码还带了开发说明和几个批处理脚本下面我按实际拆包和部署的顺序把关键步骤和容易翻车的地方讲清楚。2. 拆包先看结构SSM 后端与小程序前端怎么对上2.1 目录里那些 .bak 和 .bat 到底是什么拿到压缩包解压后第一眼会看到一堆.bak文件和三个编号批处理脚本。.bak是备份文件常见于 Eclipse 或 IDEA 自动生成的工程配置备份比如main.css.bak、update-password.vue.bak、IndexAsideStatic.vue.bak、BreadCrumbs.vue.bak、IndexHeader.vue.bak。这些文件本身不参与编译但能帮你还原被误删的样式或组件逻辑。真正要关注的是1-install.bat、2-run.bat、3-build.bat这三个脚本它们分别对应依赖安装、启动运行、打包构建。.classpath和org.eclipse.wst.common.component是 Eclipse 工程描述文件说明这套后端最初是在 Eclipse 里开发的如果你用 IDEA 打开需要重新配置 Facet 和 Artifact否则会报“找不到 Web 模块”之类的错误。我一般会先把整个目录按“前端 / 后端 / 数据库 / 文档”四类分开再决定从哪头开始。前端是微信小程序目录通常包含app.js、app.json、pages文件夹和utils工具库后端是标准的 SSM Maven 或 Web 项目结构有src/main/java、src/main/resources、webapp/WEB-INF数据库一般是一个.sql文件开发说明里会写库名和默认账号。先确认这三块都在再往下走能省掉很多“跑不起来但不知道缺什么”的时间。2.2 后端 SSM 分层与接口约定SSM 是 Spring SpringMVC MyBatis 的缩写这套组合在毕设里非常常见因为配置直观、资料多、答辩时也好讲。后端一般分四层Controller 层负责接收小程序发来的 HTTP 请求Service 层写业务逻辑Mapper 层或 DAO 层通过 MyBatis 操作数据库Entity 层对应表结构。农产品销售平台的核心接口通常包括用户登录注册、农产品列表分页查询、农产品详情、每日特价查询、订单创建与查询、后台管理端的增删改查。小程序端调用接口时一般会在utils/request.js或类似文件里封装一个基础请求方法把baseUrl指向后端服务地址。这里有个关键点微信开发者工具在本地调试时如果后端跑在localhost需要在工具里勾选“不校验合法域名”否则请求会被拦截。正式部署时才需要 HTTPS 域名和备案毕设演示阶段本地调试就够了。// utils/request.js 常见封装方式 const BASE_URL http://localhost:8080/agriculture; // 后端项目上下文路径 function request(url, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL url, method: method, data: data, header: { content-type: application/json }, success: (res) { if (res.data.code 200) { resolve(res.data.data); // 约定后端返回 { code, msg, 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要改成你本地后端实际启动的端口和上下文路径method默认 GET登录和提交订单时传 POSTdata是请求体GET 请求时会自动拼到 URL 上。注意header里的content-type要和后端RequestBody或RequestParam的接收方式匹配否则会出现参数收不到的情况。2.3 数据库导入与配置修改数据库这一步是很多同学翻车最多的地方。开发说明里一般会给出数据库名、表结构和初始账号但不会告诉你 MySQL 版本差异会导致 SQL 执行失败。常见做法是先用 Navicat 或命令行创建一个空库字符集选utf8mb4排序规则选utf8mb4_general_ci再导入.sql文件。如果导入时报“Unknown collation”或“Incorrect datetime value”多半是 SQL 文件里用了高版本 MySQL 的语法而你本地是 5.7 或更低版本。解决办法是把utf8mb4_0900_ai_ci改成utf8mb4_general_ci把datetime默认值里的CURRENT_TIMESTAMP检查一遍。后端配置文件通常是jdbc.properties或applicationContext.xml里的数据源部分需要改三处数据库连接地址、用户名、密码。连接地址里要带上useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai否则中文会乱码时间也会差 8 小时。# jdbc.properties 常见配置 jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/agriculture_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password你的密码参数说明com.mysql.cj.jdbc.Driver是 MySQL 8.x 的驱动类如果你用的是 5.x要改成com.mysql.jdbc.DriverserverTimezone必须加否则连接会报时区错误useSSLfalse在本地调试时加上避免证书警告。改完配置后先启动后端看到 Tomcat 或 Spring Boot 的启动日志没有报错再用浏览器访问一个测试接口确认返回 JSON 正常再动小程序端。3. 小程序端跑通页面跳转、登录态与订单流程3.1 首页、分类与每日特价的数据绑定小程序端的首页通常由轮播图、每日特价、农产品分类入口和推荐列表组成。数据绑定靠Page里的data和setData页面加载时在onLoad或onShow里调接口拿数据。每日特价模块一般对应后端一个“特价商品”查询接口返回带isSpecial标记或单独的特价表数据。农产品分类则是典型的树形或扁平列表点击分类后跳转到列表页带上categoryId参数。// pages/index/index.js 首页数据加载 Page({ data: { bannerList: [], specialList: [], categoryList: [] }, onLoad() { this.loadBanner(); this.loadSpecial(); this.loadCategory(); }, loadSpecial() { request(/api/product/special, GET).then(list { this.setData({ specialList: list }); }); }, loadCategory() { request(/api/category/list, GET).then(list { this.setData({ categoryList: list }); }); } });逻辑说明onLoad只在页面首次加载时触发适合拉取不常变的数据如果特价商品需要实时刷新可以放到onShow里。参数说明/api/product/special是后端约定的特价接口路径实际项目里可能叫/product/special或/goods/special以开发说明为准。setData是异步的不要在它后面立刻读this.data做判断容易拿到旧值。3.2 登录注册与 Token 保持用户登录流程一般是小程序端调wx.login拿code把code发给后端后端调微信接口换openid再查库判断是否已注册已注册就返回 Token未注册就引导到注册页。毕设项目里为了简化很多直接用手动输入用户名密码的方式不走微信授权。两种方式都能答辩但手动方式更容易演示不依赖真实微信账号。登录成功后Token 一般存在wx.setStorageSync(token, token)里后续请求在 header 里带上。这里有个常见坑Token 过期或后端重启后小程序端还在用旧 Token导致接口一直返回 401。解决办法是在request.js里统一拦截 401清掉本地缓存并跳回登录页。// 登录成功后保存 Token wx.setStorageSync(token, res.data.token); wx.setStorageSync(userInfo, res.data.userInfo); // request.js 里统一带 Token header: { content-type: application/json, token: wx.getStorageSync(token) || }参数说明wx.setStorageSync是同步存储适合存小体积的 Token 和用户信息如果存商品列表这种大数组要用异步的wx.setStorage否则会阻塞页面渲染。后端校验 Token 一般用拦截器或过滤器在preHandle里判断 header 里有没有 Token、是否过期。3.3 订单创建与后台管理联动订单流程是这套项目里最能体现“完整业务闭环”的部分。用户在小程序端选农产品、填收货信息、提交订单后端生成订单记录并扣减库存毕设里可能只是简单插入不一定做事务和并发控制。后台管理端则能看到订单列表、修改订单状态待付款、待发货、已发货、已完成。答辩时老师常问“库存怎么扣的”“订单状态怎么流转”你要能说清楚下单时先查库存库存足够才插入订单同时更新库存字段状态流转靠后台手动改或定时任务毕设阶段手动改就够了。-- 订单表常见字段 CREATE TABLE orders ( id int NOT NULL AUTO_INCREMENT, order_no varchar(64) NOT NULL, user_id int NOT NULL, product_id int NOT NULL, quantity int DEFAULT 1, total_price decimal(10,2) DEFAULT NULL, status tinyint DEFAULT 0 COMMENT 0待付款 1待发货 2已发货 3已完成, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY order_no (order_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;参数说明order_no用时间戳加随机数生成保证唯一status用 tinyint 比 varchar 更省空间也方便后端做条件查询create_time默认当前时间省去手动赋值。注意decimal(10,2)比float更适合金额避免精度丢失。后台管理端的订单列表接口一般支持按状态筛选和分页前端用limit和offset传参。4. 避坑与排查跑不起来时先看这几处4.1 后端启动报 404 或 500现象小程序端请求接口返回 404或者后端日志里报No mapping found for HTTP request。原因通常是上下文路径不对或者 Controller 的RequestMapping和小程序端写的路径不一致。解决先看后端启动日志里 Tomcat 的端口和上下文路径比如http://localhost:8080/agriculture再核对小程序端BASE_URL是否一致。500 错误则要看后端异常堆栈常见的是数据库字段和实体类属性对不上或者 MyBatis 的resultMap写错了。4.2 数据库连接失败或中文乱码现象后端启动时报Access denied for user或Unknown database或者页面显示的中文变成问号。原因数据库用户名密码不对、库没创建、连接串没加字符集参数。解决先用命令行mysql -u root -p确认能登录再show databases;确认库存在。连接串里必须带useUnicodetruecharacterEncodingutf8数据库和表的字符集统一用utf8mb4。如果还是乱码检查 MyBatis 配置文件里有没有property nameconnectionInitSqls valueset names utf8mb4/。4.3 小程序端请求被拦截现象开发者工具里请求发不出去控制台提示“不在以下 request 合法域名列表中”。原因微信开发者工具默认校验域名本地localhost不在白名单。解决在开发者工具右上角“详情” → “本地设置”里勾选“不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书”。这个设置只影响本地调试真机预览时如果后端没部署到 HTTPS 域名也会请求失败毕设演示用工具模拟器就够了。4.4 页面白屏或数据不显示现象小程序页面能打开但列表是空的或者一直转圈。原因接口返回的数据结构和前端setData的字段名对不上或者request封装里判断code 200但后端返回的是code: 0。解决在request的成功回调里先console.log(res.data)看实际返回结构再调整前端取值路径。如果是分页接口注意后端返回的是{ list: [], total: 0 }还是直接返回数组前端setData的写法不一样。4.5 批处理脚本执行报错现象双击1-install.bat后窗口一闪而过或者提示“不是内部或外部命令”。原因脚本里写的mvn或npm命令不在系统环境变量里或者脚本用了相对路径但当前目录不对。解决不要双击运行先在项目根目录打开命令行手动执行1-install.bat看具体报错。如果是 Maven 没装先配好MAVEN_HOME和PATH如果是 Node 没装去官网下 LTS 版本。脚本里的路径如果写死了作者本机的目录要改成你自己的实际路径。5. 二次开发与答辩加分把毕设改成“你的”项目5.1 改界面从换配色到加新页面拿到源码后最忌讳直接照搬答辩老师一眼就能看出是模板。我一般会先改三处一是小程序端的主色调和首页布局把农产品分类入口从四宫格改成横向滚动或者加一个“产地直供”标签二是后台管理端的登录页和侧边栏换成自己学校的 Logo 和项目名三是加一个原项目没有的小功能比如“农产品搜索历史”或“每日特价倒计时”。这些改动不需要动后端核心逻辑但能让答辩时有的讲。// 加一个搜索历史缓存展示在搜索页 const HISTORY_KEY search_history; function addHistory(keyword) { let list wx.getStorageSync(HISTORY_KEY) || []; list list.filter(item item ! keyword); // 去重 list.unshift(keyword); if (list.length 10) list.pop(); // 最多存 10 条 wx.setStorageSync(HISTORY_KEY, list); }逻辑说明用本地缓存存搜索历史去重后把最新关键词放最前面超过 10 条就删掉最旧的。参数说明HISTORY_KEY是缓存键名不要和 Token 的键名冲突unshift和pop分别操作数组头部和尾部。这个功能后端不用改答辩时可以说“提升了用户检索效率”是个很稳的加分点。5.2 改业务加一个“农产品品种”筛选原项目里已经有农产品分类管理但分类和品种是两个维度。你可以在小程序端列表页加一个品种筛选栏后端在查询接口里多接一个varietyId参数MyBatis 的 SQL 里加一个if testvarietyId ! null and variety_id #{varietyId} /if。这样既不动表结构又能体现你对 MyBatis 动态 SQL 的理解。!-- ProductMapper.xml 动态条件 -- select idselectByCondition resultMapBaseResultMap select * from product where if testcategoryId ! null and category_id #{categoryId} /if if testvarietyId ! null and variety_id #{varietyId} /if if testkeyword ! null and keyword ! and name like concat(%, #{keyword}, %) /if /where order by create_time desc /select参数说明where标签会自动处理第一个and不用手写where 11concat(%, #{keyword}, %)是 MySQL 的模糊查询写法比like %${keyword}%安全能防止 SQL 注入。改完 SQL 后Controller 层的方法参数要加上varietyIdService 层透传小程序端请求时带上这个参数。5.3 答辩演示的检查清单答辩前我会强制走一遍这个流程先启动 MySQL确认库和表都在再启动后端看日志没有异常然后打开微信开发者工具清缓存重新编译用测试账号登录走一遍“首页 → 分类 → 详情 → 加购 → 下单 → 后台改状态”的完整链路最后检查后台管理端的每个菜单能不能正常打开。这套流程走完基本不会在答辩现场翻车。从那以后我每次交付项目前都强制走一遍这个检查清单希望帮到你。本文还有配套的精品资源点击获取