多元版 · 环境搭建文档

多元版环境搭建

SaaS 多商户微服务：compose 拉中间件、导库、环境变量连 Nacos、按序启动、前端打网关。租户与商家隔离由网关、认证和数据层共同保证。本机建议 16G 内存。文中 IP、账号仅为示例。

1. 组件版本

组件	说明
JDK	17
Maven	3.9+
MySQL	8.0
Redis	5.0+
Nacos	与 compose 模板一致
Elasticsearch	7.x
RocketMQ / MongoDB	按中间件清单
Node.js	uni-app 要求 20.19+ 或 22.12+，pnpm ≥ 8
Git / IDEA	IDEA -Xmx2048m；单个微服务可 -Xmx512m

打开 saas 分支 mall4cloud。不必一次开全量服务。

2. 中间件、库、Nacos

用 saas 文档中的 compose（目录名可能为 中间件docker-compse一键安装）拉起 MySQL、Redis、Nacos、ES、MQ、MongoDB、MinIO。把模板 IP 换成自己的机器后：

chmod -R 777 ./rocketmq/broker/logs ./rocketmq/broker/store ./elasticsearch/data
chmod -R 666 ./minio/data
docker compose up -d --build

镜像大约 7G。控制台（模板密码 hn02le.34lkdLKD 必须改掉）：MySQL 3306/root、Redis 6379、Nacos http://IP:8080、XXL-JOB http://IP:8090/xxl-job-admin、MinIO :9001、RocketMQ :8180。监控组件不要暴露公网。

初始化：先导入 job / nacos / seata 脚本，再导入 admin、auth、biz、flow、group、marketing、order、payment、product、seckill、user 等库，并执行 ES 索引脚本。

配置走环境变量：

NACOS_HOST=<地址>
NACOS_PORT=<8848 或 K8s 的 30030>
NACOS_NAMESPACE=<命名空间>
NACOS_PASSWORD=<密码>

按需覆盖：

MALL4CLOUD_PORT=<http端口>
MALL4CLOUD_DUBBO_PORT=<dubbo端口>

不要把示例 IP 全局替换后提交进仓库。多人用不同 namespace，避免互相注册。租户域名可用 hosts 模拟。

3. 启动 Java

IDEA Open 打开工程，等 Maven 结束。

推荐顺序：

1. mall4cloud-gateway
2. mall4cloud-auth
3. mall4cloud-admin（商家、平台、SaaS 超管后台接口）
4. 再按联调需要：product → order → payment → user → marketing → group → seckill → flow → search → biz

验证：Nacos 全部 UP；网关可登录；商品查询可通。内存不足时只开当前链路相关服务。

4. 前端

pnpm install

若不用 pnpm，去掉 preinstall 与 engines.pnpm。

平台、商家、超管、uni-app、PC 的 VITE_APP_BASE_API 一律指向 网关（常见 8000），不要写业务服务端口。

4.1 mall4cloud-uniapp-saas

VITE_APP_BASE_API = 'http://192.168.1.195:8000'
VITE_APP_WEBSOCKET_URL = 'ws://192.168.1.195:8000'
VITE_APP_MP_APPID = '你的公众号appid'

微信内 H5 必须配公众号 appid。小程序 appid 写在 src/manifest.json。

4.2 后台（platform / multishop / admin）

VITE_APP_BASE_API 指向网关；IM 用 VITE_APP_WS_IM_API（ws/wss）。pnpm dev 后用本机 IP + vite 端口访问。

4.3 PC

同样打网关。构建产物按站点放入 Nginx html。