1. 项目概述从零构建微信小程序外卖系统这个《苍穹外卖》系列教程已经进行到第四部分我们将完整实现一个前后端分离的微信小程序外卖系统。作为一线开发者我选择这个架构是因为它能充分发挥Java后端的高稳定性和小程序前端的轻量化优势。整套方案采用SpringBootVue技术栈从需求分析到云端部署全流程覆盖特别适合想要进阶全栈开发的Java工程师。微信小程序作为当下最流行的轻应用载体其开发门槛低但生态完善。我们选择外卖系统作为实战项目因为它涵盖了用户端、商家端、骑手端三种角色能完整练习权限控制、订单状态机、支付对接等核心业务场景。整套代码我已经在GitHub开源包含详细的Commit记录你可以清晰地看到每个功能模块的演进过程。2. 技术架构设计解析2.1 前后端分离方案选型我们采用经典的SpringBootVue.js组合但有几个关键设计点需要注意接口规范使用RESTful风格所有API返回统一格式的JSON数据跨域处理通过CrossOrigin注解配合Nginx反向代理解决认证方案JWT微信小程序登录凭证code的双重验证机制后端项目结构采用Maven多模块设计cangqiong ├── cq-common // 公共模块 ├── cq-dao // 数据访问层 ├── cq-service // 业务逻辑层 ├── cq-api // 接口层 └── cq-task // 定时任务模块2.2 微信小程序特殊适配小程序开发有几个技术难点需要特别注意登录流程通过wx.login获取code传给后端换取openid支付对接需要商户资质建议使用沙箱环境开发模板消息替换为订阅消息接口注意频次限制图片上传需要先调用wx.chooseImage再通过wx.uploadFile上传3. 核心功能实现细节3.1 订单状态机设计外卖系统的核心是订单状态流转我们采用状态模式实现public enum OrderStatus { UNPAID(1, 待支付), PAID(2, 已支付), ACCEPTED(3, 商家已接单), DELIVERING(4, 配送中), COMPLETED(5, 已完成), CANCELLED(6, 已取消); // 状态校验逻辑 public static boolean canChangeTo(OrderStatus current, OrderStatus target) { // 具体状态转移规则... } }3.2 分布式锁实现库存扣减秒杀场景下需要使用分布式锁防止超卖public boolean reduceStock(Long dishId, int quantity) { String lockKey dish_stock: dishId; String requestId UUID.randomUUID().toString(); try { // 尝试获取锁 Boolean locked redisTemplate.opsForValue() .setIfAbsent(lockKey, requestId, 30, TimeUnit.SECONDS); if (Boolean.TRUE.equals(locked)) { // 执行库存扣减 Dish dish dishMapper.selectById(dishId); if (dish.getStock() quantity) { dish.setStock(dish.getStock() - quantity); return dishMapper.updateById(dish) 0; } return false; } } finally { // 释放锁时要验证requestId防止误删 if (requestId.equals(redisTemplate.opsForValue().get(lockKey))) { redisTemplate.delete(lockKey); } } return false; }4. 部署方案详解4.1 生产环境部署架构我们采用Docker Compose编排服务version: 3 services: mysql: image: mysql:5.7 environment: MYSQL_ROOT_PASSWORD: ${DB_PASSWORD} volumes: - ./mysql/data:/var/lib/mysql - ./mysql/conf:/etc/mysql/conf.d redis: image: redis:6 ports: - 6379:6379 volumes: - ./redis/data:/data backend: build: ./backend ports: - 8080:8080 depends_on: - mysql - redis frontend: build: ./frontend ports: - 80:804.2 微信小程序发布流程开发环境配置在微信公众平台配置服务器域名设置合法的业务域名配置HTTPS证书必须代码上传# 通过微信开发者工具 cli upload --project ./miniprogram --version 1.0.0 --desc 初始版本提审注意事项确保所有接口都有权限控制支付功能需要提供测试账号敏感信息要做脱敏处理5. 踩坑实录与优化建议5.1 微信支付回调处理常见问题支付成功后未收到回调通知 排查步骤检查商户平台回调配置是否生效验证签名算法是否正确HMAC-SHA256确认服务器能接收POST请求检查防火墙设置微信服务器IP需要加入白名单解决方案代码PostMapping(/pay/notify) public String payNotify(HttpServletRequest request) { // 1. 获取通知数据 String xmlData IOUtils.toString(request.getInputStream(), StandardCharsets.UTF_8); // 2. 验证签名 if (!WXPayUtil.isSignatureValid(xmlData, apiKey)) { return xmlreturn_code![CDATA[FAIL]]/return_code/xml; } // 3. 处理业务逻辑 MapString, String notifyMap WXPayUtil.xmlToMap(xmlData); if (SUCCESS.equals(notifyMap.get(result_code))) { orderService.handlePaySuccess(notifyMap); } // 4. 返回成功响应 return xmlreturn_code![CDATA[SUCCESS]]/return_code/xml; }5.2 性能优化方案缓存策略菜品信息使用Redis缓存设置30分钟过期采用多级缓存策略本地缓存 - Redis - DBSQL优化-- 避免使用SELECT * SELECT id, name, price FROM dish WHERE status 1 -- 复杂查询添加适当索引 ALTER TABLE order ADD INDEX idx_user_status (user_id, status)异步处理使用Async处理非核心流程如发送通知支付成功后通过消息队列处理后续逻辑6. 项目扩展方向这个基础架构可以进一步扩展加入ELK日志分析系统实现灰度发布能力接入微信云开发增强小程序能力增加Prometheus监控指标使用SkyWalking做分布式追踪对于想要深入学习的开发者我建议重点研究微信小程序性能优化技巧Spring Cloud微服务改造方案订单分库分表策略分布式事务解决方案容器化部署进阶实践