若依框架（RuoYi）是一个基于Spring Boot、Spring Cloud & Alibaba的微服务架构，下面详细介绍如何使用若依框架搭建微服务项目：

一、环境准备

1. JDK 1.8+
2. Maven 3.0+
3. MySQL 5.7+
4. Redis 3.0+
5. Nacos 2.0+（注册中心和配置中心）
6. Sentinel（熔断限流）
7. Git（代码管理）

二、下载若依微服务版

1. 访问 若依官网 或 GitHub 仓库：

   git clone https://gitee.com/y_project/RuoYi-Cloud.git
   cd RuoYi-Cloud
   

2. 导入项目到 IDE（如 IntelliJ IDEA）。

三、数据库配置

1. 创建数据库：

   CREATE DATABASE ry_cloud DEFAULT CHARACTER SET utf8mb4;
   CREATE DATABASE ry_config DEFAULT CHARACTER SET utf8mb4;
   

2. 导入 SQL 脚本：

   • sql/ry_2023xxxx.sql → ry_cloud 数据库
   • sql/ry_config_2023xxxx.sql → ry_config 数据库

四、配置 Nacos

1. 下载并启动 Nacos：

   wget https://github.com/alibaba/nacos/releases/download/2.1.0/nacos-server-2.1.0.tar.gz
   tar -xvf nacos-server-2.1.0.tar.gz
   cd nacos/bin
   sh startup.sh -m standalone  # Linux/Mac
   cmd startup.cmd -m standalone  # Windows
   

   访问：http://localhost:8848/nacos
   用户名/密码：nacos/nacos

2. 配置 Nacos 数据源：
   修改 nacos/conf/application.properties，添加 MySQL 配置：

   spring.datasource.platform=mysql
   db.num=1
   db.url.0=jdbc:mysql://localhost:3306/ry_config?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
   db.user=root
   db.password=root
   

五、修改若依配置

1. 配置 ruoyi-gateway：
   修改 application.yml，指定 Nacos 地址：

   spring:
     cloud:
       nacos:
         discovery:
           server-addr: localhost:8848
   

2. 配置 ruoyi-auth：
   修改 application.yml，配置 Redis 和数据库连接：

   spring:
     datasource:
       url: jdbc:mysql://localhost:3306/ry_cloud?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
       username: root
       password: root
     redis:
       host: localhost
       port: 6379
   

3. 配置 ruoyi-system：
   同样修改数据库和 Redis 配置。

六、启动服务

1. 按顺序启动服务：

   1. Nacos
   2. Redis
   3. MySQL
   4. Sentinel（可选）
   5. 微服务模块：

      ruoyi-gateway → ruoyi-auth → ruoyi-system → ruoyi-generator → ...
      

2. 验证服务注册：
   访问 Nacos 控制台，查看服务列表是否包含已启动的微服务。

七、前端配置

1. 安装 Node.js 和 npm
2. 配置前端项目：

   cd ruoyi-ui
   npm install --registry=https://registry.npm.taobao.org
   npm run dev
   

3. 访问前端：http://localhost:80
   用户名/密码：admin/admin123

八、扩展与开发

1. 新增微服务模块：

   • 创建 ruoyi-module-xxx 模块，继承公共依赖。
   • 编写业务代码，注册到 Nacos。
   • 在 ruoyi-gateway 中配置路由。

2. 代码生成器：
   通过 ruoyi-generator 自动生成 CRUD 代码，提高开发效率。

3. 权限控制：
   使用 @PreAuthorize 注解控制接口访问权限。

九、常见问题

1. 服务无法注册到 Nacos：

   • 检查 Nacos 地址配置。
   • 确保 Nacos 服务正常运行。

2. 数据库连接失败：

   • 检查数据库地址、用户名和密码。
   • 确认数据库表结构已正确导入。

3. 前端跨域问题：
   在 ruoyi-gateway 中配置 CORS 策略。

十、项目结构概览

RuoYi-Cloud/
├── ruoyi-admin/            # 后台管理模块
├── ruoyi-auth/             # 认证授权模块
├── ruoyi-common/           # 公共模块
│   ├── common-core/        # 核心工具类
│   ├── common-datascope/   # 数据权限
│   ├── common-log/         # 日志记录
│   └── ...
├── ruoyi-framework/        # 框架核心
├── ruoyi-gateway/          # API网关
├── ruoyi-generator/        # 代码生成器
├── ruoyi-modules/          # 业务模块
│   ├── ruoyi-system/       # 系统模块
│   ├── ruoyi-quartz/       # 定时任务
│   └── ...
├── ruoyi-ui/               # 前端项目
└── sql/                    # SQL脚本

总结

若依框架提供了开箱即用的微服务架构，通过 Nacos 实现服务注册与配置管理，使用 Sentinel 进行流量控制，集成了权限认证和代码生成器。建议先从基础模块（网关、认证、系统）入手，熟悉架构后再扩展业务模块。