You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

IntelliJ IDEA运行RuoYi-Cloud报Nacos连接错误,咨询项目启动步骤

问题根因

你的报错本质是服务启动时无法连接本地8848/9848端口的Nacos服务,RuoYi-Cloud属于微服务架构项目,必须先启动Nacos、MySQL、Redis等依赖中间件,再启动业务服务,否则就会出现该类连接异常。

本地正常运行完整步骤

方式一:使用项目内置Docker配置启动(推荐,省去手动安装配置中间件的成本)

  • 首先确保本地已经安装并正常启动Docker Desktop
  • 打开终端进入你克隆好的RuoYi-Cloud项目根目录,进入docker文件夹:cd docker
  • 执行中间件批量启动命令:docker-compose up -d mysql redis nacos
  • 等待1~2分钟待所有容器启动完成后,访问http://localhost:8848/nacos,使用默认账号密码nacos/nacos确认可以正常登录,即代表中间件启动正常
  • 把项目根目录下的SQL脚本(通常为ry_xxxx.sql、ry_config.sql两个文件)导入到Docker启动的MySQL实例中,默认MySQL连接信息为端口3306、账号root、密码root,具体可以查看docker-compose配置文件确认
  • 回到IntelliJ IDEA,按顺序启动微服务模块:先启动ruoyi-auth认证服务,再启动ruoyi-modules-system、ruoyi-modules-gen、ruoyi-modules-job等业务模块,最后启动前端项目即可正常访问系统

方式二:手动安装启动中间件

  • 自行安装JDK1.8、MySQL5.7/8.0、Redis3.2+、Nacos2.x版本(必须为2.x系列版本,1.x版本没有9848 gRPC端口,会直接触发你当前的连接错误)
  • 依次启动Redis、MySQL、Nacos,启动完成后确认Nacos控制台可以正常访问,且8848、9848端口没有被其他程序占用
  • 将项目根目录下的SQL脚本导入本地MySQL,修改各微服务模块配置文件中的MySQL、Redis连接地址、账号密码,和你本地配置匹配
  • 按顺序启动各个微服务模块即可
当前报错快速排查点

如果你已经手动安装了Nacos,先检查以下几项:

  • 确认Nacos版本为2.x系列,1.x版本不兼容RuoYi-Cloud的gRPC通信要求
  • 确认Nacos已经正常启动,Windows系统可以执行netstat -ano | findstr 9848命令检查端口是否处于监听状态
  • 确认项目配置文件中的Nacos地址填写正确,默认只需要填127.0.0.1:8848,不需要额外填写9848端口,Nacos2.x会自动完成端口映射

内容的提问来源于stack exchange,提问作者yusuf

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.24 01:15:03