快速开始
本指南将帮助你启动直播电商管理系统的完整开发环境，包括后端服务、用户端前端和管理后台。
前提条件
- 已完成 环 境安装 中的所有步骤
- MySQL 8.0 服务运行中，已导入初始化 SQL
- Redis 6.x 服务运行中
- Node.js 16+ 已安装
- Maven 3.6+ 已安装
项目结构
live-mall/
├── ruoyi-live-mall-service-v2/ # 后端服务（Spring Boot）
│ ├── yudao-server/ # 主启动模块
│ ├── yudao-framework/ # 基础框架
│ ├── yudao-module-mall/ # 商城模块
│ ├── yudao-module-member/ # 会员模块
│ ├── yudao-module-live/ # 直播模块
│ ├── yudao-module-pay/ # 支付模块
│ ├── yudao-module-museum/ # 博物馆模块
│ ├── yudao-module-system/ # 系统模块
│ └── script/ # 部署脚本
├── live-mall-uniapp/ # 用户端（uni-app）
└── yudao-ui-admin-vue3/ # 管理后台（Vue 3）
一、启动后端服务
1. 修改配置
编辑 ruoyi-live-mall-service-v2/yudao-server/src/main/resources/application-local.yaml，确认数据库和 Redis 连接信息：
spring:
datasource:
dynamic:
datasource:
master:
url: jdbc:mysql://127.0.0.1:3306/ruoyi-vue-pro?useSSL=false&serverTimezone=Asia/Shanghai
username: root
password: 123456
redis:
host: 127.0.0.1
port: 6379
database: 0
2. 编译项目
cd ruoyi-live-mall-service-v2
mvn clean install -Dmaven.test.skip=true
首次编译会下载大量依赖，请耐心等待。
3. 启动服务
cd yudao-server
mvn spring-boot:run
或者在 IDE 中直接运行 YudaoServerApplication.java 的 main 方法。
4. 验证启动
启动成功后，访问以下地址：
| 地址 | 说明 |
|---|---|
| http://localhost:48080 | 后端 API 根路径 |
| http://localhost:48080/swagger-ui | Swagger API 文档 |
| http://localhost:48080/doc.html | Knife4j API 文档（推荐） |
二、启动用户端（uni-app）
用户端基于 uni-app 开发，支持编译到微信小程序、H5、App 多端。
1. 安装依赖
cd live-mall-uniapp
npm install
# 或使用 pnpm
pnpm install
2. 配置 API 地址
编辑 .env 文件（或对应环境配置文件），设置后端 API 地址：
VITE_API_URL=http://localhost:48080
3. 启动开发服务器
H5 模式（浏览器访问）：
npm run dev:h5
启动后访问终端输出的地址（通常为 http://localhost:5173）。
微信小程序：
npm run dev:mp-weixin
编译完成后，使用微信开发者工具导入 dist/dev/mp-weixin 目录。
App 模式：
使用 HBuilderX 打开项目，选择" 运行 → 运行到手机或模拟器"。
4. 目录说明
live-mall-uniapp/src/
├── common/http/ # HTTP 请求封装
├── components/ # 全局组件（c- 前缀）
├── pages/ # 页面（含分包）
├── services/apis/ # API 接口调用
├── store/ # Pinia 状态管理
└── utils/ # 工具函数
三、启动管理后台
管理后台基于 Vue 3 + Ant Design Vue 开发。
1. 安装依赖
cd yudao-ui-admin-vue3
npm install
# 或使用 pnpm
pnpm install
2. 启动开发服务器
npm run dev
3. 访问管理后台
启动后访问 http://localhost:5173（或终端输出的地址）。
默认管理员账号：
| 用 户名 | 密码 |
|---|---|
| admin | admin123 |
四、Docker 快速体验
如果你不想手动安装环境，可以使用 Docker 一键启动：
# 1. 克隆项目
git clone <项目仓库地址>
cd ruoyi-live-mall-service-v2
# 2. 构建 JAR 包
docker volume create --name yudao-maven-repo
docker run -it --rm --name yudao-maven \
-v yudao-maven-repo:/root/.m2 \
-v $PWD:/usr/src/mymaven \
-w /usr/src/mymaven \
maven mvn clean install package '-Dmaven.test.skip=true'
# 3. 启动所有服务
cd script/docker
docker compose --env-file docker.env up -d
等待所有容器启动完成后：
| 服务 | 地址 |
|---|---|
| 管理后台 | http://localhost:8080 |
| 后端 API | http://localhost:48080 |
| API 文档 | http://localhost:48080/doc.html |
常见问题
后端启动失败
问题：数据库连接失败
解决方案：
1. 确认 MySQL 服务已启动
2. 检查 application-local.yaml 中的数据库连接信息
3. 确认数据库 ruoyi-vue-pro 已创建并导入 SQL
问题：Redis 连接超时
解决方案：
1. 确认 Redis 服务已启动
2. 检查 Redis 端口（默认 6379）和密码配置
3. 使用 redis-cli ping 测试连接
前端启动失败
问题：npm install 报错
解决方案：
1. 清除 npm 缓存：npm cache clean --force
2. 删除 node_modules 后重新安装
3. 检查 Node.js 版本是否满足要求（16+）
问题：API 请求 404 或跨域
解决方案：
1. 确认后端服务已启动（http://localhost:48080）
2. 检查前端 .env 文件中的 VITE_API_URL 配置
3. H5 开发模式下，前端通过 Vite 代理转发请求到后端
小程序调试
问题：微信开发者工具中请求失败
解决方案：
1. 在微信开发者工具中勾选「不校验合法域名」
2. 确认后端 API 地址为 http://127.0.0.1:48080（非 localhost）
3. 小程序中 localhost 指向设备本身，需使用 IP 地址
下一步
sidebar_position: 3 title: 快速开始
快速开始
本指南将帮助你在 5 分钟内启动直播电商管理系统的开发环境。
前提条件
- 已完成 环境安装 中的所有步骤
- MySQL 8.0 服务运行中
- Redis 7.x 服务运行中
- Node.js 18+ 已安装
快速启动
# 克隆项目
git clone https://github.com/jiudi-tech/jiudi-ecommerce.git
# 启动后端
cd jiudi-ecommerce-server
mvn spring-boot:run
# 启动前端
cd ../jiudi-ecommerce-admin
npm install
npm run dev
启动后访问 http://localhost:5173 即可看到管理后台页面。