Spring Gateway集成 Nacos注册中心不能够发现服务的解决方案

更新时间：2026年01月09日 10:13:48 作者：冯立彬

文章描述了在将Eureka替换为Nacos后,Spring Cloud Gateway在调用Nacos注册的服务时出现问题,通过调试和分析,发现Spring Cloud Gateway在初始化时没有正确加载Nacos的ReactiveDiscoveryClient,导致服务调用失败,感兴趣的朋友跟随小编一起看看吧

一、问题描述

我们现在是在用Nacos替换Eureka，原来Eureka和Spring gateway运行正常，可以通过Spring gateway调用注册到Eureka中的服务。

当前Spring cloud的版本是Hoxton.SR8，Nacos discovery的版本为0.9.0.RELEASE，使用的Nacos版本为2.0.3。

Nacos替换Eureka改动的地方如下：

１、去掉POM中Eureka的引入；

２、去掉主类中引入的@EnableEurekaClient注解；

３、引入Nacos依赖：

<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
  <version>0.9.0.RELEASE</version>
  <exclusions>
    <exclusion>
        <groupId>com.alibaba.nacos</groupId>
        <artifactId>nacos-client</artifactId>
    </exclusion>
    <exclusion>
     <groupId>org.springframework.cloud</groupId>
     <artifactId>spring-cloud-starter-netflix-ribbon</artifactId>
    </exclusion>
  </exclusions>
</dependency>
<dependency>
  <groupId>com.alibaba.nacos</groupId>
  <artifactId>nacos-client</artifactId>
  <version>2.0.3</version>
</dependency>

４、引入spring-cloud-loadbalancer：

<dependency>
	<groupId>org.springframework.cloud</groupId>
	<artifactId>spring-cloud-loadbalancer</artifactId>
</dependency>

５、spring-cloud-starter-openfeign中exclude掉ribbon的依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-netflix-ribbon</artifactId>
        </exclusion>
    </exclusions>
</dependency>

６、application.yml中禁用nacos的ribbon：

ribbon:
  nacos:
    enabled: false

现在的现象：

Spring gateway启动不报错；
gateway也可以正常注册到Nacos；
通过打断点到NacosDiscoveryClientAutoConfiguration，NacosDiscoveryClient会被初使化，但是调用时不会调用NacosDiscoveryClient.getInstances(String)获取被调用应用的Provider，会报类似下面的接口404错误：

{"msg":"/user-service/user/getByToken","result":404,"data":null}

其中user-service为注册到Nacos上面的服务名称，但是就是不能够被调用到。

Spring gateway的注册中心切换为Eureka，再次调用服务时，Eureka的CompositeDiscoveryClient.getInstances(String)方法就会被调用。

二、问题分析

前面走了一些弯路，也花了一些时间，最后想到的是与Eureka注册中心进行对比调试分析，下面例出关键的分析步骤。

Debug断点打到DiscoveryClientRouteDefinitionLocator两个构造函数上，只有参数是ReactiveDiscoveryClient的构造函数被加载：

继续跟踪到ReactiveCompositeDiscoveryClient.getServices()方法：

发现数组变量discoveryClients包含了两个实现，如下图所示：

其中有一个是EurekaReactiveDiscoveryClient，那在使用Nacos时就应该包含一个针对Nacos实现的ReactiveDiscoveryClient，于是切换为Nacos分支调试。

但是调试发现数组变量discoveryClients并没有包含针对Nacos实现的ReactiveDiscoveryClient：

于是参考EurekaReactiveDiscoveryClient以及NacosDiscoveryClient，立即就写了NacosReactiveDiscoveryClient：

import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import org.springframework.cloud.alibaba.nacos.NacosDiscoveryProperties;
import org.springframework.cloud.alibaba.nacos.NacosServiceInstance;
import org.springframework.cloud.client.ServiceInstance;
import org.springframework.cloud.client.discovery.ReactiveDiscoveryClient;
import com.alibaba.nacos.api.naming.pojo.Instance;
import com.alibaba.nacos.api.naming.pojo.ListView;
import lombok.extern.slf4j.Slf4j;
import reactor.core.publisher.Flux;
/**
 * 
 * @author fenglibin
 *
 */
@Slf4j
public class NacosReactiveDiscoveryClient implements ReactiveDiscoveryClient {
	public static final String DESCRIPTION = "Spring Cloud Nacos Reactive Discovery Client";
	private NacosDiscoveryProperties discoveryProperties;
	public NacosReactiveDiscoveryClient(NacosDiscoveryProperties discoveryProperties) {
		this.discoveryProperties = discoveryProperties;
	}
	@Override
	public String description() {
		return DESCRIPTION;
	}
	@Override
	public Flux<ServiceInstance> getInstances(String serviceId) {
		try {
			List<Instance> instances = discoveryProperties.namingServiceInstance().selectInstances(serviceId, true);
			return Flux.fromStream(hostToServiceInstanceList(instances, serviceId).stream());
		} catch (Exception e) {
			throw new RuntimeException("Can not get hosts from nacos server. serviceId: " + serviceId, e);
		}
	}
	@Override
	public Flux<String> getServices() {
		try {
			ListView<String> services = discoveryProperties.namingServiceInstance().getServicesOfServer(1,
					Integer.MAX_VALUE);
			return Flux.fromStream(services.getData().parallelStream());
		} catch (Exception e) {
			log.error("get service name from nacos server fail,", e);
			return Flux.fromStream(Collections.<String>emptyList().stream());
		}
	}
	private static ServiceInstance hostToServiceInstance(Instance instance, String serviceId) {
		NacosServiceInstance nacosServiceInstance = new NacosServiceInstance();
		nacosServiceInstance.setHost(instance.getIp());
		nacosServiceInstance.setPort(instance.getPort());
		nacosServiceInstance.setServiceId(serviceId);
		Map<String, String> metadata = new HashMap<>();
		metadata.put("nacos.instanceId", instance.getInstanceId());
		metadata.put("nacos.weight", instance.getWeight() + "");
		metadata.put("nacos.healthy", instance.isHealthy() + "");
		metadata.put("nacos.cluster", instance.getClusterName() + "");
		metadata.putAll(instance.getMetadata());
		nacosServiceInstance.setMetadata(metadata);
		if (metadata.containsKey("secure")) {
			boolean secure = Boolean.parseBoolean(metadata.get("secure"));
			nacosServiceInstance.setSecure(secure);
		}
		return nacosServiceInstance;
	}
	private static List<ServiceInstance> hostToServiceInstanceList(List<Instance> instances, String serviceId) {
		List<ServiceInstance> result = new ArrayList<>(instances.size());
		for (Instance instance : instances) {
			result.add(hostToServiceInstance(instance, serviceId));
		}
		return result;
	}
}

或者集成如下starter：

    <dependency>
        <groupId>com.eeeffff</groupId>
        <artifactId>nacos-reactive-discovery-client</artifactId>
        <version>1.0.0</version>
    </dependency>

并在启动时创建Bean：

再次启动调试就可以看到数组变量discoveryClients中有NacosReactiveDiscoveryClient了：

再次通过网关请求服务，就可以正常调用成功了。

感觉Nacos的怪问题都让我给碰上了！

到此这篇关于Spring Gateway集成 Nacos注册中心不能够发现服务的解决方案的文章就介绍到这了,更多相关Spring Gateway集成 Nacos内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

java字符串与字符数组之间的互转方式
这篇文章主要介绍了java字符串与字符数组之间的互转方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2025-05-05
SpringBoot3.1.2 引入Swagger报错Type javax.servlet.http
这篇文章主要介绍了SpringBoot3.1.2 引入Swagger报错Type javax.servlet.http.HttpServletRequest not present解决办法,文中通过代码示例给大家介绍的非常详细,需要的朋友可以参考下
2024-03-03
操作系统的内核态和用户态场景详解
这篇文章主要介绍了操作系统的内核态和用户态场景,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2025-06-06
浅谈Java 8 新增函数式接口到底是什么
这篇文章主要介绍了浅谈Java 8 新增函数式接口到底是什么，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2019-01-01
详解spring cloud分布式整合zipkin的链路跟踪
这篇文章主要介绍了详解spring cloud分布式整合zipkin的链路跟踪，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-07-07
String.trim()消除不了空格的问题及解决
这篇文章主要介绍了String.trim()消除不了空格的问题及解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-07-07
python中jieba库(中文分词库)使用安装教程
这篇文章主要介绍了python中jieba库(中文分词库)使用安装教程,jieba库是通过中文词库的方式来识别分词的。它首先利用一个中文词库，通过词库计算汉字之间构成词语的关联概率，所以通过计算汉字之间的概率，就可以形成分词的结果,需要的朋友可以参考下
2023-04-04
Maven打包之解决没有依赖jar包问题及分析
用户使用Maven打包FTPServer程序时,因未配置依赖打包导致jar体积过小且运行报错,解决方法是添加maven-assembly插件生成包含依赖的jar包,确保程序正常运行
2025-09-09
浅谈springMVC拦截器和过滤器总结
本篇文章主要介绍了springMVC拦截器和过滤器总结，可以用来对访问的url进行拦截处理，有兴趣的可以了解一下。
2017-01-01
Java中的值传递以及引用传递和数组传递详解
这篇文章主要介绍了Java中的值传递以及引用传递和数组传递详解,Java不允许程序员选择按值传递还是按引用传递各个参数,就对象而言，不是将对象本身传递给方法，而是将对象的的引用或者说对象的首地址传递给方法，引用本身是按值传递的,需要的朋友可以参考下
2023-07-07