简介这是一套面向高校计算机相关专业学生的毕业设计/课程设计完整项目包主题为微信小程序与Java后端结合的农产品自主供销系统适合正在准备毕设、需要项目实战练手或想学习小程序全栈开发的学习者。项目采用微信开发者工具、Java、SSM框架与MySQL数据库按管理员、用户、农户三类角色划分权限管理员端涵盖用户管理、农户管理、产品分类、农产品管理、咨询信息与回复管理及系统管理用户端在小程序内实现农产品浏览、购物车、充值、收藏、订单与咨询互动农户端可管理农产品、处理咨询与订单。压缩包共1400个文件约13.35MB包含136个Java源文件、148个Vue组件、199个JS脚本、96个WXML与98个WXSS页面样式以及PNG、SVG等图片资源和SQL脚本、说明文档覆盖前后端完整代码与数据库。已有178人学习下载可作为毕设选题参考与全栈开发实践模板。1. 农产品自主供销小程序从「能跑」到「敢答辩」的完整落地路径很多同学做毕业设计时选题一确定就急着写代码结果做到一半发现数据库表设计有硬伤、后端接口和前端页面字段对不上、答辩时被老师问「你这个自主供销到底自主在哪」直接卡壳。农产品自主供销小程序这个题目核心不是做一个电商壳子而是要让农户能自主发布货源、买家能直接对接、平台只做撮合不做囤货这个业务逻辑决定了你的表结构和接口设计跟普通商城完全不一样。技术栈选微信小程序加 Java 后端是毕业设计里最稳的组合小程序端有现成的开发者工具和调试能力Java 后端用 Spring Boot 起步快、资料多、答辩时老师也认。这篇笔记按「先想清楚业务 → 再搭骨架 → 再填肉 → 最后排雷」的顺序走每一步都给出可复现的命令和代码新手能照着跑通熟手能直接拿去改自己的业务参数。2. 先把业务模型定死农产品自主供销和普通商城的四个本质区别2.1 自主供销的业务闭环到底长什么样普通电商是平台采销或店铺卖货角色只有买家和卖家。农产品自主供销多了一个「农户自主上架」的环节而且农户往往不是专业卖家他可能今天有五十斤土豆、明天有三十斤白菜货源是动态的、非标准的。这就决定了你的系统里必须有一个「货源发布」模块农户填的是产地、采收日期、预估产量、期望价格区间而不是标准商品的 SKU 和库存。买家看到的是「谁家的、什么时候采的、大概多少量」然后发起询价或直接下单。平台不介入定价和物流只提供信息展示和订单撮合。这个闭环落到数据库上至少需要这几张核心表用户表区分农户和买家角色、农产品分类表、货源信息表含产地、采收日期、产量、价格区间、状态、订单表含买家、货源、数量、成交价、状态流转、评价表。注意货源信息表里不要照搬电商的「库存」字段农产品是「预估产量」实际成交可能分多次所以订单和货源是一对多关系这个设计点答辩时老师很可能会问。2.2 为什么选微信小程序加 Java 后端而不是其他组合微信小程序端的优势在于免安装、即用即走农户用手机就能发布货源不需要教他们装 App。开发上用微信开发者工具调试和预览都很直接。Java 后端选 Spring Boot是因为毕业设计周期通常只有两三个月你需要一个能快速出活、生态成熟的框架。Spring Boot 加 MyBatis-Plus 加 MySQL 这套组合网上能搜到的参考代码最多遇到问题也最容易找到答案。前后端分离是现在的主流做法小程序端通过 HTTPS 请求调用后端 RESTful 接口后端返回 JSON 数据。这里要注意一个毕业设计常见的翻车点很多同学在小程序里直接写wx.request调本地localhost:8080真机预览时发现请求失败。原因是小程序真机环境不认 localhost必须用局域网 IP 或者部署到有域名的服务器上。开发阶段可以在微信开发者工具里勾选「不校验合法域名」但答辩演示如果要用真机最好提前把后端部署到一台有公网 IP 的服务器上或者用内网穿透工具把本地服务暴露出去。2.3 数据库表设计的最小可用集合下面这张表是我一般会先定下来的核心字段你可以直接拿去建表再根据自己的业务加字段。表名核心字段说明userid, openid, role, nickname, phone, avatarrole 区分 farmer 和 buyercategoryid, name, parent_id, sort支持二级分类如蔬菜-叶菜supplyid, farmer_id, category_id, title, origin, harvest_date, estimate_weight, price_min, price_max, status, create_timestatus 控制上架/下架/已售罄ordersid, buyer_id, supply_id, weight, deal_price, status, create_timestatus 走待确认/已确认/已完成/已取消commentid, order_id, buyer_id, farmer_id, score, content双向评价建表时注意supply表的estimate_weight用 decimal 而不是 int因为农产品可能按斤也可能按公斤单位不统一时用 decimal 更稳妥。orders表的deal_price也要用 decimal别用 float否则算钱时会出现精度问题答辩时被问到「为什么不用 float」你要能答上来。2.4 用 Spring Boot 初始化后端骨架的最小命令后端项目我一般用 Spring Initializr 生成选 Maven、Java 8 或 11、Spring Boot 2.7.x依赖勾选 Spring Web、MyBatis Framework、MySQL Driver、Lombok。生成后解压用 IDEA 打开改application.yml里的数据库连接。server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/agri_supply?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: true这段配置里serverTimezone必须写否则 MySQL 8 会报时区错误。map-underscore-to-camel-case打开后数据库的harvest_date会自动映射到 Java 的harvestDate省去手写 resultMap 的麻烦。改完配置后启动项目看到控制台输出 Tomcat started on port 8080 就算骨架通了。这一步如果报数据库连接失败先检查 MySQL 服务有没有启动、用户名密码对不对、数据库agri_supply有没有提前建好。3. 小程序端从零到能调通接口页面结构、请求封装和登录态3.1 小程序项目目录怎么组织才不乱用微信开发者工具新建项目选「不使用云服务」模板选「JavaScript」。生成后你会看到pages目录下默认有 index 和 logs 两个页面。我一般会按业务模块重新组织pages/index放首页货源列表pages/supply放货源发布和详情pages/order放订单列表和详情pages/user放个人中心。每个页面四个文件.js、.wxml、.wxss、.json。app.json里配置页面路径和 tabBar。{ pages: [ pages/index/index, pages/supply/publish, pages/supply/detail, pages/order/list, pages/user/user ], window: { navigationBarTitleText: 农产品自主供销, navigationBarBackgroundColor: #2e7d32 }, tabBar: { list: [ { pagePath: pages/index/index, text: 首页 }, { pagePath: pages/order/list, text: 订单 }, { pagePath: pages/user/user, text: 我的 } ] } }app.json里pages数组的第一项就是启动页所以把首页放第一位。tabBar 的list至少两项最多五项每项必须有pagePath和text。注意 tabBar 的页面路径必须在pages数组里已经注册过否则开发者工具会报错。这个配置改完后点编译底部出现三个 tab 就算对了。3.2 封装一个能复用的请求工具小程序里如果每个页面都写一遍wx.request代码会非常冗余而且登录态、错误处理、baseUrl 切换都很麻烦。我一般会在utils目录下建一个request.js统一封装。const BASE_URL http://192.168.1.100:8080; 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, token: wx.getStorageSync(token) || }, success(res) { if (res.statusCode 200 res.data.code 0) { resolve(res.data.data); } else if (res.data.code 401) { wx.removeStorageSync(token); wx.navigateTo({ url: /pages/user/user }); reject(new Error(未登录)); } else { wx.showToast({ title: res.data.msg || 请求失败, icon: none }); reject(new Error(res.data.msg)); } }, fail(err) { wx.showToast({ title: 网络异常, icon: none }); reject(err); } }); }); } module.exports { request };这段代码的关键点有三个一是BASE_URL写的是局域网 IP你在自己电脑上跑后端时用ipconfig或ifconfig查到本机 IP 填进去手机和电脑连同一个 WiFi 就能真机调试二是token从本地缓存取登录后存进去每次请求自动带上三是统一处理了code 401的情况token 过期就清掉并跳转。后端返回的数据结构我一般约定成{ code: 0, msg: ok, data: {...} }code为 0 表示成功非 0 表示业务错误401 专门表示未登录。这个约定要跟后端同学对齐否则前端判断会乱。3.3 登录态怎么打通从 wx.login 到后端换 openid微信小程序的登录流程是小程序端调wx.login拿到临时 code把 code 发给后端后端用 code 加 appid 和 secret 调微信接口换 openid 和 session_key然后生成自己的 token 返回给小程序。小程序把 token 存到本地缓存后续请求带上。// 小程序端登录 wx.login({ success(res) { if (res.code) { request({ url: /api/user/login, method: POST, data: { code: res.code } }).then(data { wx.setStorageSync(token, data.token); wx.setStorageSync(userInfo, data.userInfo); }); } } });后端对应的接口用RestTemplate或HttpUtil调微信的https://api.weixin.qq.com/sns/jscode2session传appid、secret、js_code、grant_typeauthorization_code。拿到 openid 后查用户表没有就插入一条新用户有就更新登录时间然后生成一个 UUID 作为 token 存到 Redis 或直接存到用户表里。毕业设计如果不想引入 Redis可以把 token 存到用户表的token字段设置一个过期时间每次请求校验。注意 appid 和 secret 不要硬编码在代码里提交到公开仓库答辩时老师如果问「你的密钥怎么管理的」你要能说出用配置文件或环境变量。3.4 首页货源列表的渲染和分页加载首页用scroll-view或直接页面滚动都行我一般用页面滚动加onReachBottom触发加载下一页。数据从/api/supply/list拿后端用 MyBatis-Plus 的分页插件返回{ records, total, current, size }。Page({ data: { list: [], page: 1, size: 10, hasMore: true }, onLoad() { this.loadList(); }, loadList() { if (!this.data.hasMore) return; request({ url: /api/supply/list, data: { page: this.data.page, size: this.data.size } }).then(res { this.setData({ list: this.data.list.concat(res.records), page: this.data.page 1, hasMore: res.records.length this.data.size }); }); }, onReachBottom() { this.loadList(); } });这里hasMore的判断逻辑是如果本次返回的记录数等于 pageSize说明可能还有下一页如果小于 pageSize说明已经到底了。这个判断不是绝对准确更严谨的做法是后端返回total前端用list.length total判断。分页参数page和size要跟后端对齐MyBatis-Plus 的分页插件默认从 1 开始别传成 0。4. 后端接口从能跑到能扛货源发布、订单流转和文件上传4.1 货源发布接口的字段校验和状态设计货源发布是农户端的核心操作接口接收的字段包括标题、分类、产地、采收日期、预估产量、价格区间、描述、图片列表。后端用Valid加 JSR-303 注解做参数校验别等到入库时才报错。Data public class SupplyPublishDTO { NotBlank(message 标题不能为空) private String title; NotNull(message 分类不能为空) private Long categoryId; NotBlank(message 产地不能为空) private String origin; NotNull(message 采收日期不能为空) private Date harvestDate; NotNull(message 预估产量不能为空) DecimalMin(value 0.1, message 产量必须大于0) private BigDecimal estimateWeight; NotNull(message 最低价不能为空) private BigDecimal priceMin; NotNull(message 最高价不能为空) private BigDecimal priceMax; private String description; private ListString images; }Controller 层用PostMapping(/api/supply/publish)接收Service 层把 DTO 转成实体设置farmerId为当前登录用户status默认为 1上架中createTime为当前时间。这里有个容易忽略的点priceMin必须小于等于priceMax这个校验用注解做不了要在 Service 里手动判断不满足就抛业务异常。另外图片列表存到数据库时我一般用 JSON 字符串存或者单独建一张supply_image表毕业设计为了简单可以直接存 JSON 字符串但答辩时如果老师问「图片多了怎么查」你要能说出拆表的方案。4.2 订单状态流转怎么设计才不会被老师问倒订单状态是毕业设计答辩的高频提问点。农产品自主供销的订单状态我一般设计成0 待确认、1 已确认、2 已完成、3 已取消。买家下单后状态为 0农户确认后变 1买家收货后变 2任意一方取消变 3。状态流转必须用接口控制不能直接改数据库。PostMapping(/api/order/confirm) public Result confirmOrder(RequestParam Long orderId) { Orders order ordersMapper.selectById(orderId); if (order null) { return Result.fail(订单不存在); } if (order.getStatus() ! 0) { return Result.fail(当前状态不可确认); } order.setStatus(1); ordersMapper.updateById(order); return Result.ok(); }这段代码的关键是状态判断只有待确认的订单才能被确认其他状态直接返回错误。这个逻辑看起来简单但很多同学写的时候不判断导致已完成的订单还能被再次确认答辩演示时如果被老师点到这个操作就很尴尬。另外订单表里要冗余存一份货源标题和买家昵称因为货源可能被下架或修改订单详情页需要展示下单时的快照信息。4.3 图片上传接口和本地存储方案小程序端用wx.chooseImage选图然后用wx.uploadFile上传到后端。后端用MultipartFile接收存到本地磁盘或对象存储。毕业设计为了简单存本地磁盘就行但要注意路径配置和文件重名问题。PostMapping(/api/file/upload) public Result upload(RequestParam(file) MultipartFile file) { if (file.isEmpty()) { return Result.fail(文件为空); } String originalName file.getOriginalFilename(); String suffix originalName.substring(originalName.lastIndexOf(.)); String fileName UUID.randomUUID().toString() suffix; String uploadDir /data/upload/; File dest new File(uploadDir fileName); if (!dest.getParentFile().exists()) { dest.getParentFile().mkdirs(); } try { file.transferTo(dest); return Result.ok(/upload/ fileName); } catch (IOException e) { return Result.fail(上传失败); } }这里用 UUID 重命名是为了避免多个用户上传同名文件互相覆盖。uploadDir要配置成绝对路径别用相对路径否则项目部署到服务器后路径会变。返回的 URL 是相对路径前端拼接 baseUrl 后展示。如果答辩时老师问「文件多了磁盘满了怎么办」你可以说后续可以接入对象存储把文件放到 OSS 上本地只存 URL。另外要注意上传接口的大小限制Spring Boot 默认单文件 1MB需要在application.yml里调大。spring: servlet: multipart: max-file-size: 10MB max-request-size: 50MB这两个参数不调的话农户上传一张手机拍的照片就可能超过 1MB 直接报错这是很常见的翻车点。4.4 跨域和拦截器配置前后端分离项目绕不开跨域问题。小程序端在开发者工具里可以勾选「不校验合法域名」但浏览器端调试接口时会有跨域。后端加一个全局 CORS 配置。Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOriginPatterns(*) .allowedMethods(GET, POST, PUT, DELETE, OPTIONS) .allowedHeaders(*) .allowCredentials(true) .maxAge(3600); } }注意allowedOriginPatterns和allowedOrigins的区别当allowCredentials为 true 时allowedOrigins不能写*要用allowedOriginPatterns。这个坑我在好几个项目里都踩过浏览器控制台报「Access-Control-Allow-Origin 不能为 *」时就是这个原因。另外登录拦截器要放行/api/user/login和/api/file/upload这类不需要登录的接口其他的校验 token。5. 避坑与排查毕业设计里最容易翻车的五个地方5.1 真机预览请求失败开发者工具却正常现象在微信开发者工具里所有接口都能调通用手机扫码预览时首页一直转圈提示网络异常。原因开发者工具默认不校验合法域名但真机环境会校验而且localhost和127.0.0.1在手机上指向手机自己不是你的电脑。解决把BASE_URL改成电脑的局域网 IP手机和电脑连同一个 WiFi如果要用真机演示且不在同一网络提前把后端部署到有公网 IP 的服务器或者在微信公众平台配置合法域名。答辩前一定要用真机完整走一遍流程别只信开发者工具。5.2 数据库字段和实体类对不上查询返回 null现象接口能返回数据但某个字段一直是 null比如harvestDate查出来是空。原因数据库字段是下划线命名harvest_dateJava 实体是驼峰harvestDateMyBatis 默认不自动映射。解决在application.yml里打开map-underscore-to-camel-case: true或者在实体字段上加TableField(harvest_date)。我一般两个都做双保险。另外注意 MySQL 的datetime类型和 Java 的Date类型转换时如果前端传的是字符串2024-01-01后端要用DateTimeFormat或JsonFormat指定格式否则会报解析错误。5.3 订单重复提交一次下单生成两条记录现象买家点了一次下单订单列表里出现两条一模一样的订单。原因网络延迟时用户重复点击或者前端按钮没有防抖连续触发两次请求。解决前端在请求发出后把按钮置灰请求返回后再恢复后端在订单表加唯一索引比如buyer_id supply_id create_time或者用一个请求流水号做幂等。毕业设计里最简单的做法是前端按钮加loading状态后端在插入前先查一下有没有相同买家相同货源的待确认订单有就返回「请勿重复下单」。5.4 图片上传后不显示路径 404现象上传接口返回成功但小程序里图片显示不出来控制台报 404。原因后端返回的是/upload/xxx.jpg但静态资源映射没配Spring Boot 默认不把/upload/**映射到磁盘目录。解决加一个静态资源映射配置。Configuration public class WebConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceLocations(file:/data/upload/); } }注意addResourceLocations的路径最后要有斜杠file:前缀不能少。配完后重启项目浏览器直接访问http://localhost:8080/upload/xxx.jpg能打开图片小程序里就能正常显示了。5.5 答辩时被问「你的项目有什么创新点」答不上来现象功能都做完了但老师问创新点时只能说「用了微信小程序和 Spring Boot」显得很单薄。原因毕业设计不只是功能堆砌老师想看你对业务的理解和技术选型的思考。解决提前准备两三个能说清楚的点。比如「农产品自主供销模式去掉了中间商农户直接发布货源买家直接对接平台只做信息撮合这跟普通商城有本质区别」「订单状态机设计保证了状态流转的严谨性不会出现已完成订单被重复确认的问题」「图片上传用 UUID 重命名加静态资源映射解决了文件重名和访问路径问题」。这些点不需要多高深但要能讲出「为什么这么做」和「不这么做会怎样」。6. 让项目从及格到优秀的三个进阶技巧6.1 用定时任务做货源过期自动下架农产品有采收日期如果一个货源发布超过一定时间还没成交应该自动下架避免买家看到过期的信息。用 Spring 的Scheduled注解就能实现不需要引入额外的调度框架。Component public class SupplyExpireTask { Autowired private SupplyMapper supplyMapper; Scheduled(cron 0 0 2 * * ?) public void expireSupply() { LocalDateTime expireTime LocalDateTime.now().minusDays(7); LambdaUpdateWrapperSupply wrapper new LambdaUpdateWrapper(); wrapper.eq(Supply::getStatus, 1) .lt(Supply::getCreateTime, expireTime) .set(Supply::getStatus, 0); supplyMapper.update(null, wrapper); } }这段代码每天凌晨两点执行一次把创建超过 7 天且还在上架状态的货源改成下架。cron表达式0 0 2 * * ?表示每天 2 点 0 分 0 秒。注意要在启动类上加EnableScheduling注解否则定时任务不生效。这个功能答辩时是一个很好的加分项说明你考虑了数据的时效性而不是只做了增删改查。6.2 用 Redis 缓存首页货源列表首页货源列表是访问最频繁的接口每次请求都查数据库压力大。毕业设计里引入 Redis 做缓存既能提升性能又能体现技术广度。用 Spring Cache 加 Redis 的实现最简单。Cacheable(value supply:list, key #page : #size) public PageResultSupplyVO listSupply(int page, int size) { PageSupply pageObj new Page(page, size); LambdaQueryWrapperSupply wrapper new LambdaQueryWrapper(); wrapper.eq(Supply::getStatus, 1) .orderByDesc(Supply::getCreateTime); supplyMapper.selectPage(pageObj, wrapper); return convertToVO(pageObj); }Cacheable注解会自动把结果缓存到 Rediskey 是supply:list:1:10这种格式。注意发布新货源或下架货源时要清除缓存用CacheEvict(value supply:list, allEntries true)。如果不想引入 Redis用本地ConcurrentHashMap做简单缓存也行但答辩时要说清楚本地缓存的局限比如多实例部署时缓存不一致。6.3 用接口文档工具让前后端联调不扯皮毕业设计如果是两个人做一个前端一个后端最容易出现的问题就是接口字段对不上。用 Swagger 或 Knife4j 自动生成接口文档后端改完代码文档自动更新前端直接看文档调接口。dependency groupIdcom.github.xiaoymin/groupId artifactIdknife4j-openapi2-spring-boot-starter/artifactId version4.4.0/version /dependency引入依赖后在application.yml里开启knife4j.enable: true启动项目访问http://localhost:8080/doc.html就能看到所有接口。Controller 上加Api和ApiOperation注解字段上加ApiModelProperty文档里就会显示字段说明。这个工具用起来不复杂但答辩时演示一下接口文档老师会觉得你的工程规范意识不错。注意版本号要跟 Spring Boot 版本匹配Spring Boot 2.x 用 knife4j-openapi2Spring Boot 3.x 用 knife4j-openapi3版本不匹配启动会报错。最后说一个我自己的习惯每次改完代码先本地跑一遍完整流程从登录、发布货源、下单、确认到完成走一遍再提交。毕业设计最怕的就是改了一个地方把另一个地方弄坏了自己还不知道。答辩前一周把数据库备份一份演示时如果数据被改乱了直接恢复备份重新来。希望帮到你。本文还有配套的精品资源点击获取