1. 项目概述从零搭建外卖平台的技术探索去年参与的一个餐饮SaaS项目让我深刻体会到外卖平台的技术架构远比表面看到的复杂得多。这个sky-take-out系列正是基于实战经验的技术复盘Day01我们将从最基础的环境搭建开始逐步拆解一个现代化外卖系统的技术栈。不同于简单的CRUD应用外卖系统需要处理高并发订单、实时地理位置、多端数据同步等特殊场景这对技术选型和架构设计提出了独特挑战。2. 技术栈选型与核心考量2.1 后端技术决策选择SpringBoot作为基础框架并非偶然。在对比了Node.js和Python Flask后我们发现Java生态在以下方面具有优势成熟的分布式事务解决方案如Seata完善的OAuth2安全实现对高并发场景下连接池管理的精细控制与主流消息队列Kafka/RocketMQ的无缝集成特别值得注意的是我们采用了SpringCloud Alibaba而非原生SpringCloud主要考虑到Nacos在配置管理和服务发现上比Eureka更符合国内团队的使用习惯Sentinel对突发流量的控制比Hystrix更直观阿里云生态的兼容性降低了后期部署成本2.2 前端技术适配采用Vue3TypeScript的组合出于三点考虑Composition API更适合复杂业务逻辑的封装TypeScript的强类型检查能减少跨团队协作的接口问题Vite的快速热更新显著提升开发体验针对移动端特殊需求我们额外引入了高德地图JS API餐饮类目专用版本WebSocket实时订单状态推送自定义的滑动加载组件优化菜单列表性能3. 开发环境搭建实战3.1 基础设施准备# 使用Docker Compose快速搭建依赖服务 version: 3 services: mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: sky123 ports: - 3306:3306 volumes: - ./mysql/data:/var/lib/mysql redis: image: redis:6 ports: - 6379:6379 command: redis-server --requirepass sky123关键提示MySQL必须配置为ROW格式的binlog这是后续实现CDC变更数据捕获的基础。在my.cnf中添加[mysqld] log-binmysql-bin binlog-formatROW server_id13.2 项目骨架生成使用Spring Initializr创建项目时这些依赖必不可少Spring WebREST接口MyBatis Plus数据库操作Lombok代码简化SpringDoc OpenAPIAPI文档SpringCloud Starter Alibaba Nacos服务注册前端项目初始化时特别注意npm create vitelatest sky-take-out-web --template vue-ts cd sky-take-out-web npm install axios vue-router4 pinia element-plus/icons-vue4. 核心模块设计要点4.1 领域模型划分外卖系统通常包含以下核心领域商户管理含资质审核商品服务SKU管理订单系统状态机设计配送调度地理围栏算法支付对账分布式事务我们采用DDD领域驱动设计的模块划分方式src/ ├── main/ │ ├── java/ │ │ └── com.sky.takeout/ │ │ ├── merchant/ # 商户领域 │ │ ├── product/ # 商品领域 │ │ ├── order/ # 订单领域 │ │ └── delivery/ # 配送领域4.2 订单状态机设计外卖订单的复杂状态流转需要精确定义public enum OrderStatus { PENDING_PAYMENT, // 待支付 PAID, // 已支付 MERCHANT_ACCEPTED, // 商家接单 COOKING, // 制作中 DELIVERY_PICKUP, // 骑手取货 DELIVERING, // 配送中 COMPLETED, // 已完成 CANCELLED // 已取消 }使用状态模式实现状态转换public interface OrderState { void next(Order order); void prev(Order order); void cancel(Order order); } Component RequiredArgsConstructor public class PaidState implements OrderState { private final PaymentService paymentService; Override public void next(Order order) { order.setStatus(OrderStatus.MERCHANT_ACCEPTED); } Override public void cancel(Order order) { paymentService.refund(order); order.setStatus(OrderStatus.CANCELLED); } }5. 典型问题排查实录5.1 跨商户缓存污染现象A商户登录后看到B商户的商品数据 原因Redis键设计未包含tenantId 解决方案// 错误写法 String key product: productId; // 正确写法 String key String.format(tenant:%s:product:%s, tenantId, productId);5.2 订单超时未关闭排查路径检查定时任务日志确认Redis延迟队列是否正常验证数据库事务隔离级别应为READ_COMMITTED最终发现是消息TTL设置错误修正方案// RabbitMQ消息配置 Bean public Queue orderTimeoutQueue() { return QueueBuilder.durable(order.timeout.queue) .withArgument(x-message-ttl, 900000) // 15分钟 .withArgument(x-dead-letter-exchange, order.dlx.exchange) .build(); }6. 性能优化关键策略6.1 菜单加载加速采用多级缓存策略浏览器本地缓存静态菜单JSON有效期2小时CDN缓存店铺头图等静态资源Redis缓存热门商品LFU淘汰策略MySQL查询优化-- 添加覆盖索引 ALTER TABLE product ADD INDEX idx_merchant_status (merchant_id, status);6.2 订单创建优化原始流程的问题串行校验库存→优惠券→运费同步调用支付网关全表扫描查询活动优化后的并行处理CompletableFutureVoid stockCheck CompletableFuture.runAsync(() - { inventoryService.check(items); }, stockThreadPool); CompletableFutureVoid couponCheck CompletableFuture.runAsync(() - { couponService.validate(couponId); }, couponThreadPool); CompletableFuture.allOf(stockCheck, couponCheck).get(500, MILLISECONDS);7. 安全防护实践7.1 防刷单机制实现维度设备指纹识别通过UAIP行为特征生成滑动验证码二次验证下单频率超过阈值时触发基于LBS的异常检测同一账号多地下单核心代码片段public void checkOrderFrequency(Long userId) { String key order:limit: userId; Long count redisTemplate.opsForValue().increment(key); if (count 1) { redisTemplate.expire(key, 1, TimeUnit.HOURS); } if (count 20) { throw new BusinessException(操作过于频繁); } }7.2 敏感数据脱敏在DTO层统一处理public class UserDTO { JsonSerialize(using PhoneDesensitizer.class) private String phone; JsonSerialize(using AddressDesensitizer.class) private String address; } public class PhoneDesensitizer extends JsonSerializerString { Override public void serialize(String value, JsonGenerator gen, SerializerProvider provider) throws IOException { gen.writeString(value.replaceAll((\\d{3})\\d{4}(\\d{4}), $1****$2)); } }8. 监控体系建设8.1 埋点设计关键埋点位置订单创建成功率含失败原因分类支付回调延迟不同支付渠道对比商家接单响应时间分时段统计使用Prometheus客户端示例RestController public class OrderController { private final Counter orderCounter; public OrderController(MeterRegistry registry) { this.orderCounter registry.counter(order.create.total, channel, app); } PostMapping(/orders) public Order createOrder() { orderCounter.increment(); // ... } }8.2 日志规范采用结构化日志格式Pattern %d{yyyy-MM-dd HH:mm:ss} | %X{traceId} | %-5level | %logger{36} | %msg%n /Pattern关键日志场景用户敏感操作登录、修改手机号支付状态变更需记录前后状态库存扣减异常实际扣减值与预期值