Windows环境下使用Nacos搭建若依(RuoYi)微服务版完整指南

一、环境准备

1.1 所需软件版本

软件	版本	下载方式
JDK	JDK17	`https://pan.baidu.com/s/1Qfw0OELcq44vY4In0QKBkg?pwd=g1rw`
Nacos	2.4.3	`https://pan.baidu.com/s/1Ew6JubRzkCxSK0zijF1qtg?pwd=eud6`
RuoYi-Cloud	SpringBoot3 & JDK17版	`https://pan.baidu.com/s/1mAkr1qcQvqxkrIOkwKfd3A?pwd=2sgg`
修改器		`https://pan.baidu.com/s/1a5nbXZZudq9cmxVx5CxKuA?pwd=f9iu`

1.2 JDK17环境配置

如果启动Nacos时提示需要JDK8，说明JDK17环境变量配置不正确：

配置步骤：

右键点击"此电脑" → "属性" → "高级系统设置" → "环境变量"
在系统变量区域，点击"新建"：
变量名：JAVA_HOME
变量值：JDK 17 的安装路径（如：D:\Java\jdk-17，注意不要包含bin目录）
编辑"系统变量"中的Path变量：
点击"新建" → 添加 %JAVA_HOME%\bin
建议将该条目移动到Path列表的最上方，确保系统优先识别JDK17
验证配置：
打开CMD，执行以下命令
java -version
应显示JDK 17相关信息

二、数据库初始化

2.1 创建数据库

-- 创建系统数据库
CREATE DATABASE IF NOT EXISTS ry-cloud DEFAULT CHARACTER SET utf8mb4;

-- 创建配置数据库（供Nacos使用）
CREATE DATABASE IF NOT EXISTS ry-config DEFAULT CHARACTER SET utf8mb4;

2.2 导入SQL文件

按顺序执行以下SQL文件：

ry_20250523.sql- 系统基础数据表
ry_config_20250902.sql- Nacos配置数据表

三、Nacos配置与启动

3.1 配置MySQL数据源

编辑nacos/conf/application.properties文件：

复制代码

## 数据源平台
spring.datasource.platform=mysql

## 数据库实例数量
db.num=1

## 数据库连接配置
db.url.0=jdbc:mysql://127.0.0.1:3306/ry-config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
db.user.0=root
db.password.0=你的密码

## 连接池配置
db.pool.config.driverClassName=com.mysql.cj.jdbc.Driver
db.pool.config.connectionTestQuery=SELECT 1

3.2 启动Nacos

在Nacos的bin目录下打开CMD，使用单机模式启动
startup.cmd -m standalone

3.3 验证Nacos启动

启动成功后，访问：http://localhost:8848/nacos

默认用户名：nacos
默认密码：nacos

四、若依微服务项目启动

4.1 项目结构说明

RuoYi-Cloud/

├── ruoyi-gateway/ # 网关模块

├── ruoyi-auth/ # 认证模块

├── ruoyi-system/ # 系统模块

├── ruoyi-xxx/ # 其他业务模块

└── sql/ # 数据库文件

4.2 修改配置文件

检查各个服务的bootstrap.yml文件，确保Nacos地址配置正确：

java 复制代码

spring:
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848

确认数据库连接配置与本地环境一致

4.3 启动顺序

按照以下顺序启动服务：

Gateway模块 - 网关服务
Auth模块 - 认证服务
System模块 - 系统服务
其他业务模块

启动方式：

IDE启动：直接运行各模块的xxxApplication.java主类
命令行启动：mvn spring-boot:run

五、前端项目启动

5.1 环境检查

查看Node.js版本：node -v
建议版本：v22.16.0+

5.2 安装依赖并启动

进入前端项目目录：cd ruoyi-ui
安装依赖（首次运行或依赖变更时执行）：npm install
启动开发服务器:npm run dev

5.3 访问系统

前端启动成功后，访问：http://localhost:80
默认用户名：admin
默认密码：admin123

六、常见问题排查

6.1 Nacos启动失败

JDK版本问题：确认JAVA_HOME指向JDK17
端口占用：检查8848端口是否被占用
数据库连接失败：检查MySQL服务是否启动，数据库连接配置是否正确

6.2 服务注册失败

检查Nacos服务是否正常运行
确认bootstrap.yml中Nacos地址配置正确
查看服务日志，排查网络连接问题

6.3 前端启动失败

Node.js版本不符：使用nvm管理多版本Node.js
依赖安装失败：尝试清除缓存后重新安装：

java 复制代码

npm cache clean --force
rm -rf node_modules
npm install

七、高级技巧

7.1 使用Nacos配置管理

在Nacos控制台可以：

动态修改配置文件，实时生效
配置多环境（dev/test/prod）
配置回滚和历史版本管理

7.2 服务监控

访问Nacos控制台的服务列表，可以：

查看服务健康状态
管理服务实例
配置服务权重和元数据

八、总结

通过以上步骤，您已成功在Windows环境下搭建了基于Nacos的若依微服务系统。这套架构为企业级应用提供了：

✅ 服务注册与发现 - 通过Nacos统一管理

✅ 配置中心 - 集中化管理所有微服务配置

✅ API网关 - 统一入口和流量管理

✅ 前后端分离 - 现代化开发架构

后续可以根据业务需求，继续扩展其他微服务模块，充分利用Spring Cloud Alibaba生态体系。