springCloud集成nacos启动时报错原因排查

这里是“springCloud集成nacos启动时报错原因排查”的完整攻略。

1. 确认nacos服务是否正常启动

在使用nacos作为注册中心时，首先要确认的是nacos服务是否正常启动。可以通过访问nacos的管理页面，在“Server Status”页面查看是否“Server Status”为“UP”，如果不是则需要确认服务配置和启动是否正确。

2. 确认nacos客户端依赖是否正确引入

在使用nacos作为注册中心时，需要在springCloud项目中添加nacos客户端依赖。需要确认的是，在pom.xml文件中是否正确引入了nacos相关依赖，并且版本是否与nacos服务端版本一致。示例：

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>2.1.0.RELEASE</version>
</dependency>

3. 确认nacos配置是否正确

在使用nacos作为配置中心时，需要在nacos服务中添加对应的配置项。需要确认的是，nacos服务中的配置项与应用中使用的配置项名称和分组是否一致，并且是否有对应的值。示例：

在nacos服务中，添加配置项：

Data ID: example
Group: DEFAULT_GROUP
Content: example.config=value

在应用中，使用配置项：

spring:
  application:
    name: example
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848
      config:
        server-addr: localhost:8848
        file-extension: yaml
        group: DEFAULT_GROUP
        timeout: 3000
        prefix: ${spring.application.name}

4. 确认nacos服务地址是否正确

在使用nacos作为注册中心和配置中心时，需要在应用中配置nacos服务的地址。需要确认的是，nacos服务地址是否正确，并且网络通畅。示例：

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

5. 确认springCloud版本是否正确

在使用nacos作为注册中心时，需要确认springCloud的版本是否兼容nacos客户端依赖。示例：

正确配置springCloud和nacos客户端依赖版本：

<!-- SpringCloud Hoxton.SR6-->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-dependencies</artifactId>
      <version>Hoxton.SR6</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<!-- nacos客户端依赖 -->
<dependency>
  <groupId>com.alibaba.cloud</groupId>
  <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

示例

示例1：nacos服务连接超时

在启动springCloud项目时，出现如下错误日志：

com.alibaba.nacos.api.exception.NacosException: io.netty.channel.AbstractChannel$AnnotatedConnectException: Connection timed out: no further information: localhost/127.0.0.1:8848
    at com.alibaba.nacos.client.naming.net.NamingProxy.connect(NamingProxy.java:137) ~[na:na]
    at com.alibaba.nacos.client.naming.net.NamingProxy.request(NamingProxy.java:339) ~[na:na]
    at com.alibaba.nacos.client.naming.net.NamingProxy.request(NamingProxy.java:328) ~[na:na]

这个错误是nacos服务连接超时，需要确认的是nacos服务是否启动，以及本地网络是否正常。

示例2：nacos配置项不存在