林宸宇 發表於 2026-1-9 10:13:48

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

<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li>一、问题描述</li><li>二、问题分析</li></ul></div><p class="maodian"></p><h2>一、问题描述</h2>
<p>我们现在是在用Nacos替换Eureka,原来Eureka和Spring gateway运行正常,可以通过Spring gateway调用注册到Eureka中的服务。</p>
<p>当前Spring cloud的版本是Hoxton.SR8,Nacos discovery的版本为0.9.0.RELEASE,使用的Nacos版本为2.0.3。</p>
<p>Nacos替换Eureka改动的地方如下:</p>
<p>1、去掉POM中Eureka的引入;</p>
<p>2、去掉主类中引入的@EnableEurekaClient注解;</p>
<p>3、引入Nacos依赖:</p>
<div class="jb51code"><pre class="brush:plain;">&lt;dependency&gt;
&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
&lt;artifactId&gt;spring-cloud-starter-alibaba-nacos-discovery&lt;/artifactId&gt;
&lt;version&gt;0.9.0.RELEASE&lt;/version&gt;
&lt;exclusions&gt;
    &lt;exclusion&gt;
      &lt;groupId&gt;com.alibaba.nacos&lt;/groupId&gt;
      &lt;artifactId&gt;nacos-client&lt;/artifactId&gt;
    &lt;/exclusion&gt;
    &lt;exclusion&gt;
   &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
   &lt;artifactId&gt;spring-cloud-starter-netflix-ribbon&lt;/artifactId&gt;
    &lt;/exclusion&gt;
&lt;/exclusions&gt;
&lt;/dependency&gt;
&lt;dependency&gt;
&lt;groupId&gt;com.alibaba.nacos&lt;/groupId&gt;
&lt;artifactId&gt;nacos-client&lt;/artifactId&gt;
&lt;version&gt;2.0.3&lt;/version&gt;
&lt;/dependency&gt;</pre></div>
<p>4、引入spring-cloud-loadbalancer:</p>
<div class="jb51code"><pre class="brush:plain;">&lt;dependency&gt;
        &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
        &lt;artifactId&gt;spring-cloud-loadbalancer&lt;/artifactId&gt;
&lt;/dependency&gt;</pre></div>
<p>5、spring-cloud-starter-openfeign中exclude掉ribbon的依赖:</p>
<div class="jb51code"><pre class="brush:plain;">&lt;dependency&gt;
    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
    &lt;artifactId&gt;spring-cloud-starter-openfeign&lt;/artifactId&gt;
    &lt;exclusions&gt;
      &lt;exclusion&gt;
            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
            &lt;artifactId&gt;spring-cloud-netflix-ribbon&lt;/artifactId&gt;
      &lt;/exclusion&gt;
    &lt;/exclusions&gt;
&lt;/dependency&gt;</pre></div>
<p>6、application.yml中禁用nacos的ribbon:</p>
<div class="jb51code"><pre class="brush:plain;">ribbon:
nacos:
    enabled: false</pre></div>
<p>现在的现象:</p>
<ul><li>Spring gateway启动不报错;</li><li>gateway也可以正常注册到Nacos;</li><li>通过打断点到NacosDiscoveryClientAutoConfiguration,NacosDiscoveryClient会被初使化,但是调用时不会调用NacosDiscoveryClient.getInstances(String)获取被调用应用的Provider,会报类似下面的接口404错误:</li></ul>
<p>{&quot;msg&quot;:&quot;/user-service/user/getByToken&quot;,&quot;result&quot;:404,&quot;data&quot;:null}</p>
<p>其中user-service为注册到Nacos上面的服务名称,但是就是不能够被调用到。</p>
<ul><li>Spring gateway的注册中心切换为Eureka,再次调用服务时,Eureka的CompositeDiscoveryClient.getInstances(String)方法就会被调用。</li></ul>
<p class="maodian"></p><h2>二、问题分析</h2>
<p>前面走了一些弯路,也花了一些时间,最后想到的是与Eureka注册中心进行对比调试分析,下面例出关键的分析步骤。</p>
<p>Debug断点打到DiscoveryClientRouteDefinitionLocator两个构造函数上,只有参数是ReactiveDiscoveryClient的构造函数被加载:</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010910114953.png" /></p>
<p>继续跟踪到ReactiveCompositeDiscoveryClient.getServices()方法:</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010910114938.png" /></p>
<p>发现数组变量discoveryClients包含了两个实现,如下图所示:</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010910114980.png" /></p>
<p>其中有一个是EurekaReactiveDiscoveryClient,那在使用Nacos时就应该包含一个针对Nacos实现的ReactiveDiscoveryClient,于是切换为Nacos分支调试。</p>
<p>但是调试发现数组变量discoveryClients并没有包含针对Nacos实现的ReactiveDiscoveryClient:</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010910114945.png" /></p>
<p>于是参考EurekaReactiveDiscoveryClient以及NacosDiscoveryClient,立即就写了NacosReactiveDiscoveryClient:</p>
<div class="jb51code"><pre class="brush:java;">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&lt;ServiceInstance&gt; getInstances(String serviceId) {
                try {
                        List&lt;Instance&gt; 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&lt;String&gt; getServices() {
                try {
                        ListView&lt;String&gt; 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.&lt;String&gt;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&lt;String, String&gt; metadata = new HashMap&lt;&gt;();
                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&lt;ServiceInstance&gt; hostToServiceInstanceList(List&lt;Instance&gt; instances, String serviceId) {
                List&lt;ServiceInstance&gt; result = new ArrayList&lt;&gt;(instances.size());
                for (Instance instance : instances) {
                        result.add(hostToServiceInstance(instance, serviceId));
                }
                return result;
        }
}</pre></div>
<p>或者集成如下starter:</p>
<div class="jb51code"><pre class="brush:plain;">    &lt;dependency&gt;
      &lt;groupId&gt;com.eeeffff&lt;/groupId&gt;
      &lt;artifactId&gt;nacos-reactive-discovery-client&lt;/artifactId&gt;
      &lt;version&gt;1.0.0&lt;/version&gt;
    &lt;/dependency&gt;</pre></div>
<p>并在启动时创建Bean:</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010910114949.png" /></p>
<p>再次启动调试就可以看到数组变量discoveryClients中有NacosReactiveDiscoveryClient了:</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010910114947.png" /></p>
<p>&nbsp;再次通过网关请求服务,就可以正常调用成功了。</p>
<p>&nbsp;感觉Nacos的怪问题都让我给碰上了!</p>
<p>到此这篇关于Spring Gateway集成 Nacos注册中心不能够发现服务的解决方案的文章就介绍到这了,更多相关Spring Gateway集成 Nacos内容请搜索琼殿技术社区以前的文章或继续浏览下面的相关文章希望大家以后多多支持琼殿技术社区!</p>
                           
                            <div class="art_xg">
                              <b>您可能感兴趣的文章:</b><ul><li>Springboot整合GateWay+Nacos实现动态路由</li><li>springboot中使用Feign整合nacos,gateway进行微服务之间的调用方法</li><li>springboot+nacos+gateway实现灰度发布的实例详解</li><li>Nacos+Spring Cloud Gateway动态路由配置实现步骤</li><li>Spring Cloud Gateway + Nacos 实现动态路由</li><li>基于Nacos实现Spring Cloud Gateway实现动态路由的方法</li></ul>
                            </div>

                        </div>
                        <!--endmain-->
頁: [1]
查看完整版本: Spring Gateway集成 Nacos注册中心不能够发现服务的解决方案