Spring Boot+MyBatis实战：农村电商系统数据库与订单设计全解析
发布时间：2026/10/4 16:47:50 作者：尧图编辑部 阅读量：1,286
简介基于Java的农村电子商务系统设计与实现学位论文聚焦“互联网农业”背景下农村电商基础设施薄弱、信息化程度低等痛点构建了以O2O模式为主、PC端与电子货柜终端相结合的电商平台。系统采用Java语言整合Spring、SpringMVC、MyBatis、Shiro安全框架并以SQL Server 2008为数据库前台含缴费支付、商品展示、购物车、订单生成、会员注册等功能后台则设商户、商品、订单、信息与系统管理五大模块。资源为PDF文档共1个文件大小11.39MB内容覆盖需求分析、数据库表结构、系统总体架构及实体类、持久层、业务层、控制层、显示层的分层设计并提供关键模块的实现思路系统在部分县域村域超市和零售店经过测试运营具有一定实用性。目前已有758人学习适合Java学习者、电商系统开发人员及农业信息化研究者参考能帮助理解SSM框架整合流程与农村电商平台从需求到落地实现的全过程。 我的一个客户在乡镇做农产品合作社想把村里的土鸡蛋、时令水果放到网上卖找了几个外包报价都在五万以上最后自己招了一个刚学完Java的毕业生用Spring Boot加MyBatis把系统做出来了。这个标题听起来像课程设计但实际做的时候要回答三个问题使用者是哪些人订单流程有多复杂系统将来谁来维护。农村电商不是淘宝精简版它有季节定价、预订单、物流节点不固定这些特殊性。基于Java实现胜在生态成熟、招人容易而且Spring Boot的默认约定能帮小团队省下大量环境配置时间。这篇笔记适合准备自己动手做系统或者接手类似项目的Java开发者也适合在面试前把“项目经验”里面的技术细节重新捋一遍的人。2. 从需求到表结构设计一个农村电商系统的核心模块2.1 功能模块划分农户、买家、管理员三条主线一个典型的农村电商系统参与者其实就三类人。农户是卖家在后台发布土特产、管理库存买家就是普通用户注册登录、挑商品、下单管理员负责审核商品、处理投诉、看销售报表。别把角色再拍脑袋拆细比如搞成“供应商”“分销商”那会让权限管理复杂一倍而小团队最怕的就是权限边界模糊。功能模块顺着这三条主线展开。农户端商品管理、库存调整、订单处理发货/退款、店铺信息维护。买家端注册登录、商品浏览与收藏、购物车、下单支付、查看物流、确认收货、评价。管理员端用户管理、商品审核、订单监控、基础数据管理。很多做这个题目的同学会漏掉“商品审核”但农村电商里农户上传的商品图片和描述非常随意没有审核环节平台很快会被垃圾信息淹没。再补一个容易被忽略的模块物流信息维护。农村物流不像城市有标准快递单号很多是班车捎带、合作社自送。所以系统里物流不能只存一个单号要能填“承运人电话备注”这部分在数据库设计时就要考虑进去。如果你用的是那种课程设计里常见的四张表完事后面真要跑业务时会发现订单查询和售后都无从下手。2.2 数据库设计商品、订单、购物车、用户表的字段与约束数据库设计是整个项目的地基我一般会先用一张E-R图把关系理清再落到建表SQL。核心表有六张用户表、商品表、购物车表、订单表、订单明细表、支付流水表。商品分类直接挂在商品表上一个category_id不需要单独做复杂的树形分类农村电商品类少两级足够。先说用户表。id用bigint自增username必须唯一password_hash存BCrypt加密后的哈希不要存明文。role用tinyint1买家、2农户、3管理员。phone和address在农贸场景特别重要很多订单是电话沟通后线下付款的所以这两个字段要允许为空但尽量收集。商品表要特别注意price的存储类型。有学生用float存价格最后订单金额对不上因为浮点数计算有误差。正确做法是用decimal(10,2)金额都走decimal。stock用int加非负约束。unit字段别用varchar存个死值否则“斤”“箱”“只”混在一起没法统计。更合理的做法是专门建一个单位字典表或者用枚举字符串并限制长度。订单表是核心中的核心。order_no要单独创建唯一索引方便通过订单号查询和排查问题。status用tinyint不直接用字符串枚举因为字符串索引更慢。total_amount同样decimal。pay_time、ship_time、receive_time留空等状态推进时写入。订单明细表要有product_name和price快照因为商品改价后历史订单不能跟着变。购物车表不需要存总价总价在结算时动态算。表结构就是user_id、product_id、quantity、checked。加一个唯一索引(user_id, product_id)防止同一件商品出现多行这样前端加购时直接做insert...on duplicate key update。支付流水表用来对账。记录payment_no、order_id、pay_amount、支付方式、支付状态、回调时间。即便不接真实支付也要设计这张表模拟支付时同样写流水后面排查订单状态不一致全靠它。2.3 用SQL脚本初始化核心表下面给出MySQL 8.0的建表脚本字符集统一用utf8mb4。CREATE DATABASE IF NOT EXISTS rural_ecommerce DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE rural_ecommerce; CREATE TABLE user ( id bigint NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL, password_hash varchar(100) NOT NULL, role tinyint NOT NULL DEFAULT 1 COMMENT 1买家 2农户 3管理员, phone varchar(20) DEFAULT NULL, address varchar(255) DEFAULT NULL, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT用户表; CREATE TABLE product ( id bigint NOT NULL AUTO_INCREMENT, seller_id bigint NOT NULL, category_id int DEFAULT NULL, name varchar(100) NOT NULL, price decimal(10,2) NOT NULL, stock int NOT NULL DEFAULT 0 COMMENT 库存必须0, unit varchar(10) NOT NULL DEFAULT 件, cover_image varchar(255) DEFAULT NULL, description text, status tinyint NOT NULL DEFAULT 1 COMMENT 1上架 0下架 2待审核, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_seller (seller_id), KEY idx_status (status), CONSTRAINT fk_product_seller FOREIGN KEY (seller_id) REFERENCES user (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT商品表; CREATE TABLE cart ( id bigint NOT NULL AUTO_INCREMENT, user_id bigint NOT NULL, product_id bigint NOT NULL, quantity int NOT NULL DEFAULT 1, checked tinyint NOT NULL DEFAULT 1, PRIMARY KEY (id), UNIQUE KEY uk_cart_user_product (user_id,product_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT购物车表; CREATE TABLE orders ( id bigint NOT NULL AUTO_INCREMENT, order_no varchar(32) NOT NULL, user_id bigint NOT NULL, seller_id bigint NOT NULL, total_amount decimal(10,2) NOT NULL, status tinyint NOT NULL DEFAULT 0 COMMENT 0待支付 1已支付 2已发货 3已完成 4已取消, pay_time datetime DEFAULT NULL, ship_time datetime DEFAULT NULL, receive_time datetime DEFAULT NULL, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_order_no (order_no), KEY idx_user_status (user_id,status), KEY idx_seller (seller_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT订单表; CREATE TABLE order_item ( id bigint NOT NULL AUTO_INCREMENT, order_id bigint NOT NULL, product_id bigint NOT NULL, product_name varchar(100) NOT NULL, price decimal(10,2) NOT NULL, quantity int NOT NULL, subtotal decimal(10,2) NOT NULL, PRIMARY KEY (id), KEY idx_order (order_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT订单明细表;注意orders用了复数因为order在部分MySQL版本里属于保留字虽然加反引号也能用但统一加s更安稳。product表和orders表之间通过order_item中转没有直接外键。这里除了seller_id外键其他关联都靠应用层保证因为订单表和用户表高频写入外键太多会拖慢插入。外键要不要加我的原则是基础数据表如product加外键交易表不加外键靠代码事务维护一致性。3. 基于Spring Boot MyBatis搭建后端骨架3.1 项目结构与依赖配置Spring Boot的骨架我用的是标准三层结构controller、service、mapper外加entity和dto。新建项目直接用Spring Initializr但建议单独加一个MyBatis Starter官方初始izr没有内置。pom.xml关键依赖如下parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent properties java.version1.8/java.version /properties dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.2.2/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependency /dependencies版本选型Spring Boot 2.7.18是2.x最后一个维护版本搭配Java 8最稳很多云服务器上的JDK就是8。MyBatis Starter 2.2.2兼容这个组合。MySQL驱动不用写版本由Spring Boot的依赖管理统一控制。Lombok能省一堆getter/setter但团队里如果有人不熟反而会翻车所以要约定IDE装上插件。如果你用Java 11以上的版本可以考虑Spring Boot 3但配套MyBatis Starter要换成mybatis-spring-boot-starter 3.x这里不展开。3.2 配置数据源与MyBatis映射application.yml里最关键的几项配置server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/rural_ecommerce?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: 123456 jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: Asia/Shanghai servlet: multipart: max-file-size: 5MB max-request-size: 20MB mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.rural.entity configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpldriver-class-name用com.mysql.cj.jdbc.Driver老版本的com.mysql.jdbc.Driver在MySQL 8下会报警告。url里必须带serverTimezone否则默认UTC会差8小时。useSSLfalse在本地够了。allowPublicKeyRetrievaltrue是因为MySQL 8的认证插件可能报Public Key Retrieval错误。map-underscore-to-camel-case这个配置能自动把user_name映射成userName少写很多resultMap。log-impl先开成StdOutImpl开发时能看到SQL上线前换成别的或者关掉避免刷屏。3.3 实现商品模块的增删改查Controller-Service-Mapper三层先看实体类直接用LombokData public class Product { private Long id; private Long sellerId; private Integer categoryId; private String name; private BigDecimal price; private Integer stock; private String unit; private String coverImage; private String description; private Integer status; private Date createTime; }BigDecimal对应数据库decimal不推荐double。接下来是Mapper接口Mapper public interface ProductMapper { int insert(Product product); int update(Product product); int updateStock(Param(id) Long id, Param(num) Integer num); Product selectById(Long id); ListProduct selectList(Param(offset) int offset, Param(limit) int limit); long count(); }updateStock后面在订单模块会用到实现库存扣减的原子操作。Service层要处理业务规则Service public class ProductService { Autowired private ProductMapper productMapper; Transactional public void addProduct(Product product) { if (product.getPrice().compareTo(BigDecimal.ZERO) 0) { throw new IllegalArgumentException(价格必须大于0); } product.setStatus(2); // 待审核 productMapper.insert(product); } }这里传入的status被强制覆盖为待审核是为了配合业务规则农户不能直接上架管理员审核后status变为1。如果你省略这步农户随手传一个status1那审核机制就形同虚设。Controller层负责参数绑定和返回统一结构RestController RequestMapping(/api/product) public class ProductController { Autowired private ProductService productService; GetMapping(/list) public Result list(RequestParam(defaultValue 1) int page, RequestParam(defaultValue 10) int pageSize) { int offset (page - 1) * pageSize; ListProduct list productService.page(offset, pageSize); return Result.success(list); } }分页手工算offset简单项目够用。如果表数据量过十万再上PageHelper但小项目没必要多一个依赖。这里Result是你自己封装的统一返回体我习惯带code、msg、data三个字段前端判断code等于0才走成功逻辑。4. 订单流程与支付状态机农村电商最容易出错的环节4.1 订单状态流转设计订单状态我用一组整型常量表示0待支付、1已支付、2已发货、3已完成、4已取消、5已退款。给出去重规则待支付 - 已支付支付成功回调待支付 - 已取消用户取消或超时已支付 - 已发货农户发货已发货 - 已完成买家确认收货或超时自动确认已支付 - 已退款买家申请退款注意不能从已发货直接回到待支付也不能已取消回到待支付。很多学生把状态存储为字符串随心所欲地改最后订单乱成一锅粥。用枚举把状态转移收敛起来public enum OrderStatus { UNPAID(0), PAID(1), SHIPPED(2), COMPLETED(3), CANCELLED(4), REFUNDED(5); private final int value; OrderStatus(int value) { this.value value; } public int getValue() { return value; } public boolean canTransitTo(OrderStatus target) { switch (this) { case UNPAID: return target PAID || target CANCELLED; case PAID: return target SHIPPED || target REFUNDED; case SHIPPED: return target COMPLETED; default: return false; } } }这样Service里只调canTransitTo不符合流转规则直接抛异常。这也是Java面试里常被问到的状态模式的一种简化实现比满是if的代码好讲得多。4.2 防止超卖的Redis锁与数据库乐观锁农产品秒杀场景很常见比如新茶上市前限量预售。并发情况下数据库的“先查再改”一定会超卖。最可靠的第一道防线是数据库乐观锁UPDATE product SET stock stock - #{num} WHERE id #{id} AND stock #{num}注意不是先select stock再update那个过程有竞态。上面这条SQL让数据库自己判断库存是否够返回受影响行数。在Mapper里这样写int rows productMapper.updateStock(id, num); if (rows 0) { throw new RuntimeException(库存不足); }如果影响行数为0说明库存不够事务回滚。这是最简单且不会超卖的做法能应对绝大多数小额并发。如果峰值很高再叠加Redis分布式锁锁粒度一定要到商品IDpublic boolean tryLock(String lockKey, String requestId, int expireSeconds) { Boolean result stringRedisTemplate.opsForValue() .setIfAbsent(lockKey, requestId, Duration.ofSeconds(expireSeconds)); return Boolean.TRUE.equals(result); }用商品ID构造lockKey例如lock:product:1001。释放锁时用Lua脚本比较requestId防止A线程的锁被B线程误删。这里要注意锁不是用来代替乐观锁的而是用来降低数据库压力。锁只能挡住入口的并发请求最终库存扣减还是靠那条UPDATE SQL兜底。4.3 模拟支付与回调处理真实支付需要商户号、证书本地开发通常用模拟支付。我一般直接写一个伪支付接口前端调它生成支付单然后服务端模拟异步回调。这个回调逻辑和真实支付一样必须做幂等和金额校验public void handlePayCallback(String orderNo, String payNo, BigDecimal payAmount) { // 幂等检查如果订单已经是已支付状态直接返回 Orders order orderMapper.selectByOrderNo(orderNo); if (order.getStatus() OrderStatus.PAID.getValue()) { return; } if (order.getTotalAmount().compareTo(payAmount) ! 0) { throw new IllegalArgumentException(支付金额与订单金额不一致); } int rows orderMapper.markPaid(orderNo, new Date()); if (rows 1) { paymentMapper.insertPayRecord(...); } }回调可能因网络重试被调用多次不做幂等就会出现重复发货或流水重复记账。把markPaid的条件加上WHERE status 0让数据库来保证状态切换只发生一次。支付流水和订单状态更新要在同一个事务里否则对账时会发现钱花了但订单没支付。模拟支付还有一个坑定时任务扫描超时未支付订单。我的经验是每五分钟扫一次把创建时间超过30分钟的待支付订单改为已取消同时回滚库存。回滚库存也要用乐观锁让库存加回去但千万不能让已支付订单被取消。5. 本地开发与部署里的常见坑从环境变量到数据库连接5.1 Java环境与Maven配置的坑现象启动时报UnsupportedClassVersionError或者Maven依赖下载慢到怀疑人生。原因JDK版本不匹配。Spring Boot 2.7用Java 8编译如果你用Java 17运行旧包就会报错。Maven中央仓库在国外断断续续。解决先在终端跑java -version确认版本然后设置JAVA_HOME到对应JDK。Maven的settings.xml里配置阿里云镜像把central仓库地址替换成https://maven.aliyun.com/repository/public。pom里的java.version也要和本机一致避免编译版本和运行版本错位。5.2 数据库连接失败的排查现象启动日志报Connection refused或者Public Key Retrieval is not allowed。原因MySQL服务没启动、端口不对、MySQL 8的认证插件导致或者url少了时区参数。解决第一步telnet一下端口不行就先启动MySQL。第二步确认驱动类MySQL 8必须用com.mysql.cj.jdbc.Driver。第三步在url里加上serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue。本地有时还会遇到密码带特殊字符的问题建议在yaml里用password: 你的密码把字符串包起来避免特殊字符被解析掉。5.3 中文乱码与字符集问题现象数据库里插入的中文变成问号或者前端拿到的JSON里有乱码。原因数据库连接URL没指定编码或者建表时用的latin1又或者是HTTP响应头没指定UTF-8。解决建表统一DEFAULT CHARSETutf8mb4连接url加useUnicodetruecharacterEncodingutf8Spring Boot里server.servlet.encoding.forcetrue可以强制所有响应走UTF-8。另外如果用了外部Tomcat还要在server.xml里配URIEncodingUTF-8。这一套下来基本杜绝乱码。5.4 静态资源与图片上传路径的坑现象本地开发传图片正常重启后图片全没了或者上传成功但前端请求404。原因默认把图片保存在项目根目录的临时目录里每次重启清空。静态资源映射也没指向真实存储目录。解决在application.yml配置一个外部路径upload: path: /data/images然后写一个配置类Configuration public class WebConfig implements WebMvcConfigurer { Value(${upload.path}) private String uploadPath; Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/images/**) .addResourceLocations(file: uploadPath /); } }注意file:后面要跟上斜杠Windows下路径写成file:D:/data/images/。上传文件时用transferTo(new File(uploadPath / filename))并且给文件名加上UUID前缀否则农户上传两张同名照片互相覆盖。5.5 MyBatis的resultType与resultMap混用踩坑现象查询结果里create_time一直是null或者有字段明明在表里却映射不上。原因没有开启驼峰映射或者SQL查询里用了一个带association的resultMap但同样接口又改了resultType导致一堆字段对不上。解决在application.yml里开启map-underscore-to-camel-case: true这样user_name自动映射userName。如果实体里有关联对象才写resultMap比如订单明细关联商品这时不要在Mapper方法上再写resultType两者只能选一个。我见过最隐蔽的问题手写SQL用过别名createTime而不是create_time结果开启驼峰映射后反而不知道怎么映射了。统一规则就是数据库字段都下划线实体属性都驼峰映射交给MyBatis的自动配置。6. 上线前怎么验证和优化接口压测、日志、缓存三板斧6.1 用JMeter做一次接口压测先拿商品列表接口开刀。JMeter里建线程组50个线程并发循环20次聚合报告看吞吐量和错误率。如果错误率超过1%先看是不是数据库连接池太小。Spring Boot默认hikari连接池最大10并发50时会有大量线程等连接把spring.datasource.hikari.maximum-pool-size调到30试试。6.2 加Redis缓存热点商品查询从300ms到5ms那些被反复浏览的农产品比如首页推荐位完全没必要每次查数据库。引入Spring Cache在查询方法上加Cacheable(cacheNames product, key #id)商品改价时用CacheEvict清掉对应缓存。注意设置过期时间不要太长农产品价格变化快我一般设30分钟。如果查询列表也加缓存记得缓存key里带上分页参数否则第二页的人看到的还是第一页数据。6.3 日志与慢SQL排查开发期开着StdOutImpl看SQL上线后改成文件输出并按天滚动。给商品表订购时间字段加索引是最基本的一步遇到慢查询用EXPLAIN SELECT ...看有没有走索引rows是不是全表扫描。之前接手一个项目订单列表卡到爆原因就是状态字段没加索引几万条数据全扫加上idx_user_status后秒开。最后再说一个我自己的教训别为了追求技术新鲜感把Redis、消息队列、微服务全都堆上去。农村电商这个规模一台单机Tomcat加MySQL就能扛住初创期流量先把订单一致性做好比什么都强。希望帮到你。本文还有配套的精品资源点击获取
尧图网站开发 