SpringBoot零食超市管理系统开发实战

1. 项目背景与核心价值

最近在整理毕业设计资料时，翻到一个挺有意思的SpringBoot项目——休闲零食超市管理系统。这个系统乍看简单，但深入分析后发现它其实涵盖了电商系统开发中的多个核心技术点。作为一个完整的管理系统，它需要处理商品管理、订单处理、会员体系等核心业务场景，对Java开发者来说是个不错的全栈练习项目。

这个系统的特别之处在于它针对休闲零食这一垂直领域做了专门设计。相比通用电商系统，它需要考虑零食类商品的特殊属性（如保质期管理、口味分类）、促销玩法（如组合套餐）以及高频复购等特点。下面我就结合这个项目的源码，拆解下这类系统的典型架构和实现要点。

2. 系统架构设计解析

2.1 技术栈选型

基础框架采用了经典的SpringBoot 2.x + MyBatis组合，这是目前Java后端开发最主流的搭配。前端使用Thymeleaf模板引擎配合Bootstrap，属于轻量级的选择。数据库选用MySQL 5.7，考虑到系统数据量不会特别大，这个版本完全够用。

选型时的几个关键考虑：

1. 开发效率：SpringBoot的自动配置能快速搭建项目骨架
2. 维护成本：MyBatis比Hibernate更直观，适合学生项目
3. 部署简易：内嵌Tomcat，打包成jar即可运行

2.2 分层架构设计

系统采用标准的三层架构：

code复制表现层(Web)
    ↓
业务逻辑层(Service) 
    ↓
数据访问层(Dao)

特别的是增加了utils工具包处理通用功能，比如：

• 日期格式化
• 文件上传
• 验证码生成
• 支付接口封装

3. 核心功能模块实现

3.1 商品管理模块

零食商品有其特殊性，数据库设计时需要特别注意：

sql复制CREATE TABLE `product` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(100) NOT NULL COMMENT '商品名称',
  `category_id` int(11) NOT NULL COMMENT '分类ID',
  `price` decimal(10,2) NOT NULL COMMENT '售价',
  `original_price` decimal(10,2) DEFAULT NULL COMMENT '原价',
  `stock` int(11) NOT NULL DEFAULT '0' COMMENT '库存',
  `shelf_life` varchar(50) DEFAULT NULL COMMENT '保质期',
  `flavor` varchar(20) DEFAULT NULL COMMENT '口味',
  `main_image` varchar(255) DEFAULT NULL COMMENT '主图',
  `detail` text COMMENT '商品详情',
  `status` tinyint(4) DEFAULT '1' COMMENT '状态',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

实现商品列表查询时，MyBatis的动态SQL派上用场：

xml复制<select id="selectByCondition" resultMap="BaseResultMap">
  SELECT * FROM product
  <where>
    <if test="categoryId != null">
      AND category_id = #{categoryId}
    </if>
    <if test="keyword != null and keyword != ''">
      AND name LIKE CONCAT('%',#{keyword},'%')
    </if>
    <if test="status != null">
      AND status = #{status}
    </if>
  </where>
  ORDER BY create_time DESC
</select>

3.2 特色购物车设计

针对零食购买特点，购物车做了这些优化：

1. 支持批量添加不同口味的同款商品
2. 自动计算组合优惠（如满3件8折）
3. 临近保质期商品特殊标识

核心逻辑在CartService中：

java复制public void addToCart(CartItem item) {
    // 检查库存
    Product product = productMapper.selectByPrimaryKey(item.getProductId());
    if(product.getStock() < item.getQuantity()) {
        throw new BusinessException("库存不足");
    }
    
    // 检查是否已存在相同商品
    CartItemExample example = new CartItemExample();
    example.createCriteria()
        .andUserIdEqualTo(item.getUserId())
        .andProductIdEqualTo(item.getProductId());
    List<CartItem> existItems = cartItemMapper.selectByExample(example);
    
    if(!existItems.isEmpty()) {
        // 更新数量
        CartItem existItem = existItems.get(0);
        existItem.setQuantity(existItem.getQuantity() + item.getQuantity());
        cartItemMapper.updateByPrimaryKey(existItem);
    } else {
        // 新增记录
        item.setCreateTime(new Date());
        cartItemMapper.insert(item);
    }
}

3.3 订单处理流程

订单状态机设计是关键：

code复制待支付 → 已支付 → 配货中 → 已发货 → 已完成
           ↓
        取消订单

使用枚举定义状态：

java复制public enum OrderStatus {
    UNPAID(0, "待支付"),
    PAID(1, "已支付"),
    PACKAGING(2, "配货中"),
    SHIPPED(3, "已发货"),
    FINISHED(4, "已完成"),
    CLOSED(-1, "已关闭");
    
    private int code;
    private String desc;
    
    // 构造方法、getter省略
}

4. 开发中的实用技巧

4.1 文件上传处理

零食系统需要处理大量商品图片，文件上传要注意：

1. 限制文件类型（仅允许jpg/png）
2. 控制文件大小（建议不超过2MB）
3. 生成唯一文件名防止冲突

SpringBoot中配置Multipart：

properties复制# application.properties
spring.servlet.multipart.max-file-size=2MB
spring.servlet.multipart.max-request-size=10MB

控制器实现：

java复制@PostMapping("/upload")
public Result upload(@RequestParam("file") MultipartFile file) {
    if (file.isEmpty()) {
        return ResultGenerator.genFailResult("请选择文件");
    }
    
    // 检查文件类型
    String fileName = file.getOriginalFilename();
    String suffix = fileName.substring(fileName.lastIndexOf("."));
    if(!Arrays.asList(".jpg", ".png").contains(suffix.toLowerCase())) {
        return ResultGenerator.genFailResult("仅支持jpg/png格式");
    }
    
    // 生成新文件名
    String newFileName = UUID.randomUUID() + suffix;
    File dest = new File(uploadPath + newFileName);
    
    try {
        file.transferTo(dest);
        return ResultGenerator.genSuccessResult("/upload/" + newFileName);
    } catch (IOException e) {
        return ResultGenerator.genFailResult("上传失败");
    }
}

4.2 定时任务设计

零食管理需要处理一些定时任务：

1. 每日凌晨检查临期商品（保质期剩余30天内）
2. 自动取消30分钟未支付的订单
3. 每周生成销售统计报表

使用Spring Scheduled实现：

java复制@Component
public class ScheduleTask {
    
    @Autowired
    private ProductMapper productMapper;
    
    @Autowired
    private OrderMapper orderMapper;
    
    // 每天凌晨1点执行
    @Scheduled(cron = "0 0 1 * * ?")
    public void checkExpiringProducts() {
        Date thirtyDaysLater = DateUtils.addDays(new Date(), 30);
        List<Product> products = productMapper.selectExpiringSoon(thirtyDaysLater);
        // 标记为临期商品或发送通知...
    }
    
    // 每30分钟执行一次
    @Scheduled(fixedRate = 1800000)
    public void cancelUnpaidOrders() {
        Date thirtyMinutesAgo = DateUtils.addMinutes(new Date(), -30);
        List<Order> orders = orderMapper.selectUnpaidBefore(thirtyMinutesAgo);
        orders.forEach(order -> {
            order.setStatus(OrderStatus.CLOSED.getCode());
            orderMapper.updateByPrimaryKey(order);
            // 释放库存...
        });
    }
}

5. 典型问题排查记录

5.1 库存超卖问题

在秒杀场景下容易出现库存超卖，解决方案：

1. 使用数据库乐观锁：

sql复制UPDATE product SET stock = stock - 1 
WHERE id = 1 AND stock >= 1

2. 或者使用Redis分布式锁：

java复制public boolean reduceStock(Long productId, int quantity) {
    String lockKey = "product_" + productId;
    String requestId = UUID.randomUUID().toString();
    try {
        // 获取锁
        boolean locked = redisTemplate.opsForValue()
            .setIfAbsent(lockKey, requestId, 30, TimeUnit.SECONDS);
        if(!locked) {
            return false;
        }
        
        // 执行库存扣减
        Product product = productMapper.selectByPrimaryKey(productId);
        if(product.getStock() < quantity) {
            return false;
        }
        product.setStock(product.getStock() - quantity);
        productMapper.updateByPrimaryKey(product);
        return true;
    } finally {
        // 释放锁
        if(requestId.equals(redisTemplate.opsForValue().get(lockKey))) {
            redisTemplate.delete(lockKey);
        }
    }
}

5.2 事务处理要点

订单创建涉及多个表操作，必须保证事务：

java复制@Transactional
public String createOrder(Order order, List<OrderItem> items) {
    // 1. 保存订单主表
    orderMapper.insert(order);
    
    // 2. 保存订单商品
    for(OrderItem item : items) {
        item.setOrderId(order.getId());
        orderItemMapper.insert(item);
        
        // 3. 扣减库存
        Product product = productMapper.selectByPrimaryKey(item.getProductId());
        product.setStock(product.getStock() - item.getQuantity());
        productMapper.updateByPrimaryKey(product);
    }
    
    // 4. 清空购物车
    cartItemMapper.deleteByUserId(order.getUserId());
    
    return order.getOrderNo();
}

6. 项目扩展建议

这个基础系统还可以进一步扩展：

1. 增加分销功能：让用户成为推广员
2. 开发微信小程序端：提升移动端体验
3. 接入智能推荐：基于用户购买历史推荐商品
4. 实现供应商管理：对接上游供货商

以微信小程序接入为例，需要：

1. 新增API模块处理小程序接口
2. 使用WxJava等SDK处理微信登录
3. 调整认证机制（从Session改为Token）
4. 优化接口响应速度（添加Redis缓存）

核心登录逻辑示例：

java复制@GetMapping("/wxlogin")
public Result wxLogin(@RequestParam String code) {
    // 获取openid
    WxMaJscode2SessionResult session = wxService.getUserService()
        .getSessionInfo(code);
    String openid = session.getOpenid();
    
    // 查询或创建用户
    UserExample example = new UserExample();
    example.createCriteria().andWxOpenidEqualTo(openid);
    List<User> users = userMapper.selectByExample(example);
    
    User user;
    if(users.isEmpty()) {
        user = new User();
        user.setWxOpenid(openid);
        user.setCreateTime(new Date());
        userMapper.insert(user);
    } else {
        user = users.get(0);
    }
    
    // 生成token
    String token = JwtUtil.generateToken(user.getId().toString());
    return ResultGenerator.genSuccessResult(token);
}

开发这类管理系统时，我的经验是前期一定要把数据库设计好，特别是字段类型和索引。曾经因为把商品价格设为float类型导致计算精度问题，后来全部改为decimal(10,2)才解决。另外，对于状态字段，使用枚举比直接写数字代码可读性要好很多。