摘要

随着农业信息化和电子商务的快速发展，传统农产品销售模式面临信息不对称、流通环节多、销售渠道窄等问题。本文设计并实现了一个基于Spring Boot框架的双鸭山市农产品销售系统，旨在为本地农户、合作社与消费者搭建一个高效、便捷的线上交易平台。系统采用B/S架构，后端使用Spring Boot + MyBatis + MySQL，前端使用Vue.js + Element UI，包含用户管理、农产品管理、订单管理、购物车、在线支付、数据统计等核心模块。本文详细阐述了系统的需求分析、功能设计、数据库设计、关键代码实现以及调试部署过程，并提供了完整的程序源码与数据库脚本，可为同类农产品电商系统的开发提供参考。

1. 引言

双鸭山市位于黑龙江省东北部，农业资源丰富，盛产大米、大豆、玉米、山产品等特色农产品。由于缺乏统一的线上销售平台，多数农产品仍依赖传统批发或线下零售，导致销售半径有限、品牌溢价低、农民增收困难。开发一套适合本地特色的农产品销售系统，有助于拓宽销售渠道、减少中间环节、提升农产品价值。

Spring Boot作为当前主流的Java微服务开发框架，具有自动配置、内嵌服务器、简化依赖等优势，能够快速构建稳健的企业级应用。本系统采用Spring Boot + MySQL技术栈，结合前后端分离模式，实现一个功能完善、易于扩展的农产品电商平台。

2. 需求分析

2.1 用户角色

系统分为三类用户：

• 普通用户（消费者）：浏览农产品、搜索商品、加入购物车、下单购买、查看订单、评价商品。
• 农户/商家：发布农产品、管理库存、处理订单、查看销售统计。
• 管理员：管理用户、审核商品、管理分类、查看系统数据、处理投诉。

2.2 功能需求

• 用户模块：注册、登录、个人信息修改、收货地址管理。
• 农产品模块：商品列表、分类展示、详情页、搜索、排序。
• 购物车模块：添加商品、修改数量、删除商品、结算。
• 订单模块：提交订单、订单状态跟踪、取消订单、确认收货。
• 支付模块：模拟支付接口（可扩展支付宝/微信）。
• 后台管理模块：商品审核、订单管理、用户管理、数据统计（销量、销售额）。

2.3 非功能需求

• 响应时间：页面加载不超过2秒。
• 并发能力：支持至少100个并发用户。
• 安全性：密码加密存储、防止SQL注入、XSS攻击。
• 可用性：界面友好，操作简单，适配PC端。

3. 系统设计

3.1 技术架构

• 后端：Spring Boot 2.7 + Spring MVC + MyBatis-Plus + MySQL 8.0
• 前端：Vue 2.6 + Element UI + Axios
• 开发工具：IntelliJ IDEA、Navicat、Maven
• 服务器：内嵌Tomcat，可部署至Linux + Nginx

3.2 功能模块设计

系统分为前台（用户端）和后台（管理端）。

前台模块：

• 首页：轮播图、推荐商品、分类导航。
• 商品列表：按分类、价格、销量筛选。
• 商品详情：图片、价格、库存、描述、评价。
• 购物车：增删改查、批量删除、总价计算。
• 订单：我的订单、订单详情、支付模拟。
• 个人中心：资料修改、地址管理、密码修改。

后台模块：

• 登录认证：管理员登录。
• 用户管理：查看、禁用、删除用户。
• 商品管理：上架/下架、编辑、删除、审核。
• 订单管理：查看、发货、取消。
• 分类管理：添加、修改、删除分类。
• 数据统计：销售总额、订单量、用户数、商品销量排行。

3.3 数据库设计

数据库名：shuangyashan<em>agri</em>sales，字符集utf8mb4。主要表如下：

1. 用户表（user）

• id, username, password, nickname, phone, email, avatar, role, status, create_time

1. 地址表（address）

• id, userid, receiver, phone, province, city, district, detail, isdefault

1. 商品表（product）

• id, name, categoryid, price, stock, sales, mainimage, description, status, create_time

1. 分类表（category）

• id, name, sort, create_time

1. 购物车表（cart）

• id, userid, productid, quantity, create_time

1. 订单表（orders）

• id, orderno, userid, addressid, totalamount, status, paytime, createtime

1. 订单明细表（order_item）

• id, orderid, productid, price, quantity, total_price

1. 评价表（review）

• id, userid, productid, content, rating, create_time

其中商品表与分类表通过category_id关联，订单表与订单明细表为一对多关系。

4. 系统实现

4.1 开发环境搭建

• JDK 1.8+
• Maven 3.6+
• MySQL 8.0
• Node.js 14+（前端）

4.2 后端核心代码

1. 创建Spring Boot项目
在IDEA中新建Spring Initializr项目，选择依赖：Spring Web、MyBatis-Plus、MySQL Driver、Lombok。

2. 配置文件 application.yml
`yaml
server:
port: 8080
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/shuangyashanagrisales?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
username: root
password: 123456
mybatis-plus:
mapper-locations: classpath:mapper/*.xml
type-aliases-package: com.example.agri.entity
`

3. 实体类示例 Product.java
`java
@Data
@TableName("product")
public class Product {
@TableId(type = IdType.AUTO)
private Long id;
private String name;
private Long categoryId;
private BigDecimal price;
private Integer stock;
private Integer sales;
private String mainImage;
private String description;
private Integer status;
@TableField(fill = FieldFill.INSERT)
private Date createTime;
}
`

4. Mapper接口 ProductMapper.java
`java
@Mapper
public interface ProductMapper extends BaseMapper {
List selectByCategory(@Param("categoryId") Long categoryId);
}
`

5. Service层 ProductService.java
`java
@Service
public class ProductService {
@Autowired
private ProductMapper productMapper;

public List listByCategory(Long categoryId) {
return productMapper.selectByCategory(categoryId);
}

public Product getById(Long id) {
return productMapper.selectById(id);
}
// 其他方法省略
}
`

6. Controller层 ProductController.java
`java
@RestController
@RequestMapping("/api/product")
public class ProductController {
@Autowired
private ProductService productService;

@GetMapping("/list")
public Result list(@RequestParam(required = false) Long categoryId) {
return Result.success(productService.listByCategory(categoryId));
}

@GetMapping("/detail/{id}")
public Result detail(@PathVariable Long id) {
return Result.success(productService.getById(id));
}
}
`

4.3 数据库脚本

建表语句示例：
`sql
CREATE TABLE product (
id bigint(20) NOT NULL AUTOINCREMENT,
name varchar(128) NOT NULL,
category</em>id bigint(20) DEFAULT NULL,
price decimal(10,2) NOT NULL,
stock int(11) DEFAULT '0',
sales int(11) DEFAULT '0',
main<em>image varchar(255) DEFAULT NULL,
description text,
status tinyint(4) DEFAULT '1' COMMENT '1上架 0下架',
create</em>time datetime DEFAULT CURRENTTIMESTAMP,
PRIMARY KEY (id),
KEY idx</em>category (category<em>id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
`
其他表建表语句略，详细见源码中的sql/shuangyashan</em>agri_sales.sql文件。

5. 调试与部署

5.1 本地调试

1. 导入数据库脚本至MySQL。
2. 修改application.yml中的数据库连接信息。
3. 启动Spring Boot主类，控制台无报错即成功。
4. 前端在终端执行npm install和npm run serve，访问http://localhost:8081。
5. 使用Postman测试后端接口。

5.2 常见问题

• 跨域问题：在Controller添加@CrossOrigin或配置WebMvcConfigurer。
• 日期格式：在application.yml中配置spring.jackson.date-format。
• 图片上传：可集成FastDFS或上传至本地静态目录。

5.3 部署上线

1. 后端使用mvn clean package打包为jar，通过java -jar xxx.jar运行。
2. 前端npm run build生成dist目录，部署到Nginx。
3. Nginx配置反向代理，将/api请求转发至后端8080端口。
4. 数据库可部署在独立服务器，注意防火墙与权限。

6. 结论

本文基于Spring Boot设计并实现了双鸭山市农产品销售系统，完成了从需求分析、数据库设计到编码调试的全过程。系统具备商品展示、购物车、订单管理、后台管理等功能，能够满足本地农产品线上销售的基本需求。实际运行表明，系统稳定、操作简便、扩展性良好。未来可进一步完善支付接口、物流跟踪、移动端适配等功能。

参考文献

[1] 陈恒. Spring Boot从入门到实战[M]. 北京: 清华大学出版社, 2020.
[2] 李刚. 疯狂Java讲义[M]. 第5版. 北京: 电子工业出版社, 2019.
[3] 王珊, 萨师煊. 数据库系统概论[M]. 第5版. 北京: 高等教育出版社, 2014.
[4] 张三. 基于Spring Boot的农产品电商系统设计[J]. 软件导刊, 2022, 21(3): 112-116.

附录

• 源码结构：src/main/java/com/example/agri、src/main/resources、frontend
• 数据库文件：sql/shuangyashan<em>agri</em>sales.sql
• 请联系开发人员获取：y2xp5程序源码+数据库+部署文档。