Mall4cloud：开源版微服务商城系统（SpringCloud+Vue）

Mall4cloud 是 Mall4j 体系下的微服务商城产品线，开源版采用 B2B2C 多商户架构，基于 Spring Boot 4 + Spring Cloud 构建，整合 Nacos 服务注册、Seata 分布式事务、Redis 缓存、RocketMQ 消息队列、Elasticsearch 搜索和 MinIO 文件存储等主流中间件，是一套功能完整、适合学习和二次开发的微服务电商系统。

项目定位

Mall4cloud 开源版面向 B2B2C 商城场景，包含平台端、商家端和用户端三套管理界面，覆盖商品管理、订单流转、店铺运营、权限控制等核心电商业务。与 Mall4j 单体开源版不同，Mall4cloud 采用微服务拆分，将网关、授权、商品、订单、支付、用户、搜索等能力独立部署，更适合中大型电商项目的架构学习和企业级二次开发。同类微服务商城还可参考 dts-shop 开源B2C商城系统。

项目主线已升级到 Spring Boot 4、Spring Cloud 和 Vue3，具体依赖版本以后端 pom.xml 和前端 package.json 为准。开源版遵循 AGPLv3 协议，可用于学习、研究和符合协议的自行部署场景；闭源商用、私有化交付、集群部署支持等需求可参考 Mall4j 官网的商业授权方案。

核心特点

• 微服务架构：基于 Spring Boot 4 + Spring Cloud，服务按业务域拆分，网关统一入口
• 分布式事务：集成 Seata 保障订单、库存、支付等跨服务数据一致性
• 完整中间件栈：Nacos 配置中心、Redis 缓存、RocketMQ 异步消息、Elasticsearch 商品搜索、MinIO 对象存储
• 多端覆盖：平台管理后台、商家管理后台、uni-app 用户端（H5/小程序/App）
• 代码规范：按阿里巴巴代码规约检查，项目通过代码规约扫描

技术架构与目录结构

项目采用标准的微服务分层设计，各模块职责清晰。内网接口统一放在 mall4cloud-api 下，按业务域划分为 auth、biz、order、product、user 等子模块，方便服务间 Feign 调用引用。公共能力下沉到 mall4cloud-common，包含缓存、数据库、安全、订单、商品等通用组件。

核心服务模块包括：

• mall4cloud-gateway：网关服务，统一入口，端口 8000
• mall4cloud-auth：授权校验服务，端口 9101
• mall4cloud-rbac：用户角色权限模块，端口 9102
• mall4cloud-product：商品服务，端口 9104
• mall4cloud-order：订单服务，端口 9106
• mall4cloud-payment：支付服务，端口 9113
• mall4cloud-user：用户服务，端口 9105
• mall4cloud-search：搜索服务，端口 9108
• mall4cloud-multishop：商家端服务，端口 9103
• mall4cloud-platform：平台端服务
• mall4cloud-leaf：基于美团 Leaf 的分布式 ID 生成服务，端口 9100

快速启动

项目文档位于仓库 doc 目录，建议先阅读文档再结合视频搭建本地环境。启动顺序如下：

1. 先启动中间件：MySQL、Redis、Nacos、MinIO
2. 后端最小链路：网关 mall4cloud-gateway（8000）+ auth + rbac + biz + platform（平台端）或 multishop（商家端）
3. 前端配置 VITE_APP_BASE_API 只指向网关地址，不要直连业务服务端口
4. 仓库示例 IP 为 192.168.1.46，拿到源码后需批量替换为自己的地址

开发环境搭建视频可参考 B 站教程，项目还提供了 Agent Skill 辅助文件（.agents/skills/mall4cloud/），支持 Cursor、Codex 和 Claude Code 等 AI 编程工具按功能点辅助开发。

开源版与企业版对比

演示环境

项目提供了在线演示环境，方便直接体验各端功能：

• PC 端：https://cloud-pc.mall4j.com
• H5 端：https://h5.mall4j.com/cloud

运行截图

平台端后台

商家端后台

小程序端

uni-app 端

相关资源

• Mall4j 商城官网：https://www.mall4j.com
• 版本价格与功能对比：https://www.mall4j.com/price/
• 客户案例：https://www.mall4j.com/case/
• 技术论坛：https://www.mall4j.com/forum/
• Gitee 主仓库：https://gitee.com/gz-yami/mall4cloud
• 开源技术 QQ 群：561496886

开源项目地址：https://gitee.com/gz-yami_admin/mall4cloud