环境搭建

版本：v3.0 ｜ 最后更新：2026-07 ｜ 文档状态：已同步代码

从零开始搭建本地开发环境，让项目跑起来。

---

前置条件

你需要安装以下软件：

软件	版本要求	用途	下载地址
JDK	17+	运行后端	Oracle 或 Adoptium
Maven	3.8+	编译后端	maven.apache.org
Node.js	18+	运行前端	nodejs.org
MySQL	8.0	数据库	mysql.com
Redis	最新	缓存服务	redis.io
MongoDB	最新	商品收藏 / 浏览历史（前台必需）	mongodb.com

⚠️ MongoDB 不可省略：mall-portal 依赖 spring-boot-starter-data-mongodb，未启动 MongoDB 时前台商城服务无法启动（收藏、浏览历史功能即基于 MongoDB）。

第一步：初始化数据库

1. 启动 MySQL 服务
2. 创建数据库 mall，用户名 root，密码 123456
3. 导入数据库脚本：

mysql -u root -p123456 mall < docs/sql/mall.sql

这个脚本会创建全部数据库表并插入基础数据。表数量以 docs/dev/context.md 第 3.1 节「关键数字」为准（该节是唯一权威来源）。

第二步：启动 Redis 与 MongoDB

Redis（缓存 / 验证码 / 登录锁定）：

redis-server

默认监听 localhost:6379，无需额外配置。

MongoDB（收藏 / 浏览历史）：

mongod

默认监听 localhost:27017，无需额外配置。

第三步：启动后端服务

需要启动两个后端服务：

后台管理服务（端口 8080）：

cd mall-admin
mvn spring-boot:run

前台商城服务（端口 8085）：

cd mall-portal
mvn spring-boot:run

两个服务需要同时运行。先编译整个项目：mvn compile -q

第四步：启动前端

cd mall-admin-web
npm install
npm run dev

启动后访问 http://localhost:5173 即可看到后台管理界面。

第五步：登录测试

端	地址	账号	密码
后台管理	http://localhost:5173	admin	macro123
前台商城	http://localhost:5173/portal	需先注册	—

---

常见问题

端口被占用

• 8080：检查是否有其他 Tomcat 服务
• 8085：检查是否有其他服务占用
• 3306：MySQL 默认端口
• 6379：Redis 默认端口
• 27017：MongoDB 默认端口

数据库连接失败

检查 application.yml 中的数据库配置：

• 地址：localhost:3306
• 用户名：root
• 密码：123456
• 数据库名：mall

前端页面空白

• 检查后端服务是否已启动（8080 和 8085）
• 打开浏览器控制台查看是否有红色报错
• 确认 Vite 代理配置正确