快捷導(dǎo)航

nacos服務(wù)無法注冊到nacos服務(wù)中心問題及解決

更新時(shí)間：2025年11月25日 15:50:55 作者：天黑請?閉眼

本文詳細(xì)描述了在Linux服務(wù)器上使用Tomcat啟動(dòng)Java程序時(shí),服務(wù)無法注冊到Nacos的排查過程,通過一系列排查步驟,發(fā)現(xiàn)問題出在Tomcat的啟動(dòng)機(jī)制上,導(dǎo)致無法自動(dòng)觸發(fā)服務(wù)注冊事件,最終,通過實(shí)現(xiàn)`ApplicationRunner`接口,手動(dòng)觸發(fā)服務(wù)注冊事件,解決了問題

簡介

1、程序在本機(jī)用啟動(dòng)類啟動(dòng)，服務(wù)可以正常注冊到nacos

2、程序在Linux服務(wù)器用tomcat啟動(dòng)，服務(wù)無法注冊到nacos

依賴

<!--客戶端負(fù)載均衡loadbalancer-->
<dependency>
	<groupId>org.springframework.cloud</groupId>
	<artifactId>spring-cloud-starter-loadbalancer</artifactId>
	<version>4.1.3</version>
</dependency>
<!-- nacos -->
<dependency>
	<groupId>com.alibaba.cloud</groupId>
	<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
	<version>${spring-cloud-alibaba.version}</version>
</dependency>
<dependency>
	<groupId>com.alibaba.cloud</groupId>
	<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
	<version>${spring-cloud-alibaba.version}</version>
</dependency>
<dependency>
	<groupId>org.springframework.cloud</groupId>
	<artifactId>spring-cloud-starter-bootstrap</artifactId>
	<version>${spring-cloud-bootstrap.version}</version>
</dependency>
<!-- sentinel -->
<dependency>
	<groupId>com.alibaba.cloud</groupId>
	<artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
	<version>${spring-cloud-alibaba.version}</version>
</dependency>
<dependency>
	<groupId>org.springframework.cloud</groupId>
	<artifactId>spring-cloud-starter-openfeign</artifactId>
	<version>${spring-cloud-openfeign.version}</version>
</dependency>

異常情況

服務(wù)啟動(dòng)后無法注冊到服務(wù)中心

排查

1、檢查本機(jī)與Linux服務(wù)器程序配置文件是否存在差異，導(dǎo)致服務(wù)無法注冊

結(jié)果：配置完全相同

2、查看Linux日志，發(fā)現(xiàn)程序?qū)acos配置文件的讀取是正常的，可以正常訪問nacos的配置中心讀取配置文件

結(jié)果：nacos配置文件可以讀取，服務(wù)無法注冊到nacos

3、查看Linux服務(wù)器其他程序是否可以注冊到nacos

結(jié)果：同一臺Linux服務(wù)器其他程序可以正常注冊到nacos

4、查看可以正常注冊的程序，使用的依賴版本與當(dāng)前無法注冊的程序依賴版本是否一致

結(jié)果：openFeign、Nacos、Spring Cloud、Spring Boot依賴版本完全一致

5、將當(dāng)前程序tomcat放到其他Linux服務(wù)器啟動(dòng)，服務(wù)依舊無法注冊到nacos

結(jié)果：排除是Linux服務(wù)器本身的問題

6、將程序放到可以正常注冊的程序所在的tomcat

結(jié)果：原先可以正常注冊的程序依舊正常，當(dāng)前程序還是無法正常注冊到nacos，排除tomcat的問題

斷點(diǎn)調(diào)試

1、本機(jī)用啟動(dòng)類啟動(dòng)服務(wù)，可以正常觸發(fā)AbstractAutoServiceRegistration監(jiān)聽的WebServerInitializedEvent事件，會執(zhí)行服務(wù)注冊邏輯onApplicationEvent()

2、Linux服務(wù)器tomcat啟動(dòng)，無法觸發(fā)AbstractAutoServiceRegistration監(jiān)聽的WebServerInitializedEvent事件，沒有執(zhí)行服務(wù)注冊邏輯onApplicationEvent()

原因

無法觸發(fā)AbstractAutoServiceRegistration監(jiān)聽的WebServerInitializedEvent事件，沒有執(zhí)行服務(wù)注冊邏輯onApplicationEvent()

根本原因不明?。。?/p>

解決

既然無法自動(dòng)觸發(fā)WebServerInitializedEvent事件，從而自動(dòng)進(jìn)行服務(wù)注冊，那就手動(dòng)進(jìn)行注冊

實(shí)現(xiàn)ApplicationRunner接口，監(jiān)聽服務(wù)啟動(dòng)事件，從而主動(dòng)進(jìn)行服務(wù)注冊

將以下類添加到程序中即可

NacosRegisterOnWar

package com.xxx.nacosregister;

import com.alibaba.cloud.nacos.ConditionalOnNacosDiscoveryEnabled;
import com.alibaba.cloud.nacos.registry.NacosAutoServiceRegistration;
import com.alibaba.cloud.nacos.registry.NacosRegistration;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.ApplicationArguments;
import org.springframework.boot.ApplicationRunner;
import org.springframework.stereotype.Component;

import javax.management.MBeanServer;
import javax.management.ObjectName;
import javax.management.Query;
import java.lang.management.ManagementFactory;
import java.util.Set;

@Component
@ConditionalOnNacosDiscoveryEnabled
@Slf4j
public class NacosRegisterOnWar implements ApplicationRunner {

    @Autowired
    private NacosRegistration registration;

    @Autowired
    private NacosAutoServiceRegistration nacosAutoServiceRegistration;

    @Value("${server.port}")
    Integer port;

    @Override
    public void run(ApplicationArguments args) throws Exception {
        if (registration != null && port != null) {
            Integer registerPort = port;
            try {
                String tomcatPort = getTomcatPort();
                if(StringUtils.isNotBlank(tomcatPort)){
                    registerPort = new Integer(tomcatPort);
                }
            } catch (Exception e) {
                log.warn("{nacos 注冊} 獲取外部Tomcat端口異常：",e);
            }
            registration.setPort(registerPort);
            nacosAutoServiceRegistration.start();
        }
    }

    /**
     *	獲取外部tomcat端口
     */
    public String getTomcatPort() throws Exception {
        MBeanServer beanServer = ManagementFactory.getPlatformMBeanServer();
        Set<ObjectName> objectNames = beanServer.queryNames(
                new ObjectName("*:type=Connector,*"),
                Query.match(Query.attr("protocol"),
                        Query.value("HTTP/1.1")));
        String port = "";
        for (ObjectName objectName : objectNames) {
            port = objectName.getKeyProperty("port");
            if(StringUtils.isNotBlank(port)){
                return port;
            }
        }
        return port;
    }
}