简介这份资源是面向计算机专业毕业生与课程设计学习者的农产品自主供销小程序完整项目包采用微信开发者工具搭配Java、SSM框架与MySQL数据库实现适合作为毕业设计、课程设计或项目实战参考。系统按管理员、用户、农户三类角色划分权限管理员端涵盖用户管理、农户管理、产品分类、农产品管理、咨询信息与回复、系统管理等模块用户端在小程序内实现首页、农产品浏览、购物车、充值、收藏、订单及咨询互动农户端可管理农产品、处理咨询与订单。压缩包共1400个文件约13.35MB包含136个Java源码、148个Vue组件、199个JavaScript脚本、96个WXML与98个WXSS页面文件以及PNG、SVG等图片素材和SQL数据库脚本、说明文档覆盖前后端与数据库全链路。已有178人学习可帮助读者快速理解三角色权限设计与小程序商城业务流程直接用于二次开发或答辩演示。1. 农产品自主供销小程序从选题到跑通一套能写进简历的完整链路很多计算机毕业设计的选题卡在“看起来能做真动手就散架”这一步。农产品自主供销小程序就是典型农户发布货源、买家下单、后台管理订单业务闭环清晰但一旦落到微信小程序加 Java 后端的技术组合上登录态怎么打通、图片存哪、订单状态怎么流转每个点都能让人卡三天。这个选题真正解决的是“农产品从田间到餐桌的信息不对称”适合想用一个完整前后端项目撑起毕业设计、同时又不满足于增删改查的本科生。它不需要高深算法但要求你把小程序端、Java 服务端、数据库三层的协作关系理清楚。下面按我实际搭过一遍的顺序把选型、建表、接口、联调和踩坑讲透你照着能跑出一个可演示、可答辩的版本。2. 技术选型与数据库设计为什么用 Spring Boot 而不是 Servlet2.1 小程序端与 Java 后端的职责边界微信小程序负责展示和交互Java 后端负责业务逻辑和数据持久化这个分工听起来像废话但很多毕设翻车就翻在边界模糊上。常见做法是把订单金额计算、库存扣减这类逻辑写在小程序里结果后端接口一被绕过数据全乱。我一般会坚持一条原则小程序端只做展示和收集用户输入任何涉及金额、库存、权限的判断全部放在 Java 服务端。比如农产品下单时小程序只传商品 ID 和数量单价和总价由后端从数据库查出后计算这样即使前端被篡改订单金额也不会错。小程序通过wx.request调用后端 RESTful 接口数据格式统一用 JSON。后端返回结构建议固定为{ code, msg, data }code 为 0 表示成功非 0 表示业务异常。这样小程序端可以写一个统一的请求封装避免每个页面都判断 HTTP 状态码。Java 后端用 Spring Boot 起步原因是它内置 Tomcat、配置量少对毕设这种周期紧的场景最友好。如果你学校要求用 SSM把 Controller 层换成Controller加视图解析也能跑但接口返回 JSON 时 Spring Boot 的RestController更省事。2.2 农产品供销场景的数据库表设计农产品自主供销的核心实体有四个用户、农产品、订单、订单明细。用户表要区分角色农户和买家共用一张表用role字段标记这样登录逻辑统一权限判断在接口层做。农产品表除了名称、价格、库存还要有farmer_id关联发布者以及status字段控制上架下架。订单表的主键用自增 ID订单号单独生成方便展示和查询。订单明细表记录每个订单买了哪些农产品、数量、下单时的单价单价必须冗余存储因为农产品价格会变不能下单后还去关联查当前价。下面是我实际建表用的 SQL字段类型和索引都按能跑通的标准来-- 用户表农户和买家共用role 区分 CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, openid VARCHAR(64) UNIQUE COMMENT 微信openid登录凭证, nickname VARCHAR(64) COMMENT 昵称, avatar VARCHAR(255) COMMENT 头像地址, role TINYINT DEFAULT 0 COMMENT 0买家 1农户, phone VARCHAR(20) COMMENT 联系电话, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 农产品表farmer_id 关联发布者 CREATE TABLE product ( id INT PRIMARY KEY AUTO_INCREMENT, farmer_id INT NOT NULL COMMENT 发布农户ID, name VARCHAR(100) NOT NULL COMMENT 农产品名称, price DECIMAL(10,2) NOT NULL COMMENT 单价, stock INT DEFAULT 0 COMMENT 库存, unit VARCHAR(10) DEFAULT 斤 COMMENT 单位, cover_img VARCHAR(255) COMMENT 封面图, description TEXT COMMENT 描述, status TINYINT DEFAULT 1 COMMENT 1上架 0下架, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_farmer (farmer_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 订单表order_no 单独生成便于展示 CREATE TABLE orders ( id INT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) UNIQUE NOT NULL COMMENT 订单号, buyer_id INT NOT NULL COMMENT 买家ID, total_amount DECIMAL(10,2) NOT NULL COMMENT 订单总额, status TINYINT DEFAULT 0 COMMENT 0待付款 1已付款 2已发货 3已完成 4已取消, address VARCHAR(255) COMMENT 收货地址, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_buyer (buyer_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 订单明细表单价冗余存储防止价格变动 CREATE TABLE order_item ( id INT PRIMARY KEY AUTO_INCREMENT, order_id INT NOT NULL, product_id INT NOT NULL, product_name VARCHAR(100) COMMENT 下单时名称快照, price DECIMAL(10,2) COMMENT 下单时单价快照, quantity INT NOT NULL, INDEX idx_order (order_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;建表时有两个参数值得注意。utf8mb4字符集必须显式指定否则农产品名称里的生僻字或 emoji 会报错。DECIMAL(10,2)用于价格不要用FLOAT浮点数在金额计算时会出现0.10.20.30000000000000004这种玄学问题答辩时被问到很难解释。订单明细里的product_name和price是快照字段农户改价后历史订单不受影响这是电商类系统的通用做法。2.3 Spring Boot 项目结构与依赖配置后端项目用 Maven 构建pom.xml里核心依赖是spring-boot-starter-web、mybatis-plus-boot-starter、mysql-connector-java和lombok。MyBatis-Plus 比原生 MyBatis 省去大量 XML毕设场景够用。配置文件application.yml里数据库连接、端口、文件上传路径三项必须改对server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/agri_market?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 5MB max-request-size: 10MB mybatis-plus: configuration: map-underscore-to-camel-case: true global-config: db-config: id-type: auto file: upload-path: /data/agri/upload/serverTimezoneAsia/Shanghai不加会报时区错误这是 MySQL 8 的常见坑。map-underscore-to-camel-case让数据库的create_time自动映射到 Java 的createTime省去手写映射。文件上传路径用绝对路径不要用相对路径否则打成 jar 包后路径会变图片存到临时目录里重启就丢。3. 微信登录与农户发布接口打通小程序和 Java 后端的第一条链路3.1 小程序 wx.login 换 openid 的完整流程微信小程序的登录不能直接拿用户信息必须先调wx.login拿到临时 code传给后端后端用 code 加 AppID、AppSecret 去微信接口换 openid 和 session_key。这个流程是固定的但坑在于 AppSecret 不能放在小程序端必须放后端。后端换到 openid 后查用户表存在就返回自定义登录态不存在就插入新用户再返回。自定义登录态我一般用 JWT简单且无状态毕设够用。小程序端登录代码// pages/login/login.js Page({ onLoad() { wx.login({ success: (res) { if (res.code) { // 把 code 发给后端换登录态 wx.request({ url: http://localhost:8080/api/user/login, method: POST, data: { code: res.code }, success: (resp) { if (resp.data.code 0) { // 存 token 和用户信息到本地 wx.setStorageSync(token, resp.data.data.token); wx.setStorageSync(userInfo, resp.data.data.user); wx.switchTab({ url: /pages/index/index }); } else { wx.showToast({ title: resp.data.msg, icon: none }); } } }); } } }); } });后端登录接口// UserController.java RestController RequestMapping(/api/user) public class UserController { Value(${wx.appid}) private String appid; Value(${wx.secret}) private String secret; Autowired private UserService userService; PostMapping(/login) public Result login(RequestBody MapString, String params) { String code params.get(code); // 调微信接口换 openid String url https://api.weixin.qq.com/sns/jscode2session ?appid appid secret secret js_code code grant_typeauthorization_code; String resp HttpUtil.get(url); JSONObject json JSONUtil.parseObj(resp); String openid json.getStr(openid); if (openid null) { return Result.fail(微信登录失败); } // 查库不存在则注册 User user userService.getByOpenid(openid); if (user null) { user new User(); user.setOpenid(openid); user.setRole(0); userService.save(user); } // 生成 JWT String token JwtUtil.createToken(user.getId(), user.getRole()); MapString, Object data new HashMap(); data.put(token, token); data.put(user, user); return Result.success(data); } }这段代码的关键参数是appid和secret从微信公众平台获取写在application.yml里不要硬编码。jscode2session接口返回的session_key不要下发给小程序它用于解密敏感数据留在后端。JWT 的过期时间设 7 天毕设演示够用生产环境要加刷新机制。3.2 农户发布农产品的接口与图片上传农户发布农产品需要传名称、价格、库存、描述和封面图。图片上传单独一个接口返回图片 URL发布接口再存 URL。这样设计是因为小程序端wx.uploadFile和wx.request不能混在一个请求里。上传接口用MultipartFile接收存到配置的upload-path返回可访问的 URL。注意 URL 要拼上后端地址否则小程序端显示不出来。// FileController.java PostMapping(/upload) public Result upload(RequestParam(file) MultipartFile file) { if (file.isEmpty()) { return Result.fail(文件为空); } // 用 UUID 重命名防止中文名和重名 String originalName file.getOriginalFilename(); String suffix originalName.substring(originalName.lastIndexOf(.)); String fileName UUID.randomUUID().toString() suffix; File dest new File(uploadPath fileName); if (!dest.getParentFile().exists()) { dest.getParentFile().mkdirs(); } try { file.transferTo(dest); } catch (IOException e) { return Result.fail(上传失败); } // 返回可访问 URL String url http://localhost:8080/upload/ fileName; return Result.success(url); }上传路径要在 Spring Boot 里配置静态资源映射否则 URL 访问不到Configuration public class WebConfig implements WebMvcConfigurer { Value(${file.upload-path}) private String uploadPath; Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceLocations(file: uploadPath); } }file:前缀不能少少了会当成 classpath 路径。上传文件大小限制在application.yml里配的 5MB农产品图片手机拍的一般 2 到 3MB够用。如果超了小程序端要加压缩用wx.compressImage把质量降到 80%能省一半体积。3.3 订单创建与库存扣减的事务处理下单接口是业务最复杂的地方要同时写订单表、订单明细表、扣库存。这三步必须在一个事务里任何一步失败全部回滚。用Transactional注解注意默认只回滚RuntimeException如果抛的是检查异常要显式指定rollbackFor Exception.class。库存扣减用UPDATE product SET stock stock - #{quantity} WHERE id #{id} AND stock #{quantity}把库存判断放在 SQL 里避免并发超卖。返回影响行数为 0 就说明库存不足抛异常回滚。Service public class OrderService { Autowired private ProductMapper productMapper; Autowired private OrderMapper orderMapper; Autowired private OrderItemMapper orderItemMapper; Transactional(rollbackFor Exception.class) public String createOrder(Integer buyerId, ListOrderItemDTO items, String address) { BigDecimal total BigDecimal.ZERO; String orderNo AG System.currentTimeMillis(); // 先扣库存并计算总价 for (OrderItemDTO item : items) { Product product productMapper.selectById(item.getProductId()); if (product null || product.getStatus() 0) { throw new RuntimeException(农产品已下架); } int rows productMapper.reduceStock(item.getProductId(), item.getQuantity()); if (rows 0) { throw new RuntimeException(product.getName() 库存不足); } total total.add(product.getPrice().multiply(new BigDecimal(item.getQuantity()))); } // 写订单 Orders order new Orders(); order.setOrderNo(orderNo); order.setBuyerId(buyerId); order.setTotalAmount(total); order.setAddress(address); order.setStatus(0); orderMapper.insert(order); // 写明细 for (OrderItemDTO item : items) { Product product productMapper.selectById(item.getProductId()); OrderItem oi new OrderItem(); oi.setOrderId(order.getId()); oi.setProductId(item.getProductId()); oi.setProductName(product.getName()); oi.setPrice(product.getPrice()); oi.setQuantity(item.getQuantity()); orderItemMapper.insert(oi); } return orderNo; } }reduceStock的 SQL 是UPDATE product SET stock stock - #{quantity} WHERE id #{id} AND stock #{quantity}这个条件更新是防超卖的核心。订单号用时间戳生成毕设场景够用生产环境要加随机数防碰撞。事务方法里不要做远程调用否则事务时间过长会锁表。4. 前后端联调与部署从本地跑通到能演示4.1 小程序端请求封装与跨域处理小程序开发时本地调试要在微信开发者工具里勾选“不校验合法域名”否则http://localhost:8080会被拦截。正式发布必须用 HTTPS 域名毕设演示用本地就行。请求封装统一加 token 到 header后端用拦截器校验。拦截器里放行登录接口和静态资源其他接口校验 JWT解析出 userId 和 role 存到ThreadLocalController 里直接取。// utils/request.js const BASE_URL http://localhost:8080; function request(options) { const token wx.getStorageSync(token); return new Promise((resolve, reject) { wx.request({ url: BASE_URL options.url, method: options.method || GET, data: options.data || {}, header: { Content-Type: application/json, Authorization: token ? Bearer token : }, success: (res) { if (res.data.code 0) { resolve(res.data.data); } else if (res.data.code 401) { // token 过期重新登录 wx.removeStorageSync(token); wx.redirectTo({ url: /pages/login/login }); reject(res.data); } else { wx.showToast({ title: res.data.msg, icon: none }); reject(res.data); } }, fail: reject }); }); } module.exports { request };后端拦截器public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { // 放行登录和静态资源 String uri request.getRequestURI(); if (uri.contains(/api/user/login) || uri.startsWith(/upload/)) { return true; } String token request.getHeader(Authorization); if (token null || !token.startsWith(Bearer )) { response.setStatus(401); return false; } try { Claims claims JwtUtil.parseToken(token.substring(7)); UserContext.setUserId(claims.get(userId, Integer.class)); UserContext.setRole(claims.get(role, Integer.class)); return true; } catch (Exception e) { response.setStatus(401); return false; } } Override public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) { UserContext.clear(); } }UserContext用ThreadLocal实现请求结束必须clear否则线程池复用时会串数据这是血泪经验。拦截器注册时排除登录接口和上传目录其他全部拦截。4.2 本地部署与演示环境搭建后端打成 jar 包用java -jar启动数据库用本地 MySQL。小程序端在微信开发者工具里导入项目填上自己的 AppID。演示前检查三件事数据库连接是否通、上传目录是否存在且有写权限、小程序端BASE_URL是否指向后端地址。常见翻车是上传目录没建图片上传报 500但日志里只看到FileNotFoundException不仔细看找不到原因。如果答辩需要外网访问用内网穿透工具把 8080 端口映射出去小程序端BASE_URL改成映射地址。注意微信开发者工具要重新勾选“不校验合法域名”否则新地址也会被拦。数据库导出用mysqldump -u root -p agri_market agri_market.sql导入用source命令字符集指定utf8mb4。5. 避坑与排查农产品供销小程序最容易翻车的五个点5.1 登录态失效但小程序没跳转现象用户操作到一半接口返回 401但页面没反应继续点也没提示。原因是请求封装里只处理了code 0和业务异常没处理 HTTP 401。解决在wx.request的success里判断res.statusCode 401或者后端统一返回code: 401前端拦截后清 token 并跳登录页。我一般让后端返回code: 401前端在封装里统一处理避免两套判断逻辑。5.2 图片上传成功但小程序显示裂图现象上传接口返回了 URL但小程序image标签显示不出来。原因通常是 URL 拼错比如后端返回/upload/xxx.jpg小程序端直接用了这个相对路径而image需要完整地址。解决后端返回完整 URL或者小程序端拼接BASE_URL。另外检查静态资源映射的file:前缀少了这个前缀 Spring Boot 会去 classpath 找找不到就 404。5.3 订单创建时库存扣了但订单没生成现象数据库里库存少了但订单表没记录。原因是Transactional没生效常见于同类内部方法调用比如createOrder调了本类的另一个Transactional方法代理不生效。解决把事务方法拆到不同 Service或者用AopContext.currentProxy()获取代理。更简单的做法是确保createOrder本身就是入口方法由 Controller 直接调用。5.4 小程序端真机调试请求失败现象开发者工具里正常真机预览时接口全部失败。原因是真机不支持localhost必须用局域网 IP 或外网地址。解决把BASE_URL改成电脑的局域网 IP比如http://192.168.1.100:8080手机和电脑连同一个 WiFi。同时后端要监听0.0.0.0Spring Boot 默认就是不用改。防火墙要放行 8080 端口Windows 上经常被拦。5.5 数据库中文乱码现象农产品名称存进去变成问号。原因是数据库、表、连接三处字符集不一致。解决建库时指定CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci建表也指定JDBC URL 加characterEncodingutf8mb4。三处都对了才不会乱码。如果已经建了表用ALTER TABLE product CONVERT TO CHARACTER SET utf8mb4改但已有数据可能已经损坏需要重新录入。6. 进阶技巧用状态机管订单流转答辩时能多拿五分订单状态流转是毕设答辩最容易被追问的点。很多同学用一堆if-else判断状态代码乱且容易漏。我一般会引入一个简单的状态机把允许的流转路径定义成枚举校验时查表判断。这样代码清晰答辩时能讲出设计模式比单纯增删改查高一个层次。先定义状态枚举和流转规则public enum OrderStatus { PENDING(0, 待付款), PAID(1, 已付款), SHIPPED(2, 已发货), COMPLETED(3, 已完成), CANCELLED(4, 已取消); private final int code; private final String desc; OrderStatus(int code, String desc) { this.code code; this.desc desc; } public int getCode() { return code; } // 定义允许的流转当前状态 - 可流转到的状态 public static boolean canTransfer(int from, int to) { switch (from) { case 0: return to 1 || to 4; // 待付款 - 已付款 或 已取消 case 1: return to 2 || to 4; // 已付款 - 已发货 或 已取消 case 2: return to 3; // 已发货 - 已完成 default: return false; } } }然后在订单 Service 里加一个统一的状态变更方法Transactional(rollbackFor Exception.class) public void changeStatus(Integer orderId, Integer targetStatus) { Orders order orderMapper.selectById(orderId); if (order null) { throw new RuntimeException(订单不存在); } if (!OrderStatus.canTransfer(order.getStatus(), targetStatus)) { throw new RuntimeException(当前状态不允许此操作); } order.setStatus(targetStatus); orderMapper.updateById(order); // 如果是取消订单回滚库存 if (targetStatus 4) { ListOrderItem items orderItemMapper.selectByOrderId(orderId); for (OrderItem item : items) { productMapper.addStock(item.getProductId(), item.getQuantity()); } } }这个状态机的价值在于第一所有状态变更走同一个入口不会出现某个接口漏判的情况第二取消订单时自动回滚库存不用在每个取消入口重复写第三答辩时你可以画一张状态流转图讲清楚每个状态的前置和后置条件老师一听就知道你理解业务。canTransfer方法用switch写状态少的时候够用状态多了可以改成MapInteger, SetInteger配置更灵活。验证状态机是否生效可以写一个简单的测试创建订单后直接调changeStatus(orderId, 3)应该抛异常因为待付款不能直接到已完成。再调changeStatus(orderId, 1)应该成功然后changeStatus(orderId, 2)成功最后changeStatus(orderId, 3)成功。这条链路走通说明状态机没问题。如果中途某步失败看异常信息里的“当前状态不允许此操作”对照流转规则排查。我自己的习惯是任何涉及多状态流转的业务先画状态图再写代码图里标清楚每个箭头对应的操作和权限。农产品供销小程序的订单状态不多五个状态足够覆盖从下单到完成的完整链路。答辩前把状态流转图打印出来老师问到时直接指着图讲比翻代码高效得多。希望帮到你。本文还有配套的精品资源点击获取