🚀 从零搭建私域电商中台：RuoYi-Vue + UniApp 环境部署全指南

摘要：想拥有一套属于自己的私域电商系统？本文将手把手教你基于开源项目“迭代猫微商城”搭建一套功能完备的电商中台。我们将聚焦于后端环境配置与管理后台部署，从 MySQL、Redis 的安装到 Spring Boot 后端的启动，再到 Vue 管理后台的上线，带你避开环境搭建的那些坑，快速构建起你的电商业务指挥中心。

---

🎯 为什么选择这套架构？

对于中小企业或个人开发者而言，选择一套成熟、易扩展的技术栈至关重要。本项目（迭代猫私域微商城）采用经典的 RuoYi-Vue 前后端分离架构，具备以下优势：

• 成熟稳定：基于 Spring Boot 2.5 + Vue 2.6，生态丰富，文档齐全。
• 功能强大：不仅包含商品、订单等基础电商功能，还集成了会员管理、营销工具及多商户支持。
• 易于二开：代码结构清晰，模块化设计，非常适合作为企业级项目的基石。

本文将重点聚焦于后端服务与管理后台的搭建，助你快速跑通核心业务流程。

---

🛠️ 第一步：环境准备（基石）

在开始之前，请确保你的开发环境满足以下要求。这些是系统运行的基础设施。

1. JDK 1.8+

后端服务基于 Java 开发，请安装 JDK 8 或更高版本，并配置好 JAVA_HOME 环境变量。

💡 检查命令：java -version

2. MySQL 8.0 (兼容 5.7)

数据存储的核心。推荐使用 MySQL 8.0 以获得更好的性能，但也完全兼容 5.7 版本。

• 配置建议：设置字符集为 utf8mb4，以支持 Emoji 表情存储。

3. Redis 6.x

用于缓存、Session 共享及分布式锁。

• 注意：Windows 环境下可下载绿色版 Redis 运行。

4. Node.js 14.x +

前端管理后台基于 Vue CLI 构建，需要 Node.js 环境。

💡 检查命令：node -v / npm -v

5. Maven 3.6+

Java 项目构建工具，建议配置阿里云镜像源以加速依赖下载。

---

⚙️ 第二步：后端服务部署（核心）

后端是整个系统的“大脑”，负责处理业务逻辑与数据交互。

1. 获取源码

首先，将项目克隆到本地：

• GitCode: https://gitcode.com/dreamyy/iterativecat-ruoyi-shop.git
• Gitee: https://gitee.com/xjkvbnwe/iterativecat-ruoyi-shop

2. 数据库初始化

找到项目根目录下的 sql 文件夹，按顺序执行以下 SQL 脚本：

1. ry_vue.sql：系统基础表（用户、角色、菜单等）。
2. ecommerce_tables.sql：电商业务表（商品、订单、购物车等）。
3. (可选) 其他 quartz.sql 等脚本根据需求导入。

3. 修改配置

打开 ruoyi-admin/src/main/resources/application-druid.yml，配置你的数据库连接信息：

spring:
  datasource:
    druid:
      master:
        url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
        username: root  # 你的数据库账号
        password: password # 你的数据库密码

同时检查 application.yml 中的 Redis 配置是否正确。

4. 启动服务

在 IDE（如 IntelliJ IDEA）中打开项目，找到 ruoyi-admin 模块下的 RuoYiApplication.java，右键点击 Run。

• 看到 (♥◠‿◠)ﾉﾞ 若依启动成功 ლ(´ڡლ)ﾞ字样，说明后端已成功启动，默认运行在8080` 端口。

---

💻 第三步：管理后台搭建（指挥中心）

管理后台是运营人员的操作界面，基于 Vue + Element UI 打造。

1. 进入前端目录

在命令行中进入 ruoyi-ui 目录：

cd ruoyi-ui

2. 安装依赖

建议使用 npm 或 yarn 安装依赖。

npm install --registry=https://registry.npmmirror.com

💡 提示：如果遇到 node-sass 安装失败，可尝试使用 cnpm 或检查 Node 版本是否过高（推荐 Node 14）。

3. 启动开发服务

npm run dev

启动成功后，浏览器会自动打开 http://localhost:80（或你配置的端口）。

4. 登录体验

• 默认账号：admin
• 默认密码：admin123

进入后台后，你可以看到功能完善的仪表盘，以及左侧丰富的菜单栏，包括：

• 商品管理：发布商品、规格管理、分类设置。
• 订单管理：查看订单详情、发货、售后处理。
• 营销管理：配置优惠券、活动等。
• 系统管理：用户权限、角色分配、日志监控。

---

🔧 常见问题与避坑指南

Q1: 启动后端报“Redis连接失败”？

A: 请检查 Redis 服务是否已启动，以及 application.yml 中的 Redis 密码、端口配置是否正确。

Q2: 前端验证码图片加载不出来？

A: 这通常是后端接口请求失败导致的。

1. 检查后端服务是否正常启动。
2. 检查 ruoyi-ui/vue.config.js 中的 proxy 代理配置，确保指向了正确的后端地址（默认为 http://localhost:8080）。

Q3: 图片上传失败？

A: 本项目集成了腾讯云 COS。你需要去腾讯云控制台开通 COS 服务，并在后台配置正确的 SecretId、SecretKey 和 Bucket 信息。

---

🌈 结语

通过以上步骤，你已经成功在本地搭建起了一套功能完备的私域电商中台。接下来，你可以尝试连接小程序端，或者深入研究代码进行二次开发。

如果你在部署过程中遇到任何问题，欢迎加入我们的开发者社群交流！

• 项目源码：GitCode / Gitee
• 技术文档：项目根目录包含详细文档

迭代猫私域微商城 —— 让技术服务于商业，让开发变得更简单！