外卖系统开发实战：从环境搭建到微服务架构

1. 项目背景与核心价值苍穹外卖这个命名很有意思乍看像是某个外卖平台的内部项目代号。作为从业十年的老鸟我见过太多类似的外卖系统开发案例。这类项目通常包含三个核心模块用户端小程序/APP、商户后台、骑手调度系统。Day01的笔记往往聚焦在基础架构搭建和环境准备阶段。从技术栈选择来看2023年主流的外卖系统普遍采用微服务架构。Spring Boot Spring Cloud的组合占比超过60%其次是Node.js全栈方案。数据库方面MySQL仍是首选但MongoDB在订单日志存储场景的使用率正在快速上升。2. 开发环境配置实录2.1 基础工具链选择工欲善其事必先利其器我的环境配置方案经过多个项目验证JDK选择坚持使用LTS版本目前Java17是平衡新特性和稳定性的最佳选择。注意设置JAVA_HOME时路径不要带空格。IDE配置IntelliJ IDEA 2023.2 Ultimate版必备插件Lombok、MyBatisX、Alibaba Java Coding GuidelinesVM参数调优-Xmx2048m -XX:ReservedCodeCacheSize512m数据库工具开发期用Docker跑MySQL 8.0推荐使用DBeaver作为通用客户端重要character-set-serverutf8mb4必须设置踩坑提醒MySQL 8.0默认的caching_sha2_password认证方式会导致部分客户端连接失败建议初始化时加上--default-authentication-pluginmysql_native_password2.2 项目骨架搭建现代Java项目已经离不开构建工具。我的选择标准是新项目一律用Gradle速度比Maven快30%多模块划分遵循功能内聚原则关键依赖版本必须锁定典型的外卖系统依赖配置示例ext { springBootVersion 3.1.0 springCloudVersion 2022.0.3 } dependencies { // 必选核心组件 implementation org.springframework.boot:spring-boot-starter-web:$springBootVersion implementation org.springframework.cloud:spring-cloud-starter-openfeign:$springCloudVersion // 持久层 implementation com.baomidou:mybatis-plus-boot-starter:3.5.3.1 runtimeOnly mysql:mysql-connector-java:8.0.33 // 工具类 compileOnly org.projectlombok:lombok:1.18.26 annotationProcessor org.projectlombok:lombok:1.18.26 }3. 领域模型设计要点3.1 核心实体关系外卖系统的领域模型有五个关键实体用户模型需要区分C端用户和B端商户商品模型特别注意规格SKU的设计订单模型状态机设计是难点配送模型关联骑手和路线支付模型与第三方对接的防腐层设计ER图核心字段示例MySQL语法CREATE TABLE order ( id bigint NOT NULL AUTO_INCREMENT COMMENT 雪花算法ID, order_no varchar(32) NOT NULL COMMENT 订单编号, user_id bigint NOT NULL COMMENT 用户ID, total_amount decimal(10,2) NOT NULL COMMENT 订单总额, status tinyint NOT NULL DEFAULT 0 COMMENT 0待支付 1已支付 2已接单 3配送中 4已完成 5已取消, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_order_no (order_no), KEY idx_user_id (user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COLLATEutf8mb4_0900_ai_ci;3.2 状态机设计模式订单状态流转是外卖系统的核心逻辑。推荐使用状态模式(State Pattern)实现public interface OrderState { void pay(Order order); void accept(Order order); void deliver(Order order); void complete(Order order); void cancel(Order order); } // 具体状态实现示例 public class PaidState implements OrderState { Override public void accept(Order order) { order.setState(new AcceptedState()); // 触发商家接单事件 eventPublisher.publishEvent(new OrderAcceptedEvent(order)); } // 其他方法抛出IllegalStateException }4. 技术难点解决方案4.1 分布式ID生成外卖系统对ID生成有三点要求全局唯一趋势递增高可用Snowflake算法改良方案public class SequenceGenerator { private final long workerId; private long sequence 0L; private long lastTimestamp -1L; public synchronized long nextId() { long timestamp timeGen(); if (timestamp lastTimestamp) { throw new IllegalStateException(时钟回拨异常); } if (lastTimestamp timestamp) { sequence (sequence 1) SEQUENCE_MASK; if (sequence 0) { timestamp tilNextMillis(lastTimestamp); } } else { sequence 0L; } lastTimestamp timestamp; return ((timestamp - EPOCH) TIMESTAMP_SHIFT) | (workerId WORKER_SHIFT) | sequence; } }4.2 并发订单处理解决超卖问题的三种方案对比方案实现复杂度性能影响适用场景数据库悲观锁★★☆高低频高价值订单Redis分布式锁★★★中中频常规订单库存预扣减MQ异步★★★★低高频秒杀场景推荐组合方案代码示例public boolean placeOrder(OrderDTO orderDTO) { // 1. Redis原子扣减 Long remain redisTemplate.opsForValue() .decrement(stock: orderDTO.getSkuId()); if (remain 0) { redisTemplate.opsForValue() .increment(stock: orderDTO.getSkuId()); throw new BusinessException(库存不足); } // 2. 发送MQ消息 orderProducer.send(new Message( order_topic, JSON.toJSONString(orderDTO).getBytes() )); return true; }5. 调试与性能优化5.1 接口调试技巧Postman高级用法三件套环境变量区分dev/test/prod环境Tests脚本自动处理token续期if (pm.response.code 401) { pm.sendRequest({ url: pm.variables.get(host) /auth/refresh, method: POST, header: { Authorization: Bearer pm.variables.get(refresh_token) } }, (err, res) { pm.variables.set(access_token, res.json().access_token); postman.setNextRequest(pm.info.requestName); }); }Mock Server前端并行开发时特别有用5.2 JVM参数调优外卖系统的JVM配置建议-server -Xms2g -Xmx2g -XX:NewRatio2 -XX:UseG1GC -XX:MaxGCPauseMillis200 -XX:InitiatingHeapOccupancyPercent35 -XX:HeapDumpOnOutOfMemoryError -XX:HeapDumpPath/logs/java_heapdump.hprof关键指标监控GC日志分析-Xloggc:/logs/gc.log -XX:PrintGCDetails内存泄漏检测-XX:NativeMemoryTrackingdetail6. 持续集成方案6.1 Git分支策略推荐采用改良版Git Flowmain - 生产环境代码保护分支 release/* - 预发布分支 feature/* - 功能开发分支 hotfix/* - 紧急修复分支配合.gitignore文件# IDE .idea/ *.iml # Build target/ build/ # Logs *.log logs/ # Env .env *.properties6.2 Docker化部署标准Dockerfile示例FROM eclipse-temurin:17-jdk-jammy WORKDIR /app COPY build/libs/*.jar app.jar EXPOSE 8080 ENTRYPOINT [java,-jar,app.jar]多阶段构建优化版# 构建阶段 FROM maven:3.8.6-eclipse-temurin-17 AS build COPY . . RUN mvn clean package -DskipTests # 运行阶段 FROM eclipse-temurin:17-jre-jammy COPY --frombuild /target/*.jar app.jar USER nobody ENTRYPOINT [java,-jar,app.jar]7. 安全防护措施7.1 常见漏洞防护外卖系统必须处理的六大安全问题SQL注入永远不要拼接SQLMyBatis使用#{}语法启用mybatis-plus的防全表更新插件XSS攻击Configuration public class WebSecurityConfig { Bean public FilterRegistrationBean xssFilter() { FilterRegistrationBean registration new FilterRegistrationBean(); registration.setFilter(new XssFilter()); registration.addUrlPatterns(/*); return registration; } }CSRF防护Spring Security默认启用前后端分离项目需特殊处理7.2 敏感数据保护数据脱敏三原则存储加密密码必须bcrypt哈希传输加密HTTPS敏感字段RSA加密展示脱敏手机号显示为138****1234Jasypt集成示例spring: datasource: url: jdbc:mysql://localhost:3306/db?useSSLfalse username: root password: ENC(密文) jasypt: encryptor: password: ${JASYPT_PASSWORD} # 从环境变量读取8. 监控与告警体系8.1 指标埋点方案Micrometer Prometheus配置Bean public MeterRegistryCustomizerPrometheusMeterRegistry metrics() { return registry - { registry.config().commonTags(application, order-service); new ClassLoaderMetrics().bindTo(registry); new JvmMemoryMetrics().bindTo(registry); }; }关键监控指标订单创建QPS平均响应时间错误率JVM内存使用率8.2 日志收集规范ELK最佳实践日志格式统一Pattern%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n/Pattern添加TraceIDBean public Filter traceIdFilter() { return (request, response, chain) - { MDC.put(traceId, UUID.randomUUID().toString()); try { chain.doFilter(request, response); } finally { MDC.clear(); } }; }9. 压测与性能调优9.1 JMeter测试方案典型外卖场景测试计划登录鉴权获取token浏览商品20%流量下单流程60%流量订单查询20%流量关键参数配置线程组500并发ramp-up 60秒循环次数永远循环断言响应时间500ms错误率0.1%9.2 性能瓶颈分析Arthas常用命令watch com.example.service.OrderService createOrder {params,returnObj,throwExp} -x 3 trace com.example.service.OrderService createOrder profiler start --event cpu优化案例MySQL批量插入// 优化前单条插入 orders.forEach(orderMapper::insert); // 优化后批量插入 SqlSession session sqlSessionFactory.openSession(ExecutorType.BATCH); OrderMapper mapper session.getMapper(OrderMapper.class); orders.forEach(mapper::insert); session.commit();10. 项目演进路线10.1 技术债管理常见技术债清单硬编码配置限期迁移到配置中心魔法数字用枚举常量替代重复代码提取公共模块裸SQL语句改用MyBatis动态SQL10.2 架构演进方向从单体到微服务的拆分策略第一阶段按功能拆分用户服务、订单服务第二阶段按业务域拆分C端服务、B端服务第三阶段核心服务独立支付服务、风控服务服务网格化改造路径接入Service Mesh渐进式迁移流量完善监控体系优化服务治理在真实项目中Day01的成果应该包括项目骨架搭建完成、基础依赖配置妥当、数据库脚本就绪、CI/CD流水线打通。这些基础工作看似简单却直接影响后续开发效率。我见过太多项目因为初期架构没做好后期不得不推倒重来。