简介：这是一套面向高校计算机相关专业毕业设计的农产品销售平台完整项目源码，采用微信开发者工具配合Java、SSM框架与MySQL数据库实现，适合正在准备毕设或需要小程序+后台管理系统实战案例的学生参考。项目分为用户端与管理员端：用户可完成注册登录、浏览首页与农产品信息、查看个人中心；管理员登录后台后可对个人中心、每日特价、农产品及其分类与品种、用户、管理员、系统及订单等模块进行管理，功能覆盖较完整。资源包共1195个文件，约14.86MB，包含231个png与31个jpg图片素材、166个js与133个vue前端脚本、127个java后端代码、82个wxss与80个wxml小程序页面文件，以及sql建库脚本、json配置和bat启动脚本等，结构清晰便于按模块查阅。目前已有332人学习，可作为毕设选题落地的参考方案，帮助理解小程序端与SSM后台的接口对接、数据库表设计及订单流程实现。
1. 农产品销售平台毕设：从选题到能跑起来的那条最短路径
每年三四月，后台总有人问我同一个问题：基于微信小程序的农产品销售平台，到底能不能作为毕业设计做出来，做出来之后答辩能不能过。先说结论——能，而且它属于计算机毕设里少有的「业务闭环清晰、技术栈不玄学、演示效果直观」的选题。农产品销售平台的核心链路很短：农户或合作社上架产品，买家在小程序里浏览、加购、下单，后台处理订单和发货。这条链路里没有高并发、没有复杂算法，但有完整的增删改查、登录鉴权、订单状态机、图片上传和支付对接，正好覆盖本科毕设要求的知识点密度。
它适合谁？适合计算机、软件工程、信息管理这类专业，手上有 Java 或 Node 基础、想在一个月内做出可演示系统的同学。不适合谁？不适合想靠它冲优秀论文、做算法创新的人——这个题目的天花板在工程实现，不在学术创新。所以这篇笔记不聊虚的，就按「源码怎么读、开发说明怎么写、环境怎么搭、坑在哪」这条线走一遍，让你拿到一份基于微信小程序的农产品销售平台源码加开发说明之后，知道从哪下手。
2. 拆解农产品销售平台的技术栈：小程序端、服务端、数据层怎么分工
2.1 小程序端负责什么，不负责什么
微信小程序在这个项目里承担的是「展示 + 交互」层。页面列表、商品详情、购物车、订单确认、个人中心，这些都在小程序端完成。它不负责业务规则的最终裁决——比如库存够不够、订单能不能取消，这些判断必须放在服务端。很多同学翻车就翻在这里：把库存扣减写在小程序端，用户连点两次下单按钮，库存直接扣成负数。
小程序端的技术选型通常有两种：原生开发（WXML + WXSS + JS）和 uniapp。原生开发的好处是微信开发者工具直接跑，不用额外编译；uniapp 的好处是一套代码能出多端。毕设场景我一般建议原生，因为调试链路短，出问题好定位。页面列表加载更多这种交互，原生用onReachBottom配合分页参数就能实现，不需要引入额外组件库。
小程序端还有一个容易被忽略的点：顶部导航栏高度。如果你用自定义导航栏，不同机型的状态栏高度不一样，需要动态获取。常见做法是用wx.getSystemInfoSync()拿到statusBarHeight，再叠加标题栏高度。这个细节在开发说明里最好写清楚，答辩老师看到会觉得你考虑过兼容性。
2.2 服务端接口设计：RESTful 还是随便写
服务端是整个平台的大脑。毕设里最常见的做法是 SpringBoot + MyBatis，也有用 Node + Express 的。不管哪种，接口设计要遵循一个基本原则：按资源划分，用 HTTP 方法表达动作。下面是一个商品模块的接口示例，用 SpringBoot 写：
// 商品控制器：按资源划分，GET 查、POST 增、PUT 改、DELETE 删 @RestController @RequestMapping("/api/product") public class ProductController { @Autowired private ProductService productService; // 分页查询商品列表，page 从 1 开始，size 默认 10 @GetMapping("/list") public Result list(@RequestParam(defaultValue = "1") int page, @RequestParam(defaultValue = "10") int size, @RequestParam(required = false) String keyword) { // 关键字模糊匹配商品名，用于搜索场景 PageInfo<Product> info = productService.pageQuery(page, size, keyword); return Result.success(info); } // 新增商品，接收 JSON 体，包含 name、price、stock、coverUrl 等字段 @PostMapping("/add") public Result add(@RequestBody Product product) { // 库存和价格必须为正数，服务端做二次校验 if (product.getPrice() == null || product.getStock() == null || product.getStock() < 0) { return Result.fail("参数不合法"); } productService.save(product); return Result.success(); } }这段代码的逻辑说明：/api/product/list用 GET 方法做分页查询，page和size是分页参数，keyword是可选的搜索条件。/api/product/add用 POST 方法新增商品，服务端对价格和库存做了非空和正数校验。参数说明：page默认 1，size默认 10，这两个值前端可以传，但服务端要设上限，防止有人传size=100000把数据库拖垮。
2.3 数据层：几张核心表撑起整个平台
农产品销售平台的数据库不需要太复杂，五张表基本够用：用户表、商品表、订单表、订单明细表、购物车表。下面用表格把关键字段列清楚，方便你对照源码里的建表语句。
| 表名 | 关键字段 | 说明 |
|---|---|---|
| user | id, openid, nickname, phone, role | role 区分买家和农户，0 买家 1 农户 |
| product | id, name, price, stock, cover_url, farmer_id, status | status 0 下架 1 上架 |
| order | id, order_no, user_id, total_amount, status, create_time | status 0 待付款 1 待发货 2 已发货 3 已完成 |
| order_item | id, order_id, product_id, quantity, price | 下单时的价格快照，防止商品改价影响历史订单 |
| cart | id, user_id, product_id, quantity | 购物车，同一用户同一商品只存一条 |
订单明细表里的price字段是价格快照，这个设计很重要。如果直接关联商品表取当前价格，商品一旦调价，历史订单金额就全乱了。这是很多同学在开发说明里写不清楚、答辩被追问的点。
3. 把源码跑起来：环境搭建、配置修改、首次启动的完整步骤
3.1 后端环境：JDK、Maven、MySQL 三件套
拿到源码后，第一步不是急着打开 IDE，而是先把环境对齐。后端通常需要 JDK 8 或 11、Maven 3.6 以上、MySQL 5.7 或 8.0。版本不对齐是启动失败的头号原因，尤其是 JDK 版本——用 JDK 17 跑一个基于 JDK 8 编译的 SpringBoot 项目，大概率报模块访问错误。
安装完三件套后，用命令行验证：
# 检查 JDK 版本，输出应为 1.8 或 11 java -version # 检查 Maven 版本 mvn -v # 登录 MySQL，确认服务已启动 mysql -u root -p这三条命令都通过之后，再进入下一步。如果java -version报「不是内部或外部命令」，说明环境变量没配好，先解决这个再往下走。
3.2 数据库导入与配置文件修改
源码包里一般会有一个sql目录，里面是建表语句和初始数据。导入方式：
# 创建数据库，字符集用 utf8mb4，支持 emoji mysql -u root -p -e "CREATE DATABASE agri_sale DEFAULT CHARACTER SET utf8mb4;" # 导入建表脚本，路径按实际源码包调整 mysql -u root -p agri_sale < ./sql/init.sql导入完成后，打开后端的配置文件application.yml，修改数据库连接信息：
spring: datasource: url: jdbc:mysql://localhost:3306/agri_sale?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 你的数据库密码 driver-class-name: com.mysql.cj.jdbc.Driver参数说明：serverTimezone=Asia/Shanghai必须加，否则 MySQL 8.0 会报时区错误；characterEncoding=utf8保证中文不乱码。这两项是血泪经验，少一个都可能让你卡半天。
3.3 小程序端配置与首次联调
后端启动成功后（控制台看到 Tomcat started on port 8080 之类），打开微信开发者工具，导入小程序端代码。需要改两个地方：一是app.js或请求封装文件里的baseUrl，改成你本机的后端地址；二是开发者工具右上角「详情」里的「本地设置」，勾选「不校验合法域名」。
// utils/request.js 请求封装示例 const BASE_URL = 'http://localhost:8080/api'; function request(options) { return new Promise((resolve, reject) => { wx.request({ url: BASE_URL + options.url, method: options.method || 'GET', data: options.data || {}, header: { 'content-type': 'application/json' }, success: (res) => { // 后端统一返回 { code, msg, data } 结构 if (res.data.code === 200) { resolve(res.data.data); } else { wx.showToast({ title: res.data.msg, icon: 'none' }); reject(res.data); } }, fail: reject }); }); }逻辑说明：所有请求走统一的request函数，BASE_URL只在这里定义一次，换环境只改这一处。参数说明：options.url是接口路径，options.method默认 GET，options.data是请求参数。后端返回结构统一为{ code, msg, data }，code为 200 表示成功，其他值走错误提示。
联调顺序建议：先测登录接口，再测商品列表，最后测下单。登录通了说明数据库和接口链路没问题，商品列表通了说明分页和查询没问题，下单通了说明整个业务闭环成立。
4. 开发说明怎么写才像做过项目：模块划分、接口文档、部署说明
4.1 开发说明的骨架：让答辩老师三分钟看懂
开发说明不是源码注释的堆砌，而是一份能让别人快速理解你系统结构的文档。我一般按这个骨架写：项目概述、技术选型、功能模块划分、数据库设计、接口说明、部署步骤、测试用例。其中功能模块划分和数据库设计是重点，答辩老师翻得最多的就是这两部分。
功能模块划分用文字加表格，不要只画一张图。比如买家端模块：注册登录、商品浏览、搜索、购物车、下单、订单查询、个人信息。农户端模块：商品管理、订单处理、发货、数据统计。每个模块下面写清楚涉及哪些页面、调用哪些接口。
4.2 接口文档：用表格把参数写死
接口文档不需要多花哨，一张表格把请求方式、路径、参数、返回值写清楚就行。下面是一个下单接口的文档示例：
| 项目 | 内容 |
|---|---|
| 请求方式 | POST |
| 请求路径 | /api/order/create |
| 请求参数 | userId（用户ID）、items（商品数组，含 productId 和 quantity） |
| 返回参数 | orderNo（订单号）、totalAmount（总金额） |
| 错误码 | 4001 库存不足、4002 商品已下架、4003 用户不存在 |
写接口文档的时候，错误码一定要列全。答辩时老师问「库存不足怎么处理」，你直接翻到错误码表指给他看，比口头解释有说服力得多。
4.3 部署说明：从本机到服务器的关键差异
开发说明里最好留一节部署说明，哪怕你只在本地跑过。写清楚服务器需要装什么、端口怎么开、数据库怎么迁移。常见做法是后端打成 jar 包，用nohup java -jar xxx.jar &后台运行；小程序端上传代码后在微信公众平台提交审核。这一节不用写太长，但要有，它体现你考虑过「这个系统不只是能跑，还能上线」。
5. 避坑与排查：农产品销售平台毕设里最容易翻车的五件事
5.1 现象：小程序请求后端一直失败，报「不在以下 request 合法域名列表中」
原因：微信开发者工具默认校验请求域名，本地localhost不在白名单里。解决：打开开发者工具「详情」→「本地设置」→ 勾选「不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书」。注意这个选项只在开发阶段用，上线必须配置真实域名并备案。
5.2 现象：商品图片上传成功但显示不出来
原因：图片存的是本地磁盘路径，小程序端访问不到。解决：后端把上传的图片映射成静态资源访问路径，或者直接存到对象存储返回 URL。本地开发常见做法是在 SpringBoot 里配置WebMvcConfigurer把上传目录映射为/upload/**，小程序端用baseUrl + /upload/xxx.jpg访问。
5.3 现象：下单后库存没减，或者减了两次
原因：库存扣减逻辑写在了小程序端，或者服务端没有做并发控制。解决：库存扣减必须放在服务端，并且用数据库行锁或乐观锁。简单做法是UPDATE product SET stock = stock - #{quantity} WHERE id = #{id} AND stock >= #{quantity}，根据影响行数判断是否扣减成功。
5.4 现象：订单状态乱跳，已完成的订单还能取消
原因：订单状态机没有约束，任何状态都能调到任何状态。解决：在服务端写状态流转校验，比如只有「待付款」能取消，「待发货」能发货，「已发货」能确认收货。把合法流转路径写成一个 Map，每次改状态前查一下。
5.5 现象：开发说明里的接口和源码对不上
原因：先写文档后写代码，或者改代码没同步改文档。解决：接口文档和代码放在同一个仓库，改接口的时候顺手改文档。答辩前通读一遍文档，把每个接口路径在代码里搜一遍，确认能对上。
6. 让这个毕设多拿几分：三个能现场演示的进阶技巧
第一个技巧是给商品列表加一个「加载更多」的完整实现。很多同学的分页只做了第一页，往下滑没反应。正确做法是在页面的onReachBottom里判断hasMore标志，有更多数据时页码加一继续请求，没有更多时显示「没有更多了」。这个交互答辩老师大概率会现场滑一下，做出来就是加分项。
// pages/product/list.js 分页加载核心逻辑 Page({ data: { list: [], page: 1, hasMore: true, loading: false }, onLoad() { this.loadData(); }, onReachBottom() { // 没有更多或正在加载时直接返回，防止重复请求 if (!this.data.hasMore || this.data.loading) return; this.setData({ page: this.data.page + 1 }); this.loadData(); }, loadData() { this.setData({ loading: true }); request({ url: '/product/list', data: { page: this.data.page, size: 10 } }) .then(res => { // 拼接新数据，判断是否还有下一页 const newList = this.data.list.concat(res.list); this.setData({ list: newList, hasMore: newList.length < res.total, loading: false }); }) .catch(() => this.setData({ loading: false })); } });逻辑说明：onReachBottom是页面触底回调，hasMore控制是否继续加载，loading防止用户快速滑动触发多次请求。参数说明：page当前页码，size每页条数，res.total是后端返回的总记录数，用来判断是否还有下一页。
第二个技巧是给订单列表加状态筛选。买家最关心的是「我买的到哪了」，按状态筛选比一长串列表体验好得多。实现上就是在请求参数里多传一个status，后端 SQL 加一个WHERE status = #{status}条件。
第三个技巧是准备一份演示数据。答辩现场网络不一定好，数据库里提前塞十几条商品和几条不同状态的订单，演示的时候直接点，不用现场录入。演示数据要真实一点，农产品名字用「赣南脐橙」「五常大米」这种，别用「测试商品1」。
最后说个我自己的习惯：源码跑通之后，我会把整个启动流程在另一台电脑上重走一遍，把每一步遇到的报错和解决方式记在一个README里。这个 README 答辩时不一定用得上，但它能逼你把环境依赖理清楚，也能防止答辩当天换电脑演示时手忙脚乱。希望帮到你。
本文还有配套的精品资源，点击获取
