Java毕业设计实战：基于Spring Boot+Vue的农产品商城系统设计与部署

简介：面向计算机相关专业学生的Java毕业设计源码，以农产品网站为主题，开发环境采用JDK 1.8与MySQL 5.7及以上版本，完整前后端覆盖基础信息管理、农产品展示、网上购物和用户管理四大核心模块，适合毕业设计或课程设计参考。整包共300个文件，约25.35MB，包含97个Java核心业务源码、23个JSP页面、33个CSS与29个JS前端资源，以及1份SQL数据库脚本，目前已有28人学习下载。压缩包内同步提供说明文档、LW论文、演示录像和需求分析文件，涵盖需求分析、系统架构、功能模块划分与代码实现说明，配合演示录像可直观了解界面与操作流程，适合希望借鉴完整毕设项目或系统学习Java Web开发的同学。

1. 农产品网站设计与开发源码：毕业设计最稳妥的选题方向

java毕业设计选“农产品网站”，是一个很稳的题目。同样叫商城系统，生鲜电商、特产商城、农产品直卖网，换一个业务名词就能避开烂大街的“图书商城”“零食商城”；同时它的功能骨架仍然是商品、购物车、订单、后台管理，复杂度恰好卡在本科毕设评审老师最舒服的位置——既能看到工作量，又不至于做出一个几个月都跑不通的分布式系统。标题里写着“完整前后端+说明文档+LW”，对应的就是毕业设计最需要的三样东西：能启动的源代码、能照着改的环境说明、能提交的论文文稿。这篇文章不讲概念，直接按“这是个什么东西、怎么跑起来、改哪里、有什么坑、怎么部署”的顺序，把这条主流程走完。

2. 技术选型与功能边界：为什么这套源码用 Spring Boot + Vue 前后端分离

现在打开十个 java 毕业设计源码，有八个是 Spring Boot 做后端、Vue 做前端，剩下两个是若依这类脚手架改的。农产品网站选择前后端分离不是跟风，而是因为它能在一套项目里同时展示控制层、业务层、持久层、前端组件、接口调用、权限控制这些知识点，答辩时每一个模块都能单独拿出来讲。更重要的是，分离式项目本地开发和后期部署路径非常清晰，后端打包一个 jar，前端打包静态文件，丢到服务器上用 nginx 一带，整个前后端分离项目实战链路就闭环了。

2.1 功能模块拆解：用户端、商家端、管理后台各管什么

这套农产品网站的核心业务不是“展示农产品信息”，而是“能把农产品买走”。所以功能设计要遵守一个原则：不要堆功能。很多源码会在首页加轮播图、公告、限时秒杀、积分商城、评论、收藏、优惠券……哪怕代码写得再乱也能跑，但论文里根本写不透，答辩时一问细节就露馅。

标准做法是把系统分成三个视角。用户端：注册登录、按分类浏览商品、关键字搜索、商品详情、加入购物车、下单、模拟支付、查看个人订单列表。管理员端：商品分类管理、商品上/下架、库存修改、订单发货、公告管理。第三视角是商家端，很多毕业设计会把用户端和管理端写在一个项目里，管理员直接兼任商家；如果源码里单独拆了商家端，那就在用户表里用一个 role 字段区分“普通用户”和“商家”，权限控制集中在后端的拦截器或 AOP 层处理，而不是每个接口手动判断。

功能边界划定后，数据库表和接口数量基本就定了。用户、商品、分类、购物车、订单、订单明细、公告，七张表足够撑起整个系统。再多就是锦上添花，再少就不够写论文。做课设的同学可以在这个范围里加一个“收货地址”表，半个月的工期刚好兜住。

2.2 数据库表怎么设计：从商品、分类到订单的 7 张核心表

数据库设计是评审老师最常翻的一页，也是源码里最容易看出是否用心的地方。农产品网站的表结构不需要多复杂，但字段类型、索引、字符集这些细节必须经得起问。下面这两个建表语句是这套系统里最有代表性的两张表。

CREATE TABLE `product` ( `id` int NOT NULL AUTO_INCREMENT, `category_id` int NOT NULL COMMENT '分类id', `name` varchar(100) NOT NULL COMMENT '商品名称', `main_image` varchar(255) DEFAULT NULL COMMENT '主图URL', `detail` text COMMENT '商品详情', `price` decimal(10,2) NOT NULL COMMENT '单价', `stock` int NOT NULL DEFAULT 0 COMMENT '库存', `sales` int NOT NULL DEFAULT 0 COMMENT '销量', `status` tinyint NOT NULL DEFAULT 1 COMMENT '1上架 0下架', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), KEY `idx_category` (`category_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

商品表把价格定为 decimal(10,2) 而不是 double，这一点可以在答辩时重点讲。金额用浮点数会在累加和比较时出现精度误差，农产品客单价虽然不高，但订单总额涉及支付，精度问题一旦出现就是玄学，论文里写“采用 decimal 保证金额精度”是一句很加分的说明。商品表里 status 字段用来做上架和下架，不要真的删除数据，否则订单明细关联不到商品名。

CREATE TABLE `orders` ( `id` int NOT NULL AUTO_INCREMENT, `order_no` varchar(32) NOT NULL COMMENT '订单号', `user_id` int NOT NULL, `total_amount` decimal(10,2) NOT NULL, `status` tinyint NOT NULL DEFAULT 0 COMMENT '0待支付 1待发货 2待收货 3已完成 4已取消', `receiver_name` varchar(50) DEFAULT NULL, `receiver_phone` varchar(20) DEFAULT NULL, `receiver_address` varchar(255) DEFAULT NULL, `create_time` datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_order_no` (`order_no`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

订单表表名用orders而不是order，因为 order 是 SQL 关键字。订单号用唯一索引约束，前端展示用订单号而不是自增 id，否则用户能看到平台一天有多少单，也容易被人遍历接口。状态字段用 tinyint 加注释，比直接存字符串“待支付”要规范得多，Java 侧再用一个常量类把这些状态值定义出来，后面所有业务逻辑都引用常量而不写魔法数字。

2.3 前后端交互约定：接口返回的 JSON 格式和状态码

前后端分离项目里，代码能不能顺利跑起来，关键在于前后端对接口返回格式的理解是否一致。这套系统的常见做法是定义统一返回体Result<T>，所有接口都返回{ code, msg, data }三层结构，前端 axios 拦截器只判断一次 code，就能处理成功、未登录、参数错误、系统异常这些情况。

public class Result<T> { private Integer code; private String msg; private T data; public static <T> Result<T> ok(T data) { Result<T> r = new Result<>(); r.setCode(200); r.setMsg("操作成功"); r.setData(data); return r; } public static <T> Result<T> error(Integer code, String msg) { Result<T> r = new Result<>(); r.setCode(code); r.setMsg(msg); return r; } }

Result类的核心是固定字段顺序和类型。前端拿到响应后，如果code是 401，就清理本地 token 并跳转登录页；如果是 200，就取data渲染页面。有的源码会把code叫status，把msg叫message，这都无所谓，但全项目必须统一。拿到源码的第一件事，就是全局搜索Result或ResponseResult，确认这个统一返回体存在，再去看 controller 层是否都通过它返回，这决定了你改接口时会不会到处收到“响应解析失败”的报错。

3. 本地跑通完整源码：从 JDK 配置到浏览器看到首页

很多同学拿到源码后第一反应是双击运行，结果五分钟内被各种红字劝退。说实话，java毕业设计九成跑不起来的项目，根源都不是源码坏了，而是本地环境跟项目不匹配。这一章直接给出可复现的启动路径，每一处都说明为什么这样做，避免你卡在“明明一模一样为什么我还是错”的泥潭里。

3.1 环境版本对照：JDK、Maven、Node、MySQL 怎么配才不玄学

先看源码里的说明文档，确认它基于 Spring Boot 还是 Spring Boot 3。常见情况是 Spring Boot 2.x 配 JDK 8，Spring Boot 3 配 JDK 17。如果说明文档丢失，可以用文本编辑器打开 pom.xml，看spring-boot-starter-parent的版本号第一段是 2 还是 3，这比盲猜靠谱得多。

JDK 安装完成后，网上搜“java环境变量配置”能看到一堆长篇截图，但核心只有JAVA_HOME和Path两处。配好后新开一个命令行窗口验证，而不是在当前窗口反复敲命令。

java -version mvn -v node -v npm -v

四条命令都能输出版本号，环境才算就绪。常见问题是命令行里敲java有反应，但 IDEA 里提示找不到 JDK，这是因为 IDEA 使用自己的 JDK 配置，需要在项目结构里手动指向安装目录，不要只依赖系统环境变量。

3.2 数据库初始化：建库、导入 SQL、同步连接配置

后端启动前必须先有数据库，否则 Spring Boot 一启动就报数据库连接失败。在命令行进入 MySQL：

mysql -uroot -p CREATE DATABASE farm_shop DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE farm_shop; SOURCE /your/path/farm_shop.sql;

SOURCE后面要写 SQL 文件的绝对路径，路径里不要有中文和空格。如果 SQL 脚本开头已经包含CREATE DATABASE语句，可以跳过手动建库这一步，直接进入 farm_shop 后执行SOURCE。导入成功后执行SHOW TABLES;，看到 product、orders 这些表名，数据库才算准备好。

接下来打开后端的application.yml，把数据库账号密码改成你自己的。这里最容易踩的坑是时区和字符集参数：

spring: datasource: url: jdbc:mysql://localhost:3306/farm_shop?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 换成你的密码 driver-class-name: com.mysql.cj.jdbc.Driver

MySQL 8.0 的驱动类名是com.mysql.cj.jdbc.Driver，MySQL 5.7 也可以用它。serverTimezone不设置，JDBC 驱动会拿服务器默认时区去解析，本地没配过时区就会报 CST 相关的异常，这是很多源码本地跑不起来的常见原因。

3.3 后端启动步骤：Maven 编译和 Spring Boot 主类

打开命令行，进入后端目录后执行：

mvn clean install -DskipTests mvn spring-boot:run

第一次执行会把项目依赖下载到本地仓库，这个过程非常考验网络。Maven 中央仓库下载慢是常态，虽然不是代码问题，但卡在下载上确实容易让人心态崩掉。提前在 Maven 的settings.xml里配置阿里云镜像：

<mirror> <id>aliyunmaven</id> <mirrorOf>central</mirrorOf> <url>https://maven.aliyun.com/repository/public</url> </mirror>

配好镜像后重新执行mvn spring-boot:run，看到日志里出现Tomcat started on port(s): 8080说明后端已经起来了。如果源码里有测试类，-DskipTests可以跳过单测，避免因为测试类连不上测试库导致构建失败。

3.4 前端启动步骤：npm install 和接口转发配置

前端的入口目录一般是frontend或web，进入后先执行npm install，安装时间取决于网络。npm 官方源在国内同样慢，可以临时换成淘宝镜像：

npm install --registry=https://registry.npmmirror.com

安装完成后开发模式启动：

npm run dev

Vue 项目默认端口是 8080 或 5173，如果和后端端口冲突，前端会提示重新选端口。更关键的是前端请求如何找到后端。项目根目录下的vue.config.js或vite.config.js里通常配置了接口转发：

module.exports = { devServer: { port: 3000, proxy: { '/api': { target: 'http://localhost:8080', changeOrigin: true } } } };

这段配置的意思是：浏览器发往/api开头的请求，由前端开发服务器转发到http://localhost:8080。这样浏览器没有跨域问题，后端也不需要写一堆跨域过滤器。修改这个配置文件后必须重启npm run dev，热更新不会重新加载转发配置。

4. 二次开发必看的核心代码：登录、搜索、订单状态机

源码跑通只是第一步，毕业设计终归要体现“我改过、我懂”。评审老师不会去追查每一行代码是谁写的，但会挑几个核心功能让你当场讲实现。这一章挑三个最容易被问到的点，讲清楚代码长什么样、参数怎么调、改成自己的业务时该动哪里。

4.1 登录与权限：JWT 如何在前后端配合

农产品网站不需要复杂的权限框架，用 JWT 做登录态是最常见也最好讲的方式。用户登录成功后，后端生成一个带过期时间的 token 返回给前端，前端把它存在 localStorage 里，每次请求都自动带上。

后端生成 token 的代码一般长这样：

String token = Jwts.builder() .setSubject(user.getUsername()) .claim("role", user.getRole()) .setExpiration(new Date(System.currentTimeMillis() + 7 * 24 * 3600 * 1000L)) .signWith(SignatureAlgorithm.HS256, secretKey) .compact();

setSubject放用户名，claim放角色。bat token 里不需要放密码，因为 token 是签名而非加密，谁都能解开 payload，放密码等于把密码明文发给客户端。secretKey要写到配置文件里，不要硬编码在类中。过期时间 7 天，对毕业设计够用，如果你想做“记住我”功能，可以把时间改成 30 天。

前端在 axios 拦截器里统一加请求头：

axios.interceptors.request.use(config => { const token = localStorage.getItem('token'); if (token) { config.headers['Authorization'] = 'Bearer ' + token; } return config; });

后端拦截器校验 token 时，会先看请求头里有没有 Authorization，再决定是否放行。这里最容易翻车的是前后端字段对不上：后端读Authorization，前端传成authorization，大小写不一致导致 401。统一在拦截器里定义一次，不要每个接口单独传。

4.2 商品分页与搜索：MyBatis-Plus 的条件构造器

商品列表接口是用户端最核心的接口，也是后端代码里最能体现规范性的地方。如果源码用了 MyBatis-Plus，搜索加分类加分页通常这样写：

@Override public IPage<Product> searchProduct(int pageNum, int pageSize, Integer categoryId, String keyword) { LambdaQueryWrapper<Product> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(Product::getStatus, 1); if (categoryId != null) { wrapper.eq(Product::getCategoryId, categoryId); } if (StringUtils.hasText(keyword)) { wrapper.like(Product::getName, keyword); } wrapper.orderByDesc(Product::getCreateTime); return productMapper.selectPage(new Page<>(pageNum, pageSize), wrapper); }

LambdaQueryWrapper的好处是字段引用用方法表达式，不会出现把数据库列名写错的问题。eq表示等值条件，like表示模糊搜索，orderByDesc按创建时间倒序。pageNum从 1 开始，前端传过来的页码减 1 再转成 SQL 的 limit，是最常见的错误。MyBatis-Plus 的Page对象已经处理了这个问题，只要别自己手写 limit 就能避免。

答辩时老师如果问“搜索性能怎么办”，答案很简单：农产品网站的访问量在毕业设计场景下根本不会成为瓶颈，加一个idx_category索引就够了。不要把时间浪费在引入 Elasticsearch 这种复杂度爆炸的选型上。

4.3 订单状态流转：从待支付到已发货的字段设计

订单状态是最容易写乱的部分。如果把状态判断散落在各个 controller 里，后面改需求就会变成一场灾难。标准做法是先定义状态常量，再集中管理状态转换。

后端提供统一的状态更新方法：

@Update("UPDATE orders SET status = #{targetStatus} WHERE id = #{orderId} AND status = #{expectedStatus}") int updateStatusIfMatch(@Param("orderId") Long orderId, @Param("targetStatus") Integer targetStatus, @Param("expectedStatus") Integer expectedStatus);

用WHERE status = expectedStatus做条件更新，避免两个请求同时操作订单把状态改乱。比如支付回调先把订单从 0 改成 1，管理端发货又把 1 改成 2，中间任何一步重复提交都会被 upsert 语句挡回去。这种“乐观锁”写法不需要引入分布式锁，代码又简单，是答辩时可以主动讲出来的亮点。

5. 避坑记录：这套毕业设计源码最常见的 5 个翻车点

跑毕设项目会遇到的问题高度集中。下面 5 个坑，每一个都是我见过不止一次的真实场景，按“现象 → 原因 → 解决”写成，拿到任何同类型源码都可以直接复用排查思路。

5.1 数据库中文乱码和 SQL 导入失败

现象是系统能启动，但商品名显示成问号，或者导入 SQL 时报Invalid utf8 character string。原因是建库时用了默认字符集 latin1，或者 SQL 文件里 CREATE TABLE 分段指定了老字符集。解决方式是先确认库的字符集，再统一改为 utf8mb4。

ALTER DATABASE farm_shop CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

如果商品表已经建好，还要单独转表：

ALTER TABLE product CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

另一个导入失败的原因是 SQL 文件里有CREATE DATABASE语句，但 MySQL 当前账号没有建库权限。解决方式是注释掉那一行，手动建好库后再导入表。

5.2 前端接口转发不生效和刷新丢失登录态

现象是点击登录后，浏览器 Network 里请求 URL 显示http://localhost:3000/api/user/login，状态码 404 或 CORS 报错。原因是前端配置了响应转发，但vue.config.js修改后没有重启 dev server，或者请求路径里没有/api前缀。解决方式是重新执行npm run dev，并确认后端所有接口路由统一以/api开头。

另一个现象是登录成功，进入首页，刷新一下立刻跳回登录页。原因是前端只把 token 存到了 Vuex 或内存变量里，刷新后状态丢失。解决方式是存到 localStorage，页面初始化时从 localStorage 恢复 token，再在路由守卫里做跳转判断。这一条几乎每周都会在毕设求助帖里出现，属于经典翻车点。

5.3 文件上传图片无法显示和 Maven 依赖卡死

现象是后台上传农产品图片显示成功，页面上图片裂开。原因是 Spring Boot 的后端把图片保存到了本地磁盘路径，但没有把该磁盘路径映射成可访问的静态资源。前端能拿到一个/upload/xxx.png的 URL，浏览器访问这个 URL 却被 404 拒掉。解决方式是在后端实现一个配置类：

@Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/upload/**") .addResourceHandler("file:" + uploadPath); }

uploadPath是图片保存的真实目录，建议是绝对路径。如果图省事把图片保存到项目的static/upload目录，mvn clean之后图片会被删掉，还得重新传，不如一开始就配磁盘映射。

Maven 依赖卡死的问题，现象是mvn clean install停在下载界面，长时间不动。原因是默认中央仓库访问不稳定。解决方式就是前文提到的阿里云镜像，这属于环境配置问题，跟源码无关，但却是很多同学给源码判死刑的原因。

6. 部署到服务器：用 Maven 打包 + Nginx 反向代理的完整路径

本地能跑，只是毕业设计的第一关。把项目搬到服务器上，让室友用手机浏览器也能访问，这个过程你一定会碰到，而且它会成为答辩时“系统是否真实可用”的证明。

后端打包前，先把application.yml里的数据库密码改成服务器的密码，或者通过--spring.profiles.active=prod激活生产配置。接着执行：

mvn clean package -DskipTests

打包完成后，target目录下会生成一个 jar 文件。把 jar 上传到服务器，建议放在/opt/farm这样的独立目录里。启动命令用 nohup 拉后台：

nohup java -jar farm-shop.jar --spring.profiles.active=prod > app.log 2>&1 &

启动后先不要配前端，先用命令验证后端接口是否通：

curl -X POST http://127.0.0.1:8080/api/user/login \ -H "Content-Type: application/json" \ -d '{"username":"admin","password":"123456"}'

能返回 JSON 说明后端部署成功。接着在本地执行npm run build，生成的 dist 目录上传到服务器的/var/www/farm-front，然后用 nginx 把域名流量接到前端静态文件和后端接口上。

server { listen 80; server_name your-domain.com; location / { root /var/www/farm-front; index index.html; try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }

try_files的作用是前端路由刷新时自动回退到 index.html，否则直接刷新页面会 404。proxy_pass把/api下的请求转发到后端 jar，前端代码里不需要改任何地址，打包时就按相对路径打。部署完成后，浏览器访问服务器公网 IP 或域名，能看到首页、能登录、能下单，整个前后端分离项目实战才算真的闭环。

我自己做部署时养成了一个习惯：每次打包前先grep -n "password" src/main/resources/扫一遍配置文件，确认没有用明文账号密码裸奔。这个习惯帮我避免过至少三次生产事故，也希望帮到你。

本文还有配套的精品资源，点击获取