Spring Boot+Uni-App开发果蔬电商全栈项目实践

莫姐

1. 项目概述

"果蔬到家APP"是一款基于移动互联网的农产品电商平台，旨在解决传统果蔬购买方式中存在的耗时费力、信息不对称等问题。作为一名有多年开发经验的工程师，我在毕业设计中选择了这个项目，因为它不仅具有实际应用价值，还能充分展示全栈开发能力。

这个项目采用了前后端分离的架构，后端使用Spring Boot框架，前端采用Uni-App实现跨平台开发。系统主要包含三个角色：买家用户、商家用户和管理员，实现了从商品展示、下单购买到订单管理的完整电商流程。

提示：在开发类似电商系统时，建议从最小可行产品(MVP)开始，先实现核心功能再逐步扩展，这样可以有效控制开发周期和风险。

1.1 核心需求解析

1.1.1 买家用户需求

买家用户的核心需求集中在便捷购物体验上：

商品浏览与搜索：支持分类查看和关键词搜索
购物车管理：可添加多件商品并统一结算
订单跟踪：实时查看订单状态和物流信息
个人中心：管理收货地址、收藏商品等

1.1.2 商家用户需求

商家用户主要关注店铺运营效率：

商品管理：上下架商品、设置价格和库存
订单处理：查看新订单、安排配送
数据统计：分析销售情况和经营状况
营销工具：发放优惠券促进销售

1.1.3 管理员需求

管理员负责平台整体运营：

用户管理：审核商家资质、处理用户投诉
内容管理：维护首页轮播图、公告信息
系统监控：查看平台整体运营数据
安全管理：防范恶意攻击和数据泄露

2. 技术选型与架构设计

2.1 技术栈选择

2.1.1 后端技术栈

选择Spring Boot作为后端框架主要基于以下考虑：

快速开发：内置Tomcat，简化配置
生态丰富：Spring Data JPA、Spring Security等成熟组件
微服务友好：便于后期扩展为微服务架构
社区支持：遇到问题容易找到解决方案

数据库选用MySQL 8.0，原因包括：

ACID事务支持，保证数据一致性
成熟的索引机制，查询性能优秀
开源免费，适合学生项目
与Spring Boot集成简单

2.1.2 前端技术栈

前端采用Uni-App框架实现跨平台开发：

一次开发，多端发布（iOS/Android/小程序）
基于Vue.js，学习曲线平缓
丰富的组件库和插件市场
良好的性能表现

2.2 系统架构设计

系统采用经典的三层架构：

code复制┌───────────────────────────────────────┐
│               客户端层                │
│  (iOS/Android/小程序，基于Uni-App)   │
└───────────────────────────────────────┘
                   │
                   ▼
┌───────────────────────────────────────┐
│               API网关层               │
│  (路由转发、权限校验、请求限流等)     │
└───────────────────────────────────────┘
                   │
                   ▼
┌───────────────────────────────────────┐
│              业务逻辑层               │
│  (Spring Boot实现核心业务处理)        │
└───────────────────────────────────────┘
                   │
                   ▼
┌───────────────────────────────────────┐
│              数据访问层               │
│  (JPA/Hibernate操作MySQL数据库)       │
└───────────────────────────────────────┘

这种分层架构的优势在于：

职责分离，各层专注特定功能
便于团队协作开发
可独立扩展某一层的性能
易于维护和测试

3. 核心功能实现细节

3.1 用户认证与授权

3.1.1 JWT认证实现

采用JWT(JSON Web Token)实现无状态认证：

java复制// JWT工具类核心代码
public class JwtUtil {
    private static final String SECRET = "your-secret-key";
    private static final long EXPIRATION = 86400L; // 24小时
    
    public static String generateToken(UserDetails userDetails) {
        Map<String, Object> claims = new HashMap<>();
        return Jwts.builder()
                .setClaims(claims)
                .setSubject(userDetails.getUsername())
                .setIssuedAt(new Date())
                .setExpiration(new Date(System.currentTimeMillis() + EXPIRATION * 1000))
                .signWith(SignatureAlgorithm.HS512, SECRET)
                .compact();
    }
    
    public static Boolean validateToken(String token, UserDetails userDetails) {
        final String username = extractUsername(token);
        return (username.equals(userDetails.getUsername()) && !isTokenExpired(token));
    }
}

3.1.2 权限控制

基于Spring Security实现RBAC权限模型：

java复制@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.csrf().disable()
            .authorizeRequests()
            .antMatchers("/api/auth/**").permitAll()
            .antMatchers("/api/buyer/**").hasRole("BUYER")
            .antMatchers("/api/seller/**").hasRole("SELLER")
            .antMatchers("/api/admin/**").hasRole("ADMIN")
            .anyRequest().authenticated()
            .and()
            .addFilter(new JwtAuthenticationFilter(authenticationManager()))
            .addFilter(new JwtAuthorizationFilter(authenticationManager()));
    }
}

3.2 商品模块实现

3.2.1 商品数据库设计

商品表核心字段设计：

sql复制CREATE TABLE `goods` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `name` varchar(100) NOT NULL COMMENT '商品名称',
  `description` text COMMENT '商品描述',
  `price` decimal(10,2) NOT NULL COMMENT '现价',
  `original_price` decimal(10,2) COMMENT '原价',
  `stock` int NOT NULL DEFAULT '0' COMMENT '库存',
  `sales` int DEFAULT '0' COMMENT '销量',
  `category_id` bigint COMMENT '分类ID',
  `seller_id` bigint NOT NULL COMMENT '商家ID',
  `status` tinyint DEFAULT '1' COMMENT '状态：1-上架,0-下架',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP,
  `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  KEY `idx_category` (`category_id`),
  KEY `idx_seller` (`seller_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

3.2.2 商品搜索实现

使用Elasticsearch实现高效商品搜索：

java复制@Service
public class ProductSearchServiceImpl implements ProductSearchService {
    
    @Autowired
    private ElasticsearchOperations elasticsearchOperations;
    
    @Override
    public Page<Product> search(String keyword, Pageable pageable) {
        NativeSearchQuery searchQuery = new NativeSearchQueryBuilder()
            .withQuery(QueryBuilders.multiMatchQuery(keyword, "name", "description"))
            .withPageable(pageable)
            .build();
            
        return elasticsearchOperations.queryForPage(searchQuery, Product.class);
    }
}

3.3 订单模块实现

3.3.1 下单流程

下单核心业务流程：

验证商品库存
计算订单总价（考虑优惠券）
创建订单主表记录
创建订单明细记录
扣减商品库存
返回订单创建结果

java复制@Transactional
public Order createOrder(OrderDTO orderDTO) {
    // 1. 验证商品和库存
    List<OrderItem> items = validateProducts(orderDTO.getItems());
    
    // 2. 计算总价
    BigDecimal totalAmount = calculateTotal(items);
    BigDecimal discountAmount = applyCoupon(orderDTO.getCouponId(), totalAmount);
    BigDecimal actualAmount = totalAmount.subtract(discountAmount);
    
    // 3. 创建订单
    Order order = new Order();
    order.setUserId(orderDTO.getUserId());
    order.setTotalAmount(totalAmount);
    order.setActualAmount(actualAmount);
    order.setStatus(OrderStatus.PENDING_PAYMENT);
    orderRepository.save(order);
    
    // 4. 创建订单项
    createOrderItems(order.getId(), items);
    
    // 5. 扣减库存
    reduceStock(items);
    
    return order;
}

3.3.2 订单状态机

使用状态模式管理订单状态流转：

java复制public interface OrderState {
    void pay(Order order);
    void deliver(Order order);
    void receive(Order order);
    void cancel(Order order);
}

@Service
@Scope("prototype")
public class PendingPaymentState implements OrderState {
    @Override
    public void pay(Order order) {
        order.setState(new PaidState());
        // 更新订单状态为已支付
    }
    
    @Override
    public void cancel(Order order) {
        order.setState(new CancelledState());
        // 恢复库存等操作
    }
}

4. 部署与运维

4.1 服务器环境配置

推荐部署环境：

操作系统：Ubuntu 20.04 LTS
Web服务器：Nginx 1.18
应用服务器：Tomcat 9/JDK 11
数据库：MySQL 8.0
缓存：Redis 6.x

4.2 数据库配置优化

生产环境MySQL建议配置：

ini复制[mysqld]
innodb_buffer_pool_size = 1G  # 根据服务器内存调整
innodb_log_file_size = 256M
innodb_flush_log_at_trx_commit = 2  # 平衡性能与安全性
sync_binlog = 100
max_connections = 200
query_cache_type = 0  # 禁用查询缓存

4.3 应用部署脚本

使用Shell脚本自动化部署：

bash复制#!/bin/bash

# 停止现有服务
sudo systemctl stop fruits-app

# 备份旧版本
TIMESTAMP=$(date +%Y%m%d%H%M%S)
tar -czvf /backup/fruits-app-$TIMESTAMP.tar.gz /opt/fruits-app

# 部署新版本
rm -rf /opt/fruits-app/*
unzip -q fruits-app-latest.zip -d /opt/fruits-app

# 配置环境
cp /opt/fruits-app/config/prod.properties /opt/fruits-app/config/application.properties

# 启动服务
sudo systemctl start fruits-app

# 健康检查
sleep 30
STATUS=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:8080/actuator/health)
if [ "$STATUS" -eq 200 ]; then
    echo "Deployment successful"
else
    echo "Deployment failed"
    exit 1
fi