快捷導(dǎo)航

Nacos服務(wù)注冊與發(fā)現(xiàn)原理解讀

更新時間：2025年08月28日 14:05:46 作者：shangjg3

Nacos是阿里巴巴開源的微服務(wù)組件,支持服務(wù)注冊、發(fā)現(xiàn)及配置管理,采用客戶端心跳維護(hù)、服務(wù)端推送與長輪詢同步,結(jié)合健康檢查機(jī)制,實現(xiàn)高效可靠的微服務(wù)治理

核心原理架構(gòu)

Nacos的服務(wù)注冊與發(fā)現(xiàn)架構(gòu)主要包含三個核心組件：

服務(wù)提供者：負(fù)責(zé)將自身服務(wù)實例注冊到Nacos Server
服務(wù)消費(fèi)者：負(fù)責(zé)從Nacos Server獲取服務(wù)列表并進(jìn)行服務(wù)調(diào)用
Nacos Server：負(fù)責(zé)維護(hù)服務(wù)實例信息，處理注冊、發(fā)現(xiàn)、健康檢查等請求

服務(wù)注冊原理

服務(wù)注冊是指服務(wù)提供者將自身服務(wù)實例的信息注冊到Nacos Server的過程。

其核心流程如下：

1. 服務(wù)實例啟動時，通過SDK向Nacos Server發(fā)送注冊請求
2. Nacos Server接收請求并驗證信息，將服務(wù)實例信息存儲到內(nèi)存和持久化存儲中
3. 服務(wù)實例定期向Nacos Server發(fā)送心跳包維持注冊狀態(tài)

服務(wù)注冊核心源碼

下面是Nacos服務(wù)注冊的核心源碼示例：

// ServiceRegistration接口定義服務(wù)注冊的基本方法
public interface ServiceRegistration<T> {
    void register();
    void deregister();
    T getRegistration();
}

// NacosServiceRegistry實現(xiàn)了服務(wù)注冊邏輯
@Service
public class NacosServiceRegistry implements ServiceRegistry<NacosRegistration> {
    
    private final NacosServiceManager nacosServiceManager;
    private final NacosRegistrationProperties registrationProperties;
    
    public NacosServiceRegistry(NacosServiceManager nacosServiceManager,
                               NacosRegistrationProperties registrationProperties) {
        this.nacosServiceManager = nacosServiceManager;
        this.registrationProperties = registrationProperties;
    }
    
    @Override
    public void register(NacosRegistration registration) {
        if (StringUtils.isEmpty(registration.getServiceId())) {
            log.warn("No service to register for nacos client...");
            return;
        }
        
        // 構(gòu)建服務(wù)實例注冊信息
        Instance instance = getNacosInstanceFromRegistration(registration);
        
        try {
            // 調(diào)用Nacos客戶端進(jìn)行服務(wù)注冊
            namingService().registerInstance(
                registration.getServiceId(), 
                registration.getGroupName(), 
                instance);
            log.info("nacos registry, {} {}:{} register finished",
                registration.getServiceId(),
                instance.getIp(), instance.getPort());
        } catch (Exception e) {
            log.error("nacos registry error", e);
        }
    }
    
    // 獲取Nacos命名服務(wù)客戶端
    private NamingService namingService() throws NacosException {
        return nacosServiceManager.getNamingService(registrationProperties);
    }
    
    // 從注冊信息構(gòu)建Nacos實例對象
    private Instance getNacosInstanceFromRegistration(NacosRegistration registration) {
        Instance instance = new Instance();
        // 設(shè)置實例基本信息
        instance.setIp(registration.getIp());
        instance.setPort(registration.getPort());
        instance.setWeight(registration.getWeight() == null ? 1.0F : registration.getWeight());
        instance.setClusterName(registration.getClusterName());
        instance.setHealthy(registration.isHealthy());
        instance.setServiceName(registration.getServiceId());
        instance.setInstanceId(registration.getInstanceId());
        instance.setEphemeral(registration.isEphemeral());
        
        // 設(shè)置元數(shù)據(jù)
        if (registration.getMetadata() != null) {
            instance.setMetadata(registration.getMetadata());
        }
        
        return instance;
    }
}

// NacosNamingService是Nacos命名服務(wù)的核心實現(xiàn)類
public class NacosNamingService implements NamingService {
    
    private final NacosServiceFactory serviceFactory;
    private final NamingProxy namingProxy;
    private final ClientWorker clientWorker;
    
    public NacosNamingService(Properties properties) throws NacosException {
        // 初始化相關(guān)組件
        this.serviceFactory = new NacosServiceFactory(properties);
        this.namingProxy = serviceFactory.createNamingProxy();
        this.clientWorker = new ClientWorker(namingProxy, properties);
    }
    
    @Override
    public void registerInstance(String serviceName, String groupName, Instance instance) throws NacosException {
        // 檢查服務(wù)名是否合法
        if (StringUtils.isEmpty(groupName)) {
            groupName = Constants.DEFAULT_GROUP;
        }
        
        // 調(diào)用客戶端工作類處理注冊
        clientWorker.registerInstance(serviceName, groupName, instance);
    }
    
    // 客戶端工作類處理注冊邏輯
    public class ClientWorker {
        private final NamingProxy namingProxy;
        private final ServiceInfoHolder serviceInfoHolder;
        private final ScheduledExecutorService executorService;
        
        public ClientWorker(NamingProxy namingProxy, Properties properties) {
            this.namingProxy = namingProxy;
            this.serviceInfoHolder = new ServiceInfoHolder();
            this.executorService = Executors.newScheduledThreadPool(1, 
                new ThreadFactory() {
                    @Override
                    public Thread newThread(Runnable r) {
                        Thread t = new Thread(r);
                        t.setName("com.alibaba.nacos.naming.client.Worker");
                        t.setDaemon(true);
                        return t;
                    }
                });
            
            // 啟動心跳任務(wù)
            scheduleHeartbeat();
        }
        
        public void registerInstance(String serviceName, String groupName, Instance instance) throws NacosException {
            // 構(gòu)建注冊請求參數(shù)
            Map<String, String> params = new HashMap<>(16);
            params.put("serviceName", serviceName);
            params.put("groupName", groupName);
            params.put("ip", instance.getIp());
            params.put("port", String.valueOf(instance.getPort()));
            params.put("weight", String.valueOf(instance.getWeight()));
            params.put("clusterName", instance.getClusterName());
            params.put("ephemeral", String.valueOf(instance.isEphemeral()));
            params.put("serviceId", instance.getServiceId());
            params.put("metadata", JSON.toJSONString(instance.getMetadata()));
            
            // 發(fā)送注冊請求到Nacos Server
            namingProxy.registerInstance(params);
            
            // 加入到服務(wù)信息持有者中
            serviceInfoHolder.processServiceJson(
                serviceName, groupName, 
                JSON.toJSONString(Collections.singletonList(instance))
            );
        }
        
        // 啟動心跳任務(wù)，定期發(fā)送心跳維持注冊狀態(tài)
        private void scheduleHeartbeat() {
            executorService.scheduleAtFixedRate(new Runnable() {
                @Override
                public void run() {
                    try {
                        // 發(fā)送心跳包
                        clientWorker.sendHeartbeat();
                    } catch (Exception e) {
                        log.error("Exception when sending heartbeat", e);
                    }
                }
            }, 5000, 5000, TimeUnit.MILLISECONDS);
        }
        
        // 發(fā)送心跳方法
        public void sendHeartbeat() throws NacosException {
            for (Map.Entry<String, List<Instance>> entry : serviceInfoHolder.getServices().entrySet()) {
                String serviceName = entry.getKey();
                List<Instance> instances = entry.getValue();
                
                for (Instance instance : instances) {
                    if (!instance.isHealthy() || !instance.isEphemeral()) {
                        continue;
                    }
                    
                    // 構(gòu)建心跳請求參數(shù)
                    Map<String, String> params = new HashMap<>(16);
                    params.put("serviceName", serviceName);
                    params.put("ip", instance.getIp());
                    params.put("port", String.valueOf(instance.getPort()));
                    params.put("clusterName", instance.getClusterName());
                    params.put("serviceId", instance.getServiceId());
                    
                    // 發(fā)送心跳請求
                    namingProxy.sendHeartbeat(params);
                }
            }
        }
    }
}

服務(wù)發(fā)現(xiàn)原理

服務(wù)發(fā)現(xiàn)是指服務(wù)消費(fèi)者從Nacos Server獲取服務(wù)列表，并根據(jù)一定的負(fù)載均衡策略選擇具體服務(wù)實例進(jìn)行調(diào)用的過程。

核心流程如下：

1. 服務(wù)消費(fèi)者啟動時，向Nacos Server訂閱所需服務(wù)
2. Nacos Server推送服務(wù)列表給消費(fèi)者
3. 消費(fèi)者本地緩存服務(wù)列表，并定期更新
4. 服務(wù)調(diào)用時，根據(jù)負(fù)載均衡策略選擇具體實例

服務(wù)發(fā)現(xiàn)核心源碼

下面是Nacos服務(wù)發(fā)現(xiàn)的核心源碼示例：

// NacosServiceDiscovery實現(xiàn)了服務(wù)發(fā)現(xiàn)邏輯
@Service
public class NacosServiceDiscovery implements ServiceDiscovery<ServiceInstance> {
    
    private final NacosServiceManager nacosServiceManager;
    private final NacosDiscoveryProperties discoveryProperties;
    
    public NacosServiceDiscovery(NacosServiceManager nacosServiceManager,
                               NacosDiscoveryProperties discoveryProperties) {
        this.nacosServiceManager = nacosServiceManager;
        this.discoveryProperties = discoveryProperties;
    }
    
    @Override
    public List<ServiceInstance> getInstances(String serviceId) throws NacosException {
        return getInstances(serviceId, "");
    }
    
    @Override
    public List<ServiceInstance> getInstances(String serviceId, String group) throws NacosException {
        if (StringUtils.isEmpty(serviceId)) {
            throw new NacosException(NacosException.INVALID_PARAM, "serviceId is empty");
        }
        
        if (StringUtils.isEmpty(group)) {
            group = discoveryProperties.getGroup();
        }
        
        // 調(diào)用Nacos命名服務(wù)獲取實例列表
        List<Instance> instances = namingService().getInstances(serviceId, group);
        
        // 轉(zhuǎn)換為標(biāo)準(zhǔn)ServiceInstance格式
        return instances.stream()
            .map(instance -> new NacosServiceInstance(instance, serviceId))
            .collect(Collectors.toList());
    }
    
    @Override
    public List<String> getServices() throws NacosException {
        // 獲取所有服務(wù)列表
        return namingService().getServicesOfServer(1000, 0).stream()
            .map(serviceInfo -> serviceInfo.getName())
            .collect(Collectors.toList());
    }
    
    // 獲取Nacos命名服務(wù)客戶端
    private NamingService namingService() throws NacosException {
        return nacosServiceManager.getNamingService(discoveryProperties.getNacosProperties());
    }
}

// NacosNamingService中的服務(wù)發(fā)現(xiàn)相關(guān)方法
public class NacosNamingService implements NamingService {
    
    // 獲取服務(wù)實例列表
    @Override
    public List<Instance> getInstances(String serviceName, String groupName, List<String> clusters) 
        throws NacosException {
        if (StringUtils.isEmpty(groupName)) {
            groupName = Constants.DEFAULT_GROUP;
        }
        
        // 調(diào)用客戶端工作類獲取實例
        return clientWorker.getInstances(serviceName, groupName, clusters);
    }
    
    // 客戶端工作類處理服務(wù)發(fā)現(xiàn)邏輯
    public class ClientWorker {
        // 服務(wù)信息持有者，緩存服務(wù)列表
        private final ServiceInfoHolder serviceInfoHolder;
        
        public List<Instance> getInstances(String serviceName, String groupName, List<String> clusters) 
            throws NacosException {
            // 構(gòu)建服務(wù)標(biāo)識
            String serviceId = ServiceIdBuilder.buildServiceId(groupName, serviceName);
            
            // 從服務(wù)信息持有者獲取服務(wù)信息
            ServiceInfo serviceInfo = serviceInfoHolder.getServiceInfo(serviceId);
            
            // 如果服務(wù)信息為空或已過期，主動拉取
            if (serviceInfo == null || serviceInfo.isExpired()) {
                serviceInfo = refreshServiceInfo(serviceName, groupName, clusters);
            }
            
            // 返回可用實例列表
            return serviceInfo == null ? Collections.emptyList() : serviceInfo.getHosts();
        }
        
        // 刷新服務(wù)信息
        public ServiceInfo refreshServiceInfo(String serviceName, String groupName, List<String> clusters) 
            throws NacosException {
            String serviceId = ServiceIdBuilder.buildServiceId(groupName, serviceName);
            
            // 構(gòu)建請求參數(shù)
            Map<String, String> params = new HashMap<>(16);
            params.put("serviceName", serviceName);
            params.put("groupName", groupName);
            if (clusters != null && !clusters.isEmpty()) {
                params.put("clusters", StringUtils.join(clusters, ","));
            }
            
            // 調(diào)用Nacos Server獲取服務(wù)信息
            String result = namingProxy.queryList(serviceId, params);
            
            // 處理服務(wù)信息
            return serviceInfoHolder.processServiceJson(serviceId, result);
        }
        
        // 服務(wù)信息持有者類，負(fù)責(zé)緩存和管理服務(wù)信息
        public class ServiceInfoHolder {
            // 服務(wù)信息緩存
            private final Map<String, ServiceInfo> services = new ConcurrentHashMap<>();
            // 上次更新時間
            private final Map<String, Long> lastRefTime = new ConcurrentHashMap<>();
            
            public ServiceInfo processServiceJson(String serviceId, String json) {
                if (StringUtils.isEmpty(json)) {
                    return null;
                }
                
                ServiceInfo serviceInfo = JSON.parseObject(json, ServiceInfo.class);
                
                if (serviceInfo != null) {
                    // 更新服務(wù)信息
                    services.put(serviceId, serviceInfo);
                    lastRefTime.put(serviceId, System.currentTimeMillis());
                    
                    // 注冊監(jiān)聽器，當(dāng)服務(wù)信息變化時通知
                    if (null != listeners.get(serviceId)) {
                        for (EventListener listener : listeners.get(serviceId)) {
                            executorService.execute(new Runnable() {
                                @Override
                                public void run() {
                                    try {
                                        listener.onEvent(new NamingEvent(serviceId, serviceInfo));
                                    } catch (Exception e) {
                                        log.error("EventListener execute error.", e);
                                    }
                                }
                            });
                        }
                    }
                }
                
                return serviceInfo;
            }
            
            // 獲取服務(wù)信息
            public ServiceInfo getServiceInfo(String serviceId) {
                ServiceInfo serviceInfo = services.get(serviceId);
                if (serviceInfo != null) {
                    return serviceInfo;
                }
                
                // 如果服務(wù)信息不存在，主動拉取
                try {
                    return refreshServiceInfo(serviceId.split(ServiceIdBuilder.SERVICE_ID_SEPARATOR)[0],
                        serviceId.split(ServiceIdBuilder.SERVICE_ID_SEPARATOR)[1], null);
                } catch (NacosException e) {
                    log.error("getServiceInfo error, serviceId: {}", serviceId, e);
                }
                
                return null;
            }
            
            // 服務(wù)信息是否過期
            public boolean isExpired(String serviceId) {
                Long lastRef = lastRefTime.get(serviceId);
                if (lastRef == null) {
                    return true;
                }
                
                // 默認(rèn)15秒更新一次
                return (System.currentTimeMillis() - lastRef) > 15 * 1000;
            }
        }
    }
}