🏗️ Mall-App 架构学习笔记

📅 创建时间：2026-05-20

🏷️ 标签： Spring Cloud 微服务 UniApp Vue 2 电商系统 全栈架构

📍 项目路径：E:\workSpace\mall-app

Mall-App 是一个完整的生产级电商系统，由两个独立子项目组成，协同工作构成全栈解决方案：

基于 UniApp (Vue 2) 的移动端购物前端，一套代码编译到 H5、Android、iOS、微信小程序四大平台。通过 HTTP REST API 与后端 mall-portal 服务通信，基础 URL 为 http://localhost:8085。

基于 Spring Boot 3.2 + Spring Cloud 2023 + Spring Cloud Alibaba 的 Java 微服务后端，源自知名开源项目 mall-swarm (macrozheng)。包含认证、网关、管理后台、商城门户、商品搜索、监控等 9 个微服务模块。

• 导入 Vue 2，创建 Vuex Store 并挂载到 Vue.prototype.
• 创建全局 辅助对象：msg() (Toast 提示) + prePage() (导航辅助)
• 挂载 App 根组件

• onLaunch 生命周期：从 uni.getStorageSync('userInfo') 恢复登录状态
• 定义全局事件总线：Vue.prototype. = new Vue()
• 包含所有全局样式和 yticon 图标字体定义
• 使用条件编译 (#ifdef MP, #ifdef H5) 处理平台差异

Store 极其精简，仅管理认证状态：

// store/index.js
state: {
  hasLogin: false,
  userInfo: {}
},
mutations: {
  login(state, provider) {
    state.hasLogin = true;
    state.userInfo = provider;
    uni.setStorage({ key: 'userInfo', data: provider });
  },
  logout(state) {
    state.hasLogin = false;
    state.userInfo = {};
    uni.removeStorageSync('userInfo');
    uni.removeStorageSync('token');
  }
}

基于 luch-request（类 axios 的 uni-app 兼容 HTTP 库）封装：

基础 URL 配置于 appConfig.js：http://localhost:8085

UniApp 使用 pages.json 声明式路由（非 vue-router），首个条目为首页。

每个业务微服务内部遵循经典的四层架构：

mall-portal 是直接服务移动端的微服务，包含 15 个 Controller：

MyBatis Generator 按业务域前缀自动生成代码：

11 个 API 模块覆盖全部业务功能，均通过统一的 request(options) 函数发起请求：

mall-common 模块定义了标准化的 API 响应结构：

// CommonResult<T> - 统一响应
{
  "code": 200,        // 状态码
  "message": "成功",   // 提示信息
  "data": { ... }     // 业务数据
}

// CommonPage<T> - 分页响应
{
  "code": 200,
  "data": {
    "list": [ ... ],      // 数据列表
    "pageNum": 1,          // 当前页
    "pageSize": 20,        // 每页大小
    "totalPage": 5,        // 总页数
    "total": 100           // 总记录数
  }
}

• IErrorCode / ResultCode：错误码枚举定义
• GlobalExceptionHandler：全局异常处理，捕获异常后返回统一格式
• WebLogAspect：AOP 切面，自动记录请求/响应日志

所有外部流量通过 mall-gateway (Spring Cloud Gateway) 统一入口。网关负责：

• 路由转发：根据路径前缀路由到不同微服务
• 鉴权过滤：Sa-Token 校验 token，区分会员 (StpMemberUtil) 和管理员鉴权
• 限流熔断：集成 Sentinel 实现流量控制

所有服务配置集中在 config/ 目录，通过 Nacos Config Center 管理，支持 dev/prod 多环境切换：

config/
├── admin/mall-admin-dev.yaml      # 管理后台开发配置
├── admin/mall-admin-prod.yaml     # 管理后台生产配置
├── portal/mall-portal-dev.yaml    # 商城门户开发配置
├── gateway/mall-gateway-dev.yaml  # 网关开发配置
└── search/mall-search-dev.yaml    # 搜索服务开发配置

使用 Sa-Token 替代传统的 Spring Security OAuth2：

• 前端：uni.setStorage('token') 持久化，每次请求附带 Authorization 头
• 网关：Sa-Token 拦截器校验 token 有效性
• 服务间：通过 Gateway 转发已验证的请求

超时订单自动取消采用消息队列模式：

CancelOrderSender   →  RabbitMQ (延迟队列)  →  CancelOrderReceiver
发送取消消息                                              接收并执行取消

OrderTimeOutCancelTask (定时任务)  →  扫描超时订单，触发取消

mall-mbg 模块从数据库 schema 自动生成：

• Model 类：与表结构一一对应的 POJO
• Mapper 接口：标准 CRUD 操作
• Mapper XML：SQL 映射文件

业务微服务引用 mall-mbg 依赖，手写自定义查询放在各自的 dao/ 包中。

WebLogAspect 在 mall-common 中定义，所有微服务自动继承：

• 记录请求 URL、HTTP 方法、请求参数、响应结果
• 统计接口耗时
• 统一日志格式，便于 ELK 采集分析

项目提供两套 Docker Compose 配置：

• docker-compose-env.yml：基础设施容器（MySQL、Redis、MongoDB、RabbitMQ、ES、Nacos）
• docker-compose-app.yml：应用服务容器（各微服务实例）

# 启动基础设施
docker-compose -f docker-compose-env.yml up -d

# 启动应用服务
docker-compose -f docker-compose-app.yml up -d

document/k8s/ 目录包含所有微服务的 Deployment + Service YAML：

document/k8s/
├── mall-admin-deployment.yaml
├── mall-admin-service.yaml
├── mall-gateway-deployment.yaml
├── mall-gateway-service.yaml
├── mall-portal-deployment.yaml
├── mall-portal-service.yaml
└── ...

• Spring Boot Admin：mall-monitor 提供服务健康检查、内存/CPU 指标、日志级别动态调整
• ELK Stack：document/elk/ 包含 Logstash 配置，通过 Logstash Logback Appender 将日志推送到 Elasticsearch + Kibana
• Druid Monitor：数据库连接池监控（慢 SQL、活跃连接数等）

1. 前后端分离的最佳实践

UniApp 作为前端通过 REST API 与 Spring Cloud 后端通信，前端只关心 UI 和用户交互，后端专注业务逻辑和数据。Gateway 统一入口简化了鉴权和路由。

2. 微服务拆分策略

按业务能力拆分：门户(C端)、管理(B端)、搜索、认证各自独立。公共逻辑（统一响应、异常处理、日志）下沉到 mall-common，数据访问层 mall-mbg 独立为共享模块。

3. 多存储引擎选型

不同数据特征选择不同存储：关系数据 → MySQL，缓存/会话 → Redis，文档/日志型 → MongoDB，搜索 → ES。不是所有数据都要塞进一个数据库。

4. 异步解耦

超时订单取消用 RabbitMQ 异步处理，避免定时任务轮询数据库的压力。消息队列是微服务间解耦的关键基础设施。

5. 代码生成 vs 手写

MyBatis Generator 处理重复的 CRUD 代码，开发只需关注自定义查询和业务逻辑。代码生成模块独立为 mall-mbg，各业务服务引用而非复制。

6. 跨平台方案选择

UniApp 一套代码覆盖 H5 + 小程序 + App，对于中小型电商项目是高性价比方案。条件编译 (#ifdef) 处理平台差异。

• mall-gateway 的 Sa-Token 鉴权过滤器实现
• mall-portal 的订单创建流程（库存校验 → 价格计算 → 优惠券抵扣 → 下单）
• RabbitMQ 延迟队列实现超时取消的细节
• Seata 分布式事务在下单场景中的应用
• Elasticsearch 与 MySQL 的数据同步方案
• Sentinel 限流熔断的配置策略