跨境多商户版 · 环境搭建文档

跨境多商户版环境搭建

本地开发（一般为 Windows）：先装运行时与中间件，再导入数据库、改连接配置，最后分别启动 Java 与前端。跨境多商户是 B2B2C 单体 + 跨境能力，用户 / 商家 / 平台三端联调。开发环境不要接生产支付与报关。文中 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

打开 mall4j-cbec-bbc。仓库 db 目录按顺序导入：

0schema.sql
编号 1 的主库脚本
2area.sql
3xxl_job.sql

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

3. 启动 Java

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

修改 yami-shop-api / yami-shop-multishop / yami-shop-platform 的 application-dev.yml 中 MySQL、Redis。
下载 XXL-JOB 3.0.0，连接已导入的 job 库，并与后台 yml 中的调度地址一致。
启动 Redis、MySQL、ES、xxl-job-admin；客服需要时再起 WuKongIM。
启动三个入口：

入口	默认端口
`ApiApplication`	8086 用户端
`MultishopApplication`	8087 商家端
`PlatformApplication`	8088 平台端

库存、登录 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-cbec-bbc（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 支付，与前者不是同一套。确认 lang 语言包。

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

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

4.2 mall4pc-cbec-bbc

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

4.3 mall4vs-cbec-bbc / mall4vp-cbec-bbc

# 商家 8087，平台改为 8088
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。pnpm dev 后用 http://本机IP:端口 访问。商家移动端 mall4ms-cbec-bbc 同样指向商家接口。