SSM农产品小程序毕设实战：农户直发+用户下单+后台统管闭环

简介这是一套面向计算机专业本科生的毕业设计级实战项目基于微信小程序与Java后端构建农产品自主供销平台适用于课程设计、毕设选题及全栈开发能力训练。系统采用SSM框架与MySQL数据库完整实现管理员、普通用户、农户三类角色的差异化权限管理覆盖农产品发布、购物车下单、咨询互动、订单跟踪等核心业务闭环具备真实电商场景的工程实践价值。资源包共1400个文件含136个Java后端逻辑文件、199个JS前端交互脚本、148个Vue组件、319个PNG界面素材及96个WXML页面结构文件辅以SQL建表语句、BAT一键部署脚本和多套Vue/Bak备份组件总大小13.35MB目录结构规范模块边界清晰。目前已有179人学习下载提供开箱即用的源码、可运行数据库及详细说明文档助读者快速理解前后端协同逻辑、权限控制实现方式与小程序工程化组织模式。1. 农产品自主供销小程序一个能跑通「农户直发→用户下单→后台统管」闭环的毕业设计实战包你是不是也见过那种“毕设商城系统”——首页能点商品页能进但一加购物车就报错登录后个人中心空白后台管理界面点啥都 404这个基于微信小程序 JavaSSM的农产品自主供销系统不是 Demo 级别玩具它是一套真实可部署、角色权限完整、前后端分离清晰、数据库字段有业务语义、连 .bak 文件都留着修改痕迹的落地型毕业设计资源。它解决的不是“怎么写 Hello World”而是“如何让一个县城合作社的农户用手机上架滞销红薯、城里用户扫码下单、管理员在后台看到实时订单流并导出 Excel 发货单”这种颗粒度的问题。技术栈锁定在微信开发者工具 JavaSpring SpringMVC MyBatis MySQL不碰云开发、不依赖第三方 BaaS所有接口自己写、所有 SQL 自己审、所有权限校验自己拦——这意味着你能把它拆开、改透、甚至迁移到学校实训机房那台老版 Tomcat 上跑起来。适合正在赶毕设 deadline 的本科生、需要课程设计参考代码的专科生以及想用真实业务场景练手 SSM 权限模型的初阶 Java 开发者。它不炫技但每一步都踩在教学大纲和企业初级岗的真实要求上。2. 项目结构与技术选型为什么是 SSM 而不是 Spring Boot为什么小程序前端要保留 .bak 文件2.1 整体分层逻辑从微信小程序到 MySQL 的数据流向这个项目严格遵循“表现层小程序→ 接口层Java Web→ 服务层Service→ 持久层MyBatis→ 数据层MySQL”五层结构。小程序端通过wx.request调用 Java 后端提供的 RESTful 接口如/api/product/list,/api/order/create所有请求统一走LoginInterceptor拦截器做 token 校验后端 Controller 层只做参数接收与响应封装业务逻辑全部下沉到 ServiceImplDAO 层由 MyBatis Generator 自动生成基础 CRUD 方法再手动补充多表关联查询比如农户发布的产品需关联分类名和库存状态。数据库设计上user表用role_type字段区分admin/customer/farmer三类角色而非建三张独立用户表——这是 SSM 项目里最常见也最稳妥的 RBAC 实现方式既避免冗余又方便后期扩展。整个链路没有中间件、不引入 Redis 缓存所有状态靠 session 和数据库字段维护对毕设答辩和本地调试极其友好。2.2 SSM 选型的现实考量兼容性、可控性与教学对齐为什么不用更热门的 Spring Boot答案很实在学校服务器环境老旧、Tomcat 版本卡在 7.x、JDK 停留在 1.8、老师批注习惯看web.xml配置。这个项目pom.xml中明确限定spring.version4.3.29.RELEASEmybatis-spring1.3.2mysql-connector-java5.1.47所有依赖版本号都经得起mvn dependency:tree -Dverbose检查。web.xml里清晰写着ContextLoaderListener加载 Spring 容器、DispatcherServlet分发请求、CharacterEncodingFilter解决中文乱码——这些不是过时配置而是让你能对着《Java Web 开发实战》教材第 7 章逐行比对的“教科书级实现”。当你在答辩现场被问“拦截器怎么生效的”你可以直接打开spring-mvc.xml指着mvc:interceptors标签回答当导师说“把登录改成手机号验证码”你清楚知道该去改LoginController的loginByPhone()方法而不是在 Spring Boot 的ConfigurationProperties里迷路。2.3 小程序源码里的 .bak 文件这不是垃圾是修改轨迹的证据你看到的IndexMain.vue.bak、main.css.bak并非误打包残留。它们是开发者在迭代过程中留下的“快照”比如IndexMain.vue.bak是首页轮播图未接入 API 前的静态版本main.css.bak记录了从 Bootstrap 样式迁移到自定义 Flex 布局前的旧规则。这说明两点第一项目经历过真实需求变更比如初期只做展示后期追加农户发布功能第二所有样式和组件改动都有据可查。实际开发中你应该先对比.bak和当前文件差异再决定是否覆盖——例如update-password.vue.bak里保留了原始密码强度校验正则/^(?.*[a-z])(?.*[A-Z])(?.*\d)[a-zA-Z\d]{8,}$/而新版update-password.vue已简化为长度判断若你学校要求强密码策略直接复制正则即可复用。提示.bak文件是调试线索不是必须删除的对象。很多同学删掉后发现某页面样式错乱回头再找原作者要备份反而耽误时间。3. 快速启动三步法从解压到首页渲染绕过 90% 的环境陷阱3.1 后端部署用 1-install.bat 和 2-run.bat 控制 Tomcat 生命周期项目根目录下三个.bat文件是关键入口1-install.bat自动执行mvn clean compile package生成target/xxx.war并拷贝到tomcat/webapps/下路径已硬编码需按你本地 Tomcat 路径修改2-run.bat调用tomcat/bin/startup.bat启动服务同时监听8080端口3-build.bat仅执行mvn clean compile用于快速验证 Java 代码语法。实操步骤# 第一步修改 1-install.bat 中的 TOMCAT_PATH set TOMCAT_PATHD:\apache-tomcat-7.0.96 # 第二步双击运行 1-install.bat确保 Maven 已配好环境变量 # 第三步检查 D:\apache-tomcat-7.0.96\webapps\ 下是否生成 xxx.war 及解压后的文件夹 # 第四步双击 2-run.bat等待控制台输出 Server startup in XXX ms启动成功后浏览器访问http://localhost:8080/xxx/login应返回登录页 HTML。若报 404请立即检查webapps/xxx/WEB-INF/web.xml中servlet-mapping的url-pattern是否为/api/*该项目统一前缀并确认xxx是你 war 包实际名称默认为项目名可改pom.xml中finalName。3.2 小程序端配置替换 request 域名与接口前缀微信开发者工具导入项目后必须修改两处才能连通后端打开utils/request.js找到BASE_URL常量// utils/request.js const BASE_URL http://localhost:8080/xxx/api // ← 改为你自己的地址在app.js的onLaunch中检查wx.setStorageSync(token, ...)是否被注释——该项目使用 session-based 认证首次登录后将JSESSIONID存入 storage后续请求自动携带 Cookie无需手动传 token。注意微信开发者工具默认不允许http请求需在「详情 → 本地设置」中勾选「不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」。这是开发阶段合理配置非线上漏洞。3.3 数据库初始化用 sql 文件一键建库建表但必须改字符集项目附带的database.sql文件包含完整建表语句但存在一个致命细节所有CREATE TABLE语句末尾缺少DEFAULT CHARSETutf8mb4 COLLATEutf8mb4_unicode_ci。若你用 MySQL 5.7 默认安装执行后中文会显示为???。正确做法是全局替换-- 将 sql 文件中所有 ) ENGINEInnoDB; -- 替换为 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COLLATEutf8mb4_unicode_ci;然后在 MySQL 命令行执行CREATE DATABASE IF NOT EXISTS farm_supply DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci; USE farm_supply; SOURCE D:/path/to/database.sql; -- 替换为你的实际路径执行完毕后检查user表中username字段类型应为varchar(50)而非textproduct表中description字段长度应为text支持长文本这是业务必需。4. 权限系统落地细节三类角色如何共用一张 user 表却互不越权4.1 用户表设计role_type 字段的业务语义与校验边界user表核心字段如下摘自database.sql字段名类型允许空注释idbigint PKNOT NULL主键usernamevarchar(50)NOT NULL登录账号passwordvarchar(100)NOT NULLBCrypt 加密后密码role_typetinyintNOT NULL1管理员, 2用户, 3农户phonevarchar(20)NULL手机号用户/农户必填real_namevarchar(20)NULL真实姓名农户需实名关键点在于role_type不是枚举字符串而是整型原因有三① 减少存储空间1 字节 vs 最少 6 字节② 方便 SQL 查询WHERE role_type IN (2,3)获取所有终端用户③ 避免因大小写或空格导致的字符串匹配失败如farmervsFarmer。后端校验逻辑在LoginService.java中体现// LoginService.java public User login(String username, String password) { User user userMapper.selectByUsername(username); if (user null || !BCrypt.checkpw(password, user.getPassword())) { throw new ServiceException(用户名或密码错误); } // 角色合法性二次校验防数据库被篡改 if (!Arrays.asList(1, 2, 3).contains(user.getRoleType())) { throw new ServiceException(用户角色异常请联系管理员); } return user; }4.2 前端路由守卫如何让农户看不到“用户管理”菜单小程序端权限控制分两层第一层菜单动态渲染app.js中globalData.roleType存储登录后角色components/IndexAsideStatic.vue根据其值过滤菜单项!-- IndexAsideStatic.vue -- view v-formenu in filteredMenus :keymenu.id navigator url{{menu.url}} hover-classnone{{menu.name}}/navigator /view // computed 过滤逻辑 computed: { filteredMenus() { const role getApp().globalData.roleType; if (role 1) return this.allMenus; // 管理员看全部 if (role 2) return this.customerMenus; // 用户只看商品/订单 if (role 3) return this.farmerMenus; // 农户只看发布/订单 } }第二层按钮级显隐控制在pages/product/list.vue中农户可点击“发布商品”普通用户不可见view wx:if{{roleType 3}} button bindtapgotoAddProduct发布新商品/button /view4.3 后端接口鉴权RequiresRoles 注解失效时的兜底方案项目使用 Shiro 做权限框架Controller 方法上标注RequiresRoles(admin)。但 Shiro 配置在shiro-config.xml中若你删了某个 bean 导致注解失效所有接口将失去保护。因此必须添加代码级兜底// ProductController.java PostMapping(/create) RequiresRoles(farmer) public Result create(RequestBody Product product, HttpServletRequest request) { // 兜底校验从 session 取用户强制比对角色 User user (User) SecurityUtils.getSubject().getPrincipal(); if (user.getRoleType() ! 3) { return Result.fail(无权操作仅农户可发布商品); } // ... 业务逻辑 }这种“注解 代码双重校验”是毕设项目防答辩翻车的核心技巧——评委随便删一行配置系统依然安全。5. 避坑指南那些让答辩前夜崩溃的 5 个真实问题与血泪解法5.1 现象小程序登录后跳转首页但顶部导航栏显示“未登录”个人中心头像为空原因app.js中onLaunch未正确读取wx.getStorageSync(userInfo)或后端返回的userInfo对象缺少avatarUrl字段数据库user表该字段允许 NULL但前端image组件 src 不能为空字符串。解决① 检查app.js的onLaunch是否调用wx.getUserProfile获取头像该项目未强制获取故需设默认值② 在pages/index/index.js的onLoad中添加兜底逻辑onLoad() { const userInfo wx.getStorageSync(userInfo) || {}; this.setData({ userInfo: { ...userInfo, avatarUrl: userInfo.avatarUrl || /static/avatar-default.png // 设默认头像 } }); }5.2 现象农户发布商品时上传图片后端报org.springframework.web.multipart.MultipartException: Could not parse multipart servlet request原因spring-mvc.xml中CommonsMultipartResolverbean 配置缺失或maxUploadSize过小默认 1MB而农户拍的农产品图常超 2MB。解决在spring-mvc.xml中添加或修改bean idmultipartResolver classorg.springframework.web.multipart.commons.CommonsMultipartResolver property namemaxUploadSize value10485760/ !-- 10MB -- property namedefaultEncoding valueUTF-8/ /bean并确认pom.xml引入commons-fileupload依赖dependency groupIdcommons-fileupload/groupId artifactIdcommons-fileupload/artifactId version1.3.3/version /dependency5.3 现象管理员后台“产品分类管理”新增分类后小程序端商品列表仍显示旧分类原因MyBatis 二级缓存开启且未及时刷新CategoryMapper.xml中cache /标签存在但新增分类后未调用categoryMapper.clearCache()。解决① 临时方案在CategoryService.java的addCategory()方法末尾添加CacheEvict(value categoryCache, allEntries true) public void addCategory(Category category) { ... }② 彻底方案删除CategoryMapper.xml中cache /标签改用数据库层面一致性适合毕设避免缓存复杂度。5.4 现象MySQL 执行database.sql报错ERROR 1071 (42000): Specified key was too long原因user.username字段为varchar(50)但 MySQL 5.7 默认innodb_large_prefixOFFutf8mb4 下单字符占 4 字节50×4200 767 字节限制。解决① 修改 MySQL 配置文件my.ini在[mysqld]下添加innodb_file_formatBarracuda innodb_file_per_tableON innodb_large_prefixON② 重启 MySQL并为表指定ROW_FORMATDYNAMICALTER TABLE user ROW_FORMATDYNAMIC;5.5 现象2-run.bat启动后 Tomcat 日志报java.lang.ClassNotFoundException: org.springframework.web.servlet.DispatcherServlet原因pom.xml中spring-webmvc依赖 scope 误设为test导致打包时未打入WEB-INF/lib/。解决检查pom.xml确保dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version${spring.version}/version !-- 删除 scopetest 或改为 compile -- /dependency然后重新运行1-install.bat。6. 进阶技巧如何把这套代码改造成“可演示、可答辩、可延展”的高分作品6.1 答辩演示必备三分钟流畅走通“农户上架→用户下单→管理员发货”全链路答辩时评委最关注“能不能跑”而非“写了多少行”。我建议你固化一套演示脚本全程不卡顿农户端微信开发者工具用测试账号farmer001 / 123456登录 → 进入「农产品管理」→ 点「发布」→ 选一张本地萝卜图 → 填名称“有机红心萝卜”、价格“8.5”、库存“100” → 提交成功用户端同一台电脑开另一个开发者工具实例用user001 / 123456登录 → 首页搜索“萝卜” → 点击商品 → 加入购物车 → 去结算 → 选择“在线支付”模拟→ 提交订单管理员端浏览器访问http://localhost:8080/xxx/admin用admin / 123456登录 → 左侧点「订单管理」→ 右上角「待发货」筛选 → 找到刚下的单 → 点「发货」→ 填快递单号“SF123456789” → 保存。关键点所有操作必须在 3 分钟内完成因此你要提前在数据库order表中将status字段设为1待付款、2待发货、3已发货的枚举值并在OrderController.java中确保updateStatus()方法能正确更新。这样演示时点一下就变状态毫无破绽。6.2 毕设加分项给系统加上“农产品溯源”模块50 行代码搞定评委喜欢“有业务深度”的改造。农产品溯源本质是记录“谁在何时何地做了何事”我们复用现有表结构只需加一张trace_log表和两个接口-- 新增溯源日志表 CREATE TABLE trace_log ( id BIGINT PRIMARY KEY AUTO_INCREMENT, product_id BIGINT NOT NULL COMMENT 关联农产品ID, operator_type TINYINT NOT NULL COMMENT 1农户,2管理员, operator_id BIGINT NOT NULL COMMENT 操作人ID, action VARCHAR(50) NOT NULL COMMENT 动作上架/质检/发货, remark TEXT COMMENT 备注, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;然后在ProductService.java的publishProduct()方法末尾插入日志// 记录上架日志 TraceLog log new TraceLog(); log.setProductId(product.getId()); log.setOperatorType(3); // 农户 log.setOperatorId(user.getId()); log.setAction(上架); log.setRemark(产地XX县检测报告编号NO2023001); traceLogMapper.insert(log);小程序端在商品详情页加一个「查看溯源」按钮调用/api/trace/list?productId123即可拉取时间线。这 50 行代码能让评委眼前一亮——你不是在堆功能而是在解业务题。6.3 从毕设到真项目迁移 Spring Boot 的最小改动清单如果未来想升级技术栈不必重写。我整理了迁移 Spring Boot 的 7 个必改点已验证可行文件/位置原内容Spring Boot 替代方案备注pom.xmlspring-webmvc,mybatis等独立依赖改用spring-boot-starter-web,mybatis-spring-boot-starter版本由 parent 管理web.xmllistener,servlet配置全部删除用SpringBootApplication启动类spring-mvc.xmlmvc:annotation-driven等删除配置写application.yml如spring.mvc.static-path-pattern/static/**jdbc.properties数据库连接配置移至application.yml的spring.datasource.*ShiroConfig.javaShiro Bean 配置改用ShiroAutoConfiguration 自定义 Realm需重写doGetAuthorizationInfolog4j.xmlLog4j 配置改用logback-spring.xml更现代的日志控制1-install.batMaven 打 war改用mvn spring-boot:repackage打 jar内嵌 Tomcat一键运行从那以后我每次接手毕设项目都会先跑一遍mvn dependency:tree看依赖冲突再打开database.sql检查字符集最后用 Postman 测通 3 个核心接口登录、商品列表、订单创建——这三步做完80% 的环境问题和逻辑断点就暴露了。希望帮到你。本文还有配套的精品资源点击获取