Spring Boot 集成 Nacos 注册中心配置指南

背景

Spring Boot 2.2.X 之后，Eureka 社区更新放缓，控制台功能受限。Spring Cloud Alibaba 推出的 Nacos 逐渐成为微服务治理的首选方案。它集注册中心与配置中心于一体，支持 AP/CP 模式切换。下面我们来梳理如何在 Spring Boot 项目中完成 Nacos 的整合。

依赖引入

在 Maven 的 pom.xml 中，除了常规业务依赖外，核心是引入 Spring Cloud Alibaba 的 Starter。注意版本管理，建议通过 BOM 控制依赖版本，避免冲突。

<dependencies>
    <!-- Spring Cloud Alibaba Nacos 注册中心 -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>
    
    <!-- 其他业务依赖请保留在此处 -->
    <!-- <dependency>...</dependency> -->
</dependencies>

配置文件

在 application.yml 或 bootstrap.yml 中指定 Nacos 服务器地址。如果是 Spring Cloud 2020.0.0 及以上版本，推荐放在 application.yml 中。

spring:
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
        namespace: ""
        group: DEFAULT_GROUP

启动验证

确保主启动类没有禁用自动配置，通常无需额外注解即可生效。启动后访问 Nacos 控制台，查看服务列表是否已注册成功。若遇到连接问题，请检查防火墙设置及网络连通性。