mall 本地环境搭建思路：依赖服务与启动顺序

mall 的模块比较多，第一次在本地跑起来，通常不是代码问题，而是依赖服务没准备好、配置没对上。这篇按「依赖 → 配置 → 启动」的顺序整理思路，具体版本与命令仍以官方文档为准。

环境清单

在开始之前，先确认本地具备以下环境：

• JDK 与 Maven：用于编译和运行后端模块；
• MySQL：业务数据库；
• Redis：缓存；
• MongoDB：部分文档型数据；
• Elasticsearch：商品搜索相关功能；
• Node.js：仅在需要构建前端工程时使用；
• IDE：IntelliJ IDEA 等 Java IDE，便于按模块启动。

获取代码与初始化数据库

从官方仓库克隆代码：

git clone https://github.com/macrozheng/mall.git

数据库初始化脚本通常随仓库提供。按仓库文档创建数据库并导入 SQL，注意字符集设置，避免中文数据出现乱码。

如果文档中的脚本路径与仓库当前结构不一致，以仓库内实际文件为准，不要直接照搬旧教程。

修改配置

后端各模块的配置文件一般位于 src/main/resources 下。需要重点确认：

1. MySQL 连接地址、库名、用户名与密码；
2. Redis 地址与端口；
3. MongoDB 连接串；
4. Elasticsearch 地址；
5. 文件上传目录与静态资源访问路径。

多模块项目容易出现「只改了一个模块的配置」的情况，启动前建议全局搜索数据源配置，确认没有遗漏。

启动顺序

推荐顺序：

1. 先启动 MySQL、Redis、MongoDB、Elasticsearch，并确认各自端口可访问；
2. 启动后台管理相关模块；
3. 启动前台商城相关模块；
4. 最后启动或构建前端工程，并配置接口代理地址。

如果使用 IDE，可以按模块分别启动；也可以先执行 Maven 构建，再运行对应的启动类。端口冲突时修改对应模块的 server.port。

常见问题排查

启动报数据库连接失败：确认数据库已启动、账号有权限、连接串中的库名正确。

Elasticsearch 相关功能报错：确认版本兼容性与索引是否已初始化，部分功能依赖预先创建索引。

前端请求 404 或跨域：检查前端代理配置与后端接口前缀是否一致。

上传文件无法访问：确认上传目录存在且有写权限，同时检查静态资源映射配置。

中文乱码：检查数据库、连接串与表的字符集设置。

下一步

本地跑通之后，下一步通常是评估部署方式与业务改造范围。可以查看 mall 项目详情，或了解 部署协助服务 与 二次开发服务 的工作方式。