Java+SpringBoot农产品供销系统：从需求到答辩全流程实战-平芜编程栈

做毕设最怕的，不是没方向，而是方向太泛，功能做得像作业，答辩一问就露馅。今天聊一个很接地气的选题：Java+SpringBoot农产品供销服务系统。这名字听起来长，其实拆开就是农产品电商交易管理平台的Web版——农户/供应商发布农产品，消费者或采购商下单购买，管理员在后台上架审核、管理订单和数据。这题每年都有大量计算机专业学生选，因为业务链路清晰、技术栈主流、可扩展空间大，而且能同时覆盖前后端、数据库、权限、事务等核心考点，拿来写论文做系统都撑得住。

这篇不是给你贴个仓库地址就完事，而是从选题拆解、技术选型、数据库设计、核心代码实现到答辩坑位，完整走一遍我的实操思路。你照着做能省不少时间，更重要的是能讲清楚“为什么这么做”，答辩时不再只会念PPT。

1. 项目整体设计与思路拆解

1.1 需求分析：这个系统到底要解决什么

农产品供销平台的核心矛盾是信息不对称。一边是产地农户/合作社有货卖不出去，另一边是消费者/采购商找不到稳定货源，传统对接靠线下电话和熟人介绍。你要做的系统，本质上就是把“产销撮合、交易管理、数据沉淀”搬上Web。

所以需求不能只写“在线买东西”，而要分角色拆：

农户/供应商端：注册登录、维护店铺信息、发布农产品（名称、产地、品类、价格、库存、图片）、处理订单（发货）、查看结算记录。
采购商/消费者端：浏览商品、按品类或关键词搜索、加购物车、下单支付（模拟）、查看订单状态、确认收货。
管理员端：用户管理（审核/禁用账号）、商品审核（下架违规或过期商品）、订单管理（查看全部订单、处理纠纷/退款）、数据统计（销量排行、销售额报表）。
公共功能：登录注册（角色区分）、个人信息修改、密码加密存储。

功能模块划分成这四个方向后，系统边界就清楚了。不要一上来就加秒杀、优惠券、直播带货——毕设能稳稳跑完基础闭环，比堆砌没实现的功能强十倍。

1.2 技术方案选型：为什么主推SpringBoot

毕设选型要满足三个条件：上手快、资料多、能说出原理。SpringBoot恰好都占。

主框架：SpringBoot 2.7.x。为什么不建议3.x？因为很多网上的教程、依赖版本、MyBatis-Plus兼容性都基于2.x，用3.x容易踩到Jakarta命名空间迁移的坑，答辩前浪费时间不值当。版本高不一定好，稳定才是硬道理。
持久层：MyBatis-Plus。比原生MyBatis少写大量XML，内置分页插件、条件构造器，适合快速开发。如果你基础偏弱，MP是你最好的朋友。
前端：Thymeleaf模板引擎 + Bootstrap + 原生JS/JQuery。也可以用Vue前后端分离，但那样你要同时维护两套工程，部署还要处理跨域。学校机房电脑配置普遍一般，一个SpringBoot内嵌Thymeleaf的单体应用最省心，老师演示也顺滑。
数据库：MySQL 5.7/8.0。MySQL是主流，5.7资料最全，8.0功能更新点也可以吹。记住建库时统一用utf8mb4，不然中文乱码会烦死你。
构建工具：Maven。Java项目的标准配置，IDE导入即用。
服务器：SpringBoot内嵌Tomcat，打包成jar直接跑，不用单独装Tomcat。

这套组合的好处是：你的项目只需要一个Jar包和一个MySQL即可运行，部署简单到爆。而且SpringBoot自动配置降低了大量样板代码，你就有更多时间去打磨业务逻辑和文档。

1.3 角色权限设计：别再傻傻用拦截器写死

很多同学做权限时就爱在Controller里写if(user==admin)，这样改起来痛苦。正确做法是做基于角色的访问控制（RBAC），至少表结构要体现：

用户表（user）：包含username、password、role字段，role可以是0管理员/1供应商/2采购商。
或者更规范一点，加角色表、用户角色关联表，但现在题目规模下，单表role字段完全够。

然后利用SpringBoot的**拦截器（HandlerInterceptor）**统一做登录校验和角色校验。你自己定义一个@RequireRole注解，或者直接写拦截器匹配路径：

/admin/**需要role=0
/supplier/**需要role=1
/buyer/**需要role=2

这样Controller层不用每次判断角色，代码清爽，答辩时说你用了拦截器做统一认证，绝对加分。

2. 数据库设计：决定你后期改代码的次数

2.1 核心表结构与字段设计

数据库设计是毕设的重头戏，也是老师最爱问的地方。我这里给出一个经过验证的核心表清单，并解释关键字段意图：

表名	主要字段	关键说明
`user`	id, username, password, real_name, phone, role, status, create_time	status用于账号冻结/启用
`product`	id, supplier_id, name, category, origin, price, stock, unit, image, description, status, create_time	status: 0待审核 1上架 2下架/驳回；supplier_id关联用户表
`category`	id, name, parent_id	可选，做二级分类时用到
`cart_item`	id, buyer_id, product_id, quantity, checked	checked可选，用于购物车批量选中
`orders`	id, order_no, buyer_id, supplier_id, total_amount, status, receiver_name, receiver_phone, receiver_address, create_time, pay_time, ship_time, finish_time	订单号唯一，状态流转：待付款→待发货→待收货→已完成/已取消
`order_item`	id, order_id, product_id, product_name, price, quantity, subtotal	订单快照，删除商品也能保留历史订单
`supplier_settlement`	id, supplier_id, order_id, amount, status, settle_time	可选，供应商结算表

几个细节要注意：

金额用decimal(10,2)，不要用float/double，否则会产生精度误差，答辩现场容易被老师抓包。
订单快照字段不能省。order_item里冗余了product_name和price，这样即使商品后来改价或删除，订单历史也不会乱。这是电商系统的常规做法，说出去很专业。
订单号生成用时间戳+随机数，不要用自增id，因为自增id会暴露订单量，而且并发场景容易冲突。

2.2 表关系与事务边界

这部分容易被忽略，但答辩高频。让我把业务关系理一遍：

用户与商品：一对多（一个供应商发布多条商品）
用户与订单：买方向订单是一对多，卖方向订单也是一对多，所以orders表里同时有buyer_id和supplier_id
订单与订单项：一对多
购物车与商品：多对多，通过cart_item桥接

下单这个动作涉及多张表的修改，必须用事务。举一个典型的下单流程：

从购物车选中记录生成订单主表和订单明细表；
扣减product.stock；
清空购物车对应item；
如果库存不足，抛异常回滚。

我见过不少同学只做1和3，库存扣减放在前端传值直接update，结果并发一高就超卖。你只要在OrderService上加@Transactional，然后stock更新用UPDATE product SET stock = stock - #{num} WHERE id = #{id} AND stock >= #{num}，这种原子操作就把安全问题解决了。

3. 核心业务实现与实操过程

3.1 项目初始化和SpringBoot配置

用IDEA创建SpringBoot项目。依赖你至少需要这些：

<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-validation</artifactId> </dependency> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.3.1</version> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> </dependencies>

application.yml里最容易被坑的几个点：

server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/agri_market?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0

注意serverTimezone=Asia/Shanghai，不加的话在旧版驱动下会报错。map-underscore-to-camel-case必须设为true，这样数据库字段create_time才能自动映射到createTime属性。逻辑删除字段看个人需求，不建议一开始就加，先保证核心流程跑通。

3.2 登录鉴权与拦截器实战

密码不能用明文存，至少用BCrypt哈希。Spring Security全家桶对毕设来说太重，其实我们可以只引入spring-security-crypto一个依赖，或者自己用BCryptPasswordEncoder。

可以用JWT做无状态登录，也可以用Session。毕设用Session更简单直观，毕竟Thymeleaf服务端渲染为主。思路：

登录接口验证用户名密码；
成功后把user对象放入session；
自定义LoginInterceptor：
- preHandle里判断session里有没有user，没有就重定向到登录页；
- 根据请求路径前缀校验role，不符合返回403页面。

一个简化版拦截器核心代码：

public class AuthInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { User user = (User) request.getSession().getAttribute("user"); if (user == null) { response.sendRedirect("/login"); return false; } String uri = request.getRequestURI(); if (uri.startsWith("/admin") && user.getRole() != 0) { response.setStatus(403); return false; } if (uri.startsWith("/supplier") && user.getRole() != 1) { response.setStatus(403); return false; } return true; } }

然后在配置类里注册：

@Configuration public class WebConfig implements WebMvcConfigurer { @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new AuthInterceptor()) .addPathPatterns("/**") .excludePathPatterns("/login", "/register", "/css/**", "/js/**", "/images/**", "/product/list"); } }

这样写非常清晰，答辩时老师问权限控制怎么做的，你就可以把这个逻辑捋一遍。

3.3 商品发布与订单流转的实现要点

商品发布流程：供应商提交表单 -> 商品status为0 -> 管理员在后台审核通过后status=1。这个审核环节是很多同学忽略的，加上之后系统显得更完整，有业务深度。

关于图片上传，建议别用本地路径，可以接入OSS/MinIO之类的对象存储，或者最省事用Base64存到数据库（但别存大图，很吃数据库性能）。考虑到毕设演示环境，本地磁盘保存也行，但你一定要处理静态资源映射：

spring: web: resources: static-locations: classpath:/static/,file:./upload/

否则上传的图片刷新后显示不出来，别问我怎么知道的。

订单状态机是业务大头。我建议定义一个状态枚举：

public enum OrderStatus { UNPAID(0, "待付款"), PAID(1, "待发货"), SHIPPED(2, "待收货"), COMPLETED(3, "已完成"), CANCELLED(4, "已取消"); }

每次状态变更都检查前置状态，比如只有UNPAID才能取消，只有PAID才能发货，防止乱跳。前端页面按钮按状态控制显隐，后端接口再校验一遍，双保险。

下单的Service方法必须加@Transactional，上面已经说过了。另外，下完单把购物车清掉后，回显的订单详情页所有信息从orders和order_item查，不要依赖前端传参，防止用户篡改。

4. 常见问题与排查技巧实录

4.1 Maven依赖冲突与版本坑

这是最容易劝退新手的环节。常见异常：

Failed to configure a DataSource：启动直接报错，常见原因是application.yml里datasource地址写错，或驱动没引对。MySQL8以上用com.mysql.cj.jdbc.Driver，MySQL5.x用com.mysql.jdbc.Driver。
ClassNotFoundException: jakarta.servlet.*：你很可能用了SpringBoot 3.x但依赖的还是旧包。这是Jakarta改名坑，建议直接退回SpringBoot 2.7。
mybatis-plus和spring-boot版本不兼容：用MP 3.5.3.1配Boot 2.7实测没问题。

排查姿势：先看红色报错最底部，是Caused by那一行才是指向根因。把鼠标移到IDEA红色波浪线上看提示，再不行就mvn clean compile看详细输出。别上来就百度，很多报错百度出来的答案满天飞但你项目环境不一样，反而越改越乱。

我自己的排查顺序是：先看配置文件，再看pom依赖，最后看数据库连接。因为60%的问题都是这三类。

4.2 前端页面和后端联调时反复出现的三个问题

第一，页面提交form表单到Controller后跳转404。大概率是Controller方法上的@RequestMapping写错，或者返回视图路径和模板文件名对不上。Thymeleaf默认前缀是classpath:/templates/，后缀是.html，你return "admin/product/list"，就得有templates/admin/product/list.html，目录不能少。

第二，Ajax请求拿不到对象。Controller方法没加@ResponseBody，或者类上没加@RestController，Spring把它按视图解析器处理，返回了一串奇怪内容。推荐你统一用@ResponseBody+ 封装好的Result对象，前端响应体就是JSON，好调试。

第三，图片/静态资源加载不出来。检查刚才说的static-locations，以及你的页面引用路径开头是否带/，用了相对路径在深层路由下很容易挂。

4.3 数据一致性：并发和超卖问题

毕设虽然不在乎高并发，但是老师会问你想过没有。订单超卖的经典解法是乐观锁或悲观锁。最简单的实现是给商品表加版本号字段version，更新时带上：

UPDATE product SET stock = stock - #{num}, version = version + 1 WHERE id = #{id} AND stock >= #{num}

这条语句本身就是原子的，它同时完成了库存校验和扣减，不需要额外同步锁。这个点你写在论文里，能显示出你有过思考，加分。

另外，用户下单后未支付订单，超时自动关闭这种功能在毕设里可以做，但优先级不高。如果你时间有限，把状态机跑顺考研，比画蛇添足做一堆不稳定的定时任务强。

5. 部署上线与演示准备

5.1 打包与运行

SpringBoot项目用Maven打包超级简单：

mvn clean package -DskipTests

打包完在target/下生成jar文件，然后：

java -jar agri-market-0.0.1.jar

如果出现端口占用，用server.port重新指定端口即可。

数据库导入：我习惯用数据库工具（Navicat/DataGrip）导出SQL脚本，交作业/备份时把agri_market.sql一并放上。注意导出时要包含数据，不要只导表结构，不然老师一运行看到空页面还以为你系统炸了。

建议再多造一点演示数据：10个供应商、20条商品、几个不同状态的订单、一些销售图表数据。演示的时候数据越真实，越有说服力。比如在商品表里加“章丘大葱”“烟台苹果”“洛川苹果”这些地理标志产品，比“苹果1号”“苹果2号”专业太多。

5.2 演示前必须自测的流程清单

血泪教训啊，上演示台之前一定要把以下路径走一遍：

注册三个账号（管理员、供应商、采购商）；
供应商登录，发布一条商品，上传图片；
管理员登录，审核通过该商品；
退出登录，采购商登录，搜索“苹果”，加购物车，下单，模拟支付；
切换供应商账号，看到新订单，发货；
切回采购商账号，确认收货；
管理员后台查看订单状态、查看统计报表。

这几步5分钟走完，只要没有断点，你答辩时基本稳了。很多同学只测了后端接口，没测完整业务流，结果现场演示时卡在“供应商怎么看不到订单”这种基础问题上。

5.3 答辩高频问题应对

老师大概率会问四个问题：

“为什么用MyBatis-Plus不用JPA？”你可以答：毕设偏重业务快速开发和灵活SQL控制，MP在分页、条件查询上更直观，而且社区中文资料多，遇到问题容易解决。如果你用了JPA，那就说它的ORM能力强、面向对象；总之要自圆其说。
“怎么保证订单和库存一致？”答：事务+原子SQL。讲清楚@Transactional和乐观锁思想。
“系统能支持多少并发？”不吹牛，直接说单体应用、内置Tomcat默认200线程，适合中小规模农贸平台，如果要做大可以引入Redis缓存、MQ削峰、服务拆分。这一套话术显得你有扩展视野。
“你自己觉得不足有哪些？”别只说没有不足，太假。可以说：“目前模拟支付，实际对接微信/支付宝需要加API；图片存储用本地路径，生产应该用对象存储；数据量大了之后可以加Redis做缓存。”这些是真实且合理的改进空间。