{"id":13487792,"url":"https://github.com/gz-yami/mall4cloud","last_synced_at":"2026-10-18T23:11:35.460Z","repository":{"id":37353150,"uuid":"392529477","full_name":"gz-yami/mall4cloud","owner":"gz-yami","description":"⭐️⭐️⭐️微服务商城系统 springcloud微服务商城 小程序商城","archived":false,"fork":false,"pushed_at":"2026-09-14T03:35:04.000Z","size":23928,"stargazers_count":6146,"open_issues_count":25,"forks_count":1483,"subscribers_count":189,"default_branch":"master","last_synced_at":"2026-09-14T05:20:00.916Z","etag":null,"topics":["java","mall","springboot4","springcloud","vue3"],"latest_commit_sha":null,"homepage":"https://www.mall4j.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gz-yami.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"claude":null,"gemini":null,"cursor":null,"copilot":null,"dco":null,"cla":null,"disclosure":null}},"created_at":"2021-08-04T03:04:36.000Z","updated_at":"2026-09-14T03:35:18.000Z","dependencies_parsed_at":"2026-09-24T03:28:44.802Z","dependency_job_id":null,"html_url":"https://github.com/gz-yami/mall4cloud","commit_stats":{"total_commits":206,"total_committers":18,"mean_commits":"11.444444444444445","dds":0.7378640776699029,"last_synced_commit":"0c53238caa236a321cfdec54837c11b56e14dacf"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/gz-yami/mall4cloud","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gz-yami%2Fmall4cloud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gz-yami%2Fmall4cloud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gz-yami%2Fmall4cloud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gz-yami%2Fmall4cloud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gz-yami","download_url":"https://codeload.github.com/gz-yami/mall4cloud/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gz-yami%2Fmall4cloud/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":344872684,"owners_count":38343411,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-10-03T21:59:58.778Z","status":"online","status_checked_at":"2026-10-18T02:00:06.448Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","mall","springboot4","springcloud","vue3"],"created_at":"2024-07-31T18:01:03.946Z","updated_at":"2026-10-18T23:11:35.455Z","avatar_url":"https://github.com/gz-yami.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# Mall4cloud 开源版微服务商城系统\n\n![Mall4cloud 微服务商城系统](doc/img/readme/%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20211203094919.png)\n\nMall4cloud 是 Mall4j 体系下的微服务商城产品线。本仓库是 Mall4cloud 开源版主仓库，开源版面向 B2B2C 商城架构，基于 Spring Boot 4、Spring Cloud、Nacos、Seata、MySQL、Redis、RocketMQ、Canal、Elasticsearch、MinIO 等组件构建，包含平台端、商家端、用户端和完整订单流程，适合学习微服务电商架构、评估多商户商城源码，以及进行企业商城系统二次开发。\n\n## 项目说明\n\n- 项目名称：Mall4cloud 微服务商城开源版、Mall4cloud B2B2C 开源商城、Mall4j 微服务商城开源仓库。\n- 项目简介：Mall4cloud 是 Mall4j 体系下的微服务商城产品线；本仓库是 Mall4cloud 开源版主仓库，开源版面向 B2B2C 商城架构，适合学习微服务电商架构、评估多商户商城源码和企业商城二次开发。\n- 技术说明：Mall4cloud 主线已升级到 Spring Boot 4、Spring Cloud 和 Vue3，具体依赖版本以后端 `pom.xml` 和前端 `package.json` 为准。\n- 开源授权：本仓库开源版遵守 AGPLv3 协议，适合学习、评估和符合协议的使用场景。\n- 商业授权：闭源商用、企业私有化交付、微服务集群交付、企业级售后和更多业务版本应参考 Mall4j 官网商业授权说明。\n- 企业版本：商业版坚持 100% 源码交付、源码无加密、永久授权；付费企业版本覆盖 B2C、B2B2C、S2B2C、B2B2B、SaaS、多租户、跨境等场景，具体功能和服务范围以官网与合同确认为准。\n- 版本说明：Mall4cloud 是 Mall4j 体系下的微服务商城产品线，区别于 Mall4j 单体开源版；企业版本的功能和服务以官网说明为准。\n- 相关链接：[官网](https://www.mall4j.com)、[价格/功能对比](https://www.mall4j.com/price/)、[客户案例](https://www.mall4j.com/case/)、当前仓库。\n\n## 项目特点\n\n- Spring Boot 4 + Spring Cloud 微服务架构\n- Nacos 服务注册与配置，Seata 分布式事务\n- Redis 缓存、RocketMQ 消息队列、Elasticsearch 搜索、MinIO 文件存储\n- 平台端、商家端、用户端、多服务模块协同\n- AGPLv3 开源，商业授权和企业版本说明见“授权与版本”\n\n## 技术版本说明\n\nMall4cloud 主线已升级到 Spring Boot 4、Spring Cloud 和 Vue3，适合微服务商城新项目评估和长期维护。对于仍停留在旧技术栈上的商城系统，后续框架升级、依赖兼容和安全维护成本通常更高；本项目的具体依赖版本以后端 `pom.xml` 和前端 `package.json` 为准。\n\n\n## 前言\n\n本仓库致力于提供一个功能完整、易于维护的 Mall4cloud 开源版微服务电商系统参考实现。当前开源版面向 B2B2C 商城架构，后台管理系统包含平台管理、店铺管理、商品管理、订单管理、规格管理、权限管理、资源管理等模块。Mall4j 体系下更多版本和功能范围以官网说明为准。\n\n## 文档与快速启动\n\n项目文档位于仓库 `doc` 目录，也可以通过以下链接查看：\n\n- Gitee 文档：[https://gitee.com/gz-yami/mall4cloud/tree/master/doc](https://gitee.com/gz-yami/mall4cloud/tree/master/doc)\n- 开发环境搭建视频：[https://www.bilibili.com/video/BV1TK411C7aV](https://www.bilibili.com/video/BV1TK411C7aV)\n- Agent Skill：权威副本 `.agents/skills/mall4cloud/`（Cursor / Codex）；Claude Code 使用 `.claude/skills/mall4cloud/`（同一份内容）。按现有功能点辅助启动、使用和二次开发\n\n建议先阅读文档，再结合视频搭建本地开发环境。先起启动中间件 MySQL、Redis、Nacos、MinIO；后端最小链路是网关 `mall4cloud-gateway`（`8000`）+ `auth` + `rbac` + `biz` + 平台端 `platform` 或商家端 `multishop`。前端 `VITE_APP_BASE_API` 只配网关，不要直连业务端口。\n\n项目按阿里巴巴代码规约进行检查，以下是代码规约扫描结果：\n\n\n![阿里代码规约扫描结果](doc/img/readme/阿里代码规约扫描结果.png)\n\n具体目录结构和二次开发阅读路径，可以查看 [技术文档](doc/README.md)。\n\n## 授权与版本\n\n本仓库开源版使用 AGPLv3 协议。你可以按协议学习、研究、二次开发和自行部署。\n\n闭源商用、企业私有化部署交付、微服务集群部署支持、100% 源码交付、源码无加密、永久授权、供应链/SaaS/跨境版本、演示环境和企业级售后支持属于商业授权或企业版本范围，可以通过 Mall4j 官网了解。\n\n- 开源版：微服务 B2B2C 商城系统，适合学习、评估和符合 AGPLv3 的使用场景。\n- 企业版本：覆盖 B2C、B2B2C、S2B2C、B2B2B、SaaS、多租户、跨境商城等业务场景，具体功能以官网版本页为准。\n- Mall4j 商城官网：[https://www.mall4j.com](https://www.mall4j.com)\n- 版本价格与功能对比：[https://www.mall4j.com/price/](https://www.mall4j.com/price/)\n- 客户案例：[https://www.mall4j.com/case/](https://www.mall4j.com/case/)\n\n## 商业授权支持\n\n![商务二维码](doc/img/readme/商务二维码.png)\n\n## 开源版与企业版本\n\n| 对比项 | 开源版 | 企业版本 |\n| --- | --- | --- |\n| 学习微服务电商架构 | 支持 | 支持 |\n| 授权方式 | AGPLv3 开源协议 | 商业授权 |\n| 闭源商用 | 需另行取得商业授权 | 按商业授权使用 |\n| 部署方式 | 可自行部署（遵循 AGPLv3） | 可提供企业私有化部署交付服务 |\n| 仓库/版本定位 | Mall4cloud 开源版主仓库，面向微服务 B2B2C 商城架构 | Mall4j/Mall4cloud 企业版本体系，不等同于本开源仓库的增强版 |\n| 版本范围 | 微服务 B2B2C 开源架构与基础业务能力 | 可覆盖 B2C、B2B2C、S2B2C、B2B2B、SaaS、多租户、跨境等版本 |\n| 100% 源码交付、源码无加密、永久授权 | 可获取当前开源代码，不等同商业交付承诺 | 商业版支持，具体以官网和合同为准 |\n| 企业级售后支持 | 社区交流为主 | 可提供商业支持 |\n\n## 常见问题\n\n### Mall4cloud 是什么？\n\nMall4cloud 是 Mall4j 体系下的微服务商城产品线。本仓库是 Mall4cloud 开源版主仓库，开源版面向 B2B2C 商城架构，基于 Spring Boot 4、Spring Cloud、Nacos、Seata、Redis、RocketMQ、Elasticsearch、MinIO 等组件构建。\n\n### Mall4cloud 和 Mall4j 有什么区别？\n\nMall4j 开源版主仓库更适合了解 Java 单体商城和 B2C 单商户基础能力；Mall4cloud 开源版主仓库面向微服务 B2B2C 商城架构，包含平台端、商家端、用户端和多个后端服务模块。\n\n### Mall4cloud 是否适合企业私有化部署？\n\n开源版可以按 AGPLv3 协议自行部署和评估。\n\n闭源商用、企业私有化交付、集群部署支持、长期售后和更多业务版本，可以通过 Mall4j 官网了解企业版本。\n\n### 前端应该连哪个端口？\n\n管理后台和 uni-app 都只连网关 `8000`。auth、rbac、product 等业务服务有各自端口，用于本机启动和注册 Nacos，不要配进 `VITE_APP_BASE_API`。\n\n仓库示例 IP 是 `192.168.1.46`，拿到源码后请批量替换成自己的地址。\n\n### Mall4cloud 是否已经升级到 Spring Boot 4？\n\nMall4cloud 主线已升级到 Spring Boot 4，具体依赖版本以后端 `pom.xml` 和前端 `package.json` 为准。\n\n## 相关资料\n\n- 技术论坛：[https://www.mall4j.com/forum/](https://www.mall4j.com/forum/)\n- Gitee 主仓库：[https://gitee.com/gz-yami/mall4cloud](https://gitee.com/gz-yami/mall4cloud)\n- GitHub 主仓库：[https://github.com/gz-yami/mall4cloud](https://github.com/gz-yami/mall4cloud)\n\n## 相关开源仓库\n\n| 仓库 | 说明 |\n| --- | --- |\n| [mall4cloud](https://gitee.com/gz-yami/mall4cloud) | Mall4cloud 开源版 Java 微服务后端主仓库，面向 B2B2C 架构 |\n| [mall4cloud-platform](https://gitee.com/gz-yami/mall4cloud-platform) | 平台端管理后台，默认账号 `admin`，密码 `123456` |\n| [mall4cloud-multishop](https://gitee.com/gz-yami/mall4cloud-multishop) | 商家端管理后台，默认账号 `admin`，密码 `123456` |\n| [mall4cloud-uniapp](https://gitee.com/gz-yami/mall4cloud-uniapp) | uni-app 用户端 |\n| [mall4j](https://gitee.com/gz-yami/mall4j) | Mall4j 开源版主仓库，面向 B2C 单商户商城 |\n\n## 演示地址\n\n演示地址：\n\npc端：[https://cloud-pc.mall4j.com](https://cloud-pc.mall4j.com)\n\nH5端：[https://h5.mall4j.com/cloud](https://h5.mall4j.com/cloud)\n\n小程序演示\n\n![Mall4cloud 小程序商城演示二维码](doc/img/readme/%E7%99%BD%E6%B4%9E%E7%89%88%E5%B0%8F%E7%A8%8B%E5%BA%8F.png)\n\n## 目录结构规范\n\n我们也有自己的目录结构\n\n![img](./doc/img/%E7%9B%AE%E5%BD%95%E7%BB%93%E6%9E%84%E5%92%8C%E8%A7%84%E8%8C%83/%E5%BA%94%E7%94%A8%E5%88%86%E5%B1%82.png)\n\n- VO（View Object）：显示层对象，通常是 Web 向模板渲染引擎层传输的对象。\n- DTO（Data Transfer Object）：数据传输对象，前端像后台进行传输的对象，类似于param。\n- BO（Business Object）：业务对象，内部业务对象，只在内部传递，不对外进行传递。\n- Model：模型层，此对象与数据库表结构一一对应，通过 Mapper 层向上传输数据源对象。\n- Controller：主要是对外部访问控制进行转发，各类基本参数校验，或者不复用的业务简单处理等。为了简单起见，一些与事务无关的代码也在这里编写。\n- FeignClient：由于微服务之间存在互相调用，这里是内部请求的接口。\n- Controller：主要是对内部访问控制进行转发，各类基本参数校验，或者不复用的业务简单处理等。为了简单起见，一些与事务无关的代码也在这里编写。\n- Service 层：相对具体的业务逻辑服务层。\n- Manager 层：通用业务处理层，它有如下特征：\n  - 1） 对第三方平台封装的层，预处理返回结果及转化异常信息，适配上层接口。\n  - 2） 对 Service 层通用能力的下沉，如缓存方案、中间件通用处理。\n  - 3） 与 DAO 层交互，对多个 DAO 的组合复用。\n- Mapper持久层：数据访问层，与底层 MySQL进行数据交互。\n- Listener：监听 `RocketMQ` 进行处理，有时候会监听`easyexcel`相关数据。\n\n关于`FeignClient`，由于微服务之间存在互相调用，`Feign` 是http协议，理论上是为了解耦，而实际上提供方接口进行修改，调用方却没有进行修改的时候，会造成异常，所以我们抽取出来。还有就是对内暴露的接口，是很多地方都公用的，所以我们还将接口抽取了出了一个模块，方便引用。可以看到`mall4cloud-api`这个模块下是所有对内`feign`接口的信息。\n\n## 目录结构\n\n```\nmall4cloud\n├─mall4cloud-api -- 内网接口\n│  ├─mall4cloud-api-auth  -- 授权对内接口\n│  ├─mall4cloud-api-biz  -- biz对内接口\n│  ├─mall4cloud-api-leaf  -- 美团分布式id生成接口\n│  ├─mall4cloud-api-multishop  -- 店铺对内接口\n│  ├─mall4cloud-api-order  -- 订单对内接口\n│  ├─mall4cloud-api-platform  -- 平台对内接口\n│  ├─mall4cloud-api-product  -- 商品对内接口\n│  ├─mall4cloud-api-rbac  -- 用户角色权限对内接口\n│  ├─mall4cloud-api-search  -- 搜索对内接口\n│  └─mall4cloud-api-user  -- 用户对内接口\n├─mall4cloud-auth  -- 授权校验模块\n├─mall4cloud-biz  -- mall4cloud 业务代码。如图片上传/短信等\n├─mall4cloud-common -- 一些公共的方法\n│  ├─mall4cloud-common-cache  -- 缓存相关公共代码\n│  ├─mall4cloud-common-core  -- 公共模块核心（公共中的公共代码）\n│  ├─mall4cloud-common-database  -- 数据库连接相关公共代码\n│  ├─mall4cloud-common-order  -- 订单相关公共代码\n│  ├─mall4cloud-common-product  -- 商品相关公共代码\n│  ├─mall4cloud-common-rocketmq  -- rocketmq相关公共代码\n│  └─mall4cloud-common-security  -- 安全相关公共代码\n├─mall4cloud-gateway  -- 网关\n├─mall4cloud-leaf  -- 基于美团leaf的生成id服务\n├─mall4cloud-multishop  -- 商家端\n├─mall4cloud-order  -- 订单服务\n├─mall4cloud-payment  -- 支付服务\n├─mall4cloud-platform  -- 平台端\n├─mall4cloud-product  -- 商品服务\n├─mall4cloud-rbac  -- 用户角色权限模块\n├─mall4cloud-search  -- 搜索模块\n└─mall4cloud-user  -- 用户服务\n```\n\n## 商城部署后 API 地址\n\n| 服务                                                 | 地址                    |\n| ---------------------------------------------------- |-----------------------|\n| mall4cloud-gatway 网关服务                           | http://127.0.0.1:8000 |\n| mall4cloud-auth  授权校验服务                        | http://127.0.0.1:9101 |\n| mall4cloud-biz     业务代码服务（如图片上传/短信等） | http://127.0.0.1:9000 |\n| mall4cloud-leaf   基于美团leaf的生成id服务           | http://127.0.0.1:9100 |\n| mall4cloud-multishop 商家服务                        | http://127.0.0.1:9103 |\n| mall4cloud-order         订单服务                    | http://127.0.0.1:9106 |\n| mall4cloud-payment   支付服务                        | http://127.0.0.1:9113 |\n| mall4cloud-product    商品服务                       | http://127.0.0.1:9104 |\n| mall4cloud-rbac          用户角色服务                | http://127.0.0.1:9102 |\n| mall4cloud-search      搜索服务                      | http://127.0.0.1:9108 |\n| mall4cloud-user          用户服务                    | http://127.0.0.1:9105 |\n\n\n\n## 部署教程\n\n部署教程请参考 [环境搭建](doc/2-环境搭建/README.md) 和 [中间件 Docker Compose](doc/8-部署运维/2-中间件-docker-compose/README.md)。\n\n## 代码运行相关截图\n\n### 1.后台截图\n\n- 平台端\n\n  ![](doc/img/readme/image-20231130110607548.png)\n\n- 商家端\n\n  ![image-20210705151729559](doc/img/readme/image-20231130112350296.png)\n\n  ![image-20210705151847270](doc/img/readme/image-20231130112429089.png)\n\n### 2.小程序截图\n\n![小程序-1625472143277](doc/img/readme/小程序.png)\n\n### 3.uni-app截图\n\n![uniapp-1625469707350](doc/img/readme/uniapp.png)\n\n\n## 提交反馈\n- mall4cloud开源技术QQ群：561496886\n- Mall4j 商城官网：[https://www.mall4j.com](https://www.mall4j.com)\n\n## 支持项目\n如果这个项目对你有帮助，欢迎 Star、Fork 和提交 Issue。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgz-yami%2Fmall4cloud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgz-yami%2Fmall4cloud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgz-yami%2Fmall4cloud/lists"}