SpringBoot+微信小程序实现餐厅点餐系统开发实践

1. 项目概述：SpringBoot+微信小程序的餐厅点餐系统

去年帮本地一家连锁餐饮品牌升级点餐系统时，我选择了SpringBoot+微信小程序的组合方案。这种架构既能利用微信生态的流量红利，又能通过后端服务保证高并发场景下的稳定性。系统上线后，门店平均点餐耗时从原来的7分钟缩短到1分半钟，服务员人力成本降低了40%。

这个开源版本保留了核心功能模块，包括扫码桌台绑定、菜品分类展示、购物车管理、订单状态追踪和支付回调处理。特别适合中小型餐厅快速搭建自己的数字化点餐平台，也适合开发者学习现代餐饮系统的典型架构设计。

2. 技术架构解析

2.1 前后端分离设计

系统采用经典的前后端分离架构：

• 前端：微信小程序（WXML+WXSS+JS）
• 后端：SpringBoot 2.7 + MyBatis-Plus
• 通信：RESTful API + WebSocket
• 数据库：MySQL 8.0（分表设计）

选择微信小程序而非原生App主要基于三点考虑：

1. 零安装成本：顾客扫码即用
2. 支付闭环：完美对接微信支付
3. 获客优势：支持分享到微信群/朋友圈

2.2 核心数据模型设计

数据库主要包含6个核心表：

1. dish（菜品表）：包含菜品状态字段（上架/下架）、辣度标识等餐饮特色属性
2. order（订单表）：采用JSON字段存储快照化的菜品详情，避免历史订单受后续菜品修改影响
3. table（桌台表）：包含二维码编号、座位数等字段
4. user（用户表）：微信OpenID作为唯一标识
5. cart（购物车表）：采用Redis缓存+MySQL持久化双写策略
6. payment（支付记录表）：与微信支付流水号关联

java复制// 订单实体示例
public class Order {
    private Long id;
    private String orderNo;  // 业务流水号
    private Long tableId;
    private String openId;
    private String dishItemsJson; // 菜品快照
    private BigDecimal totalAmount;
    private Integer status; // 0-待支付 1-已支付 2-已接单 3-已完成
    private LocalDateTime createTime;
}

3. 关键功能实现细节

3.1 扫码绑桌机制

每个桌台生成唯一二维码，包含：

code复制restaurant://table/bind?storeId=1001&tableId=5

小程序端扫码后：

1. 解析出门店ID和桌台ID
2. 调用/api/table/check接口验证桌台有效性
3. 将验证通过的桌台信息存入小程序Storage

javascript复制// 小程序扫码处理
wx.scanCode({
  success: (res) => {
    const params = parseUrl(res.result);
    wx.request({
      url: '/api/table/check',
      data: { storeId: params.storeId, tableId: params.tableId },
      success: (res) => {
        wx.setStorageSync('currentTable', res.data)
      }
    })
  }
})

3.2 购物车优化策略

针对餐饮场景的特殊优化：

1. 实时库存校验：每次增减菜品都请求接口校验库存
2. 口味备注处理：支持为每个菜品添加多选备注（如：少辣、不要香菜）
3. 智能推荐：基于历史订单推荐常点菜品
4. 本地缓存：未登录状态下也能暂存购物车数据

关键点：购物车数据在提交订单后自动清除，但保留3分钟防误操作恢复机制

3.3 订单状态机设计

订单状态流转采用状态模式实现：

mermaid复制stateDiagram
    [*] --> 待支付
    待支付 --> 已支付: 微信支付回调
    已支付 --> 已接单: 商家确认
    已接单 --> 已完成: 后厨出餐
    已支付 --> 已取消: 超时未支付
    已接单 --> 已退款: 用户申请

对应Spring状态机配置：

java复制@Configuration
public class OrderStateMachineConfig {
    @Bean
    public StateMachine<OrderStatus, OrderEvent> stateMachine() {
        StateMachineBuilder.Builder<OrderStatus, OrderEvent> builder = StateMachineBuilder.builder();
        
        builder.configureStates()
            .withStates()
            .initial(OrderStatus.WAIT_PAY)
            .states(EnumSet.allOf(OrderStatus.class));
        
        builder.configureTransitions()
            .withExternal()
            .source(OrderStatus.WAIT_PAY).target(OrderStatus.PAID)
            .event(OrderEvent.PAY_SUCCESS)
            .and()
            .withExternal()
            .source(OrderStatus.PAID).target(OrderStatus.ACCEPTED)
            .event(OrderEvent.MERCHANT_CONFIRM);
            
        return builder.build();
    }
}

4. 微信支付集成要点

4.1 支付流程时序

1. 小程序调用/api/payment/create创建预支付订单
2. 后端调用微信支付统一下单API获取prepay_id
3. 后端返回支付参数给小程序端
4. 小程序调用wx.requestPayment发起支付
5. 微信异步通知支付结果到回调接口

java复制// 支付回调处理示例
@PostMapping("/payment/notify")
public String paymentNotify(@RequestBody String notifyData) {
    // 1. 验证签名
    WXPayUtil.checkSign(notifyData);
    
    // 2. 处理业务逻辑
    Payment payment = parsePayment(notifyData);
    if(payment.getReturnCode().equals("SUCCESS")) {
        orderService.updateOrderPaid(payment.getOrderNo());
    }
    
    // 3. 返回微信要求的XML格式
    return "<xml><return_code><![CDATA[SUCCESS]]></return_code></xml>";
}

4.2 防重复支付策略

1. 订单创建时生成唯一out_trade_no（业务订单号）
2. 支付表中记录支付状态（0-未支付 1-已支付）
3. 微信回调时做幂等处理
4. 前端支付按钮防重复点击

5. 性能优化实践

5.1 缓存策略

1. 菜品数据：Redis缓存 + 本地缓存二级架构
   • 首次加载：DB → Redis → LocalCache
   • 数据更新：清除Redis对应分类缓存
2. 购物车数据：Redis Hash结构存储

   bash复制HSET cart:{tableId} dishId1 "{count:2, remark:'少辣'}"
   

3. 热点数据：如招牌菜品提前加载到内存

5.2 数据库优化

1. 订单表按月份分表（order_202301）
2. 菜品表添加全文索引支持模糊搜索
3. 使用MyBatis-Plus的自动分页插件
4. 慢查询监控：超过500ms的SQL报警

6. 部署与运维

6.1 服务器配置建议

最低生产环境配置：

• 2核4G云服务器（突发性能实例即可）
• MySQL独立实例（建议阿里云RDS）
• Redis缓存服务（可选云数据库Redis版）

推荐使用Docker Compose部署：

yaml复制version: '3'
services:
  app:
    image: openjdk:11-jre
    ports:
      - "8080:8080"
    volumes:
      - ./app.jar:/app.jar
    command: java -jar /app.jar
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: 123456
    volumes:
      - ./mysql-data:/var/lib/mysql

6.2 监控指标

1. 业务指标：
   • 每分钟订单数（OPM）
   • 平均点餐时长
   • 支付成功率
2. 系统指标：
   • API响应时间P99
   • 数据库连接池使用率
   • JVM内存占用

7. 源码导读建议

项目结构说明：

code复制src/
├── main/
│   ├── java/
│   │   └── com/
│   │       └── restaurant/
│   │           ├── config/       # 配置类
│   │           ├── controller/   # 控制器
│   │           ├── entity/       # 实体类
│   │           ├── enums/        # 枚举类
│   │           ├── mapper/       # MyBatis接口
│   │           ├── service/      # 业务逻辑
│   │           └── utils/        # 工具类
│   └── resources/
│       ├── mapper/      # XML映射文件
│       ├── application.yml
│       └── banner.txt
└── test/                # 单元测试

重点阅读类：

1. WechatPayService：微信支付核心逻辑
2. OrderStateMachine：订单状态机实现
3. CartServiceImpl：购物车业务逻辑
4. TableQrCodeGenerator：桌台二维码生成器

调试建议：

1. 使用微信开发者工具模拟扫码
2. 配置application-dev.yml测试环境
3. 使用Postman测试API接口

8. 扩展开发方向

1. 营销功能：

   • 满减优惠券系统
   • 会员积分体系
   • 拼团秒杀活动

2. 智能推荐：

   • 基于用户画像的菜品推荐
   • 搭配推荐（如：点了水煮鱼推荐冰粉）

3. 硬件对接：

   • 厨房打印机自动接单
   • 桌台呼叫器集成
   • 电子价签同步

4. 数据分析：

   • 菜品销量热力图
   • 客户消费行为分析
   • 库存预测系统

这个项目经过三个月的迭代开发，期间踩过不少坑。最深刻的体会是：餐饮系统的核心不在于技术复杂度，而在于对业务场景的深度理解。比如退单处理要考虑菜品制作进度，桌台管理要支持临时拼桌等特殊场景。建议开发者先到餐厅实地观察运营流程，再动手编码会事半功倍。