跳转到内容

mall4cloud开发环境搭建

S2B2C 白洞版 · mall4cloud开发环境搭建

示例值注意事项:本文中的 IP、域名、账号、密码等仅为示例,请按你的实际环境替换。

  • 适用于 mall4cloud 后端微服务本地开发、联调、断点调试。
  • 已拉取代码仓库:mall4cloud、mall4cloud-doc。
  • 本机已安装 JDK 17、Maven 3.9+、Git、IDEA。
  • 已准备并可访问中间件(MySQL、Redis、Nacos、RocketMQ、Elasticsearch、MongoDB 等)。
  • 推荐先按 中间件docker-compose一键安装/README.md 拉起中间件。
  • 如果是自建中间件,请确保网络、账号、端口与配置中心一致。
  • 使用 IDEA 打开 mall4cloud 根目录。
  • 等待 Maven 完整索引完成后再启动服务。

当前后端服务 application.yml 默认通过环境变量读取 Nacos 与端口配置,建议优先使用环境变量,不再把“全局替换 IP”作为第一选择。

建议优先配置:

Terminal window
NACOS_HOST=<你的nacos地址>
NACOS_PORT=<你的nacos端口>
NACOS_NAMESPACE=<你的命名空间>
NACOS_PASSWORD=<你的nacos密码>

按需覆盖服务端口:

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

说明:

  • 不设置 MALL4CLOUD_PORT / MALL4CLOUD_DUBBO_PORT 时,服务使用各模块 application.yml 默认端口。
  • “全局替换 IP”仅作为兜底方案(例如历史模板脚本无法参数化时)。

建议先启动:

  1. mall4cloud-gateway
  2. mall4cloud-auth
  3. mall4cloud-admin

再按业务需要启动:

  1. mall4cloud-product
  2. mall4cloud-order
  3. mall4cloud-payment
  4. mall4cloud-user
  5. mall4cloud-marketing
  6. mall4cloud-group
  7. mall4cloud-seckill
  8. mall4cloud-flow
  9. mall4cloud-search
  10. mall4cloud-biz
  • 内存不足时,先按需启动服务,不必一次性全开。
  • 如需定位跨服务调用,优先在网关与目标业务服务同时启动断点。
  • 研发多机并行调试时,建议通过 Nacos 命名空间隔离环境,避免互相污染。
  • gateway 服务启动后可访问基础路由。
  • Nacos 中对应服务实例注册正常。
  • 至少一个业务链路(如登录、商品查询)可联调通过。
  • 可先查看故障排查索引:../../04-故障排查/README.md
  • 当前目录索引:README.md