银河版 · 环境搭建文档

银河版环境搭建

本地开发（一般为 Windows）：先装运行时与中间件，再导入数据库、改连接配置，最后分别启动 Java 与前端。文中 IP、账号仅为示例。

1. 组件版本

组件	最低版本
JDK	17
Maven	3.8+
MySQL	8.0
Redis	5.0+
Elasticsearch	7.x
XXL-JOB	3.0.0
Node.js	18.12.0（推荐 20.9.0）
pnpm	≥ 7
Git / IDEA	需安装 Lombok

Redis 默认端口 6379，必须与 application-dev.yml 一致。

2. MySQL

修改 my.cnf / my.ini 后重启：

[mysqld]
default_authentication_plugin=mysql_native_password
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION

克隆 https://git.mall4j.com/b2c/mall4j-pro.git。仓库 db 目录按顺序导入：

1. 0schema.sql
2. 1mall4j_b2c.sql
3. 2area.sql
4. 3xxl_job.sql

其余文件是升级补丁，初始化不要导入。推荐 SQLyog，不建议用 Navicat 做导入导出。

3. 启动 Java

IDEA Open 打开 mall4j-pro，等 Maven 依赖完成。Ctrl+Shift+N 可搜配置文件。

1. 修改各端 application-dev.yml 中的 MySQL、Redis。
2. 下载 XXL-JOB 3.0.0，连接已导入的 job 库，并与后台 yml 中的调度地址一致。
3. 启动 Redis、MySQL、ES、xxl-job-admin；客服需要时再起 WuKongIM。
4. 启动 ApiApplication（用户端 8086）、MultishopApplication（管理端 8087）。

库存、登录 token、秒杀等在 Redis，本地不要 FLUSHALL。多环境共用支付时配置不同 workerId（10–99）：

application:
  workerId: 21

4. 前端（Node + pnpm）

各前端仓库根目录：

pnpm install

若不用 pnpm，需去掉 package.json 里 preinstall: npx only-allow pnpm 以及 engines.pnpm。

本机 Java IP 用 ipconfig 查看（下例 192.168.1.120）。

4.1 mall4uni-pro（H5 / 小程序 / App）

.env.development：

VITE_APP_ENV = 'development'
VITE_APP_BASE_API = 'http://192.168.1.120:8086'
VITE_APP_MP_APPID = '你的公众号appid'

微信内 H5 走公众号 JSAPI 支付与授权，必须配 VITE_APP_MP_APPID。浏览器 H5 走 H5 支付，与前者不是同一套。

小程序 appid 写在 src/manifest.json 的 mp-weixin.appid。H5 端口可改 manifest.json → h5.devServer.port。

运行：HBuilderX「运行到浏览器 / 微信开发者工具」，或仓库提供的 vite 脚本。

4.2 mall4pc-pro

.env.development 的 VITE_APP_BASE_API 指向 http://IP:8086。pnpm dev 启动。

4.3 mall4v-pro（管理后台）

VITE_APP_BASE_API = 'http://192.168.1.120:8087'
VITE_APP_WS_IM_API = 'ws://192.168.1.120:5200'

默认端口见 vite.config.js 的 server.port（常见 9527/9528）。pnpm dev 后用 http://本机IP:端口 访问。