Spring Cloud Nacos 核心实战：服务注册、发现与配置中心详解

启动服务后，访问 http://127.0.0.1:8848/nacos/#/serviceManagement 观察是否注册成功。

远程调用

RestTemplate 基础用法

本项目包含两个微服务：order-service（订单服务）和 product-service（商品服务）。当订单服务需要获取关联的商品详情时，必须调用商品服务的接口。

使用 RestTemplate 实现跨服务通信的代码如下：

@Service
public class OrderService {
    private final OrderMapper orderMapper;
    private final RestTemplate restTemplate;

    @Autowired
    public OrderService(OrderMapper orderMapper, RestTemplate restTemplate) {
        this.orderMapper = orderMapper;
        this.restTemplate = restTemplate;
    }

    public OrderInfo selectOrderById(Integer id) {
        OrderInfo orderInfo = orderMapper.selectOrderById(id);
        // 硬编码 IP 地址，存在维护痛点
        String url = "http://127.0.0.1:9000/product/getProductById?id=" + orderInfo.getProductId();
        ProductInfo productInfo = restTemplate.getForObject(url, ProductInfo.class);
        orderInfo.setProductInfo(productInfo);
        return orderInfo;
    }
}

同时需要配置 RestTemplate Bean：

@Configuration
public class BeanConfig {
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}

结合 Nacos 进行远程调用

硬编码 IP 的痛点在于：一旦商品服务的 IP 变更或环境切换，代码就必须修改。利用 Nacos 的优势，调用方只需知道服务名，Nacos 负责将服务名动态解析为具体的 IP 地址。

首先引入负载均衡器依赖：

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

为 RestTemplate 添加 @LoadBalanced 注解：

@Configuration
public class BeanConfig {
    @Bean
    @LoadBalanced
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}

此时，调用 URL 中的 IP 地址替换为服务名即可：

// 使用服务名代替 IP
String url = "http://product-service/product/getProductById?id=" + orderInfo.getProductId();
ProductInfo productInfo = restTemplate.getForObject(url, ProductInfo.class);

负载均衡

Nacos 本身不直接提供负载均衡能力，而是与客户端负载均衡器（如 Spring Cloud LoadBalancer）配合使用。由于默认策略不会读取 Nacos 实例的权重属性，我们需要开启 Nacos 的负载均衡策略。

在服务消费者 order-service 的 yml 文件中添加配置：

spring:
  cloud:
    loadbalancer:
      nacos:
        enabled: true

权重配置

1. 进入「服务管理」->「服务列表」。
2. 点击目标服务进入详情页。
3. 在实例列表中点击「编辑」按钮，设置「权重」值。

同集群优先访问

在微服务部署中，为了减少跨机房调用的网络延迟和成本，通常需要实现同集群优先访问的策略。

集群配置

product-service：编辑启动配置，添加参数 -Dspring.cloud.nacos.discovery.cluster-name=cluster-beijing。

order-service：在 yml 文件中添加如下配置：

spring:
  cloud:
    nacos:
      discovery:
        cluster-name: cluster-beijing

健康检查

Nacos 健康检查机制确保了服务调用始终指向健康的实例，共有两种模式：

1. 客户端主动上报机制：客户端通过心跳上报方式告知服务端健康状态，默认心跳间隔 5 秒。超过 15 秒未收到心跳将标记为不健康，超过 30 秒删除。
2. 服务器端反向探测机制：Nacos 主动探知客户端健康状态，默认间隔 20 秒。失败后标记为不健康，但不会立即删除。

具体模式与服务实例类型强相关：

• 临时实例：采取客户端主动上报机制（默认类型）。
• 非临时实例：采取服务器端反向探测机制。

若要将服务修改为非临时实例，需在 yml 中添加：

spring:
  cloud:
    nacos:
      discovery:
        ephemeral: false

注意：实例类型一旦确定不能随意更改，否则会导致启动报错。若需修改，建议先停止 Nacos 服务，清理 /data/protocol/raft 目录下的元数据文件后重启。

环境隔离

企业开发通常划分为开发、测试和生产环境，环境之间需要严格隔离。Nacos 提供了 namespace（命名空间）来实现隔离，不同的 namespace 的服务不可见（Nacos 默认提供了一个 public 保留空间）。

创建与配置命名空间

在控制台创建命名空间后，在应用配置中指定：

spring:
  cloud:
    nacos:
      discovery:
        namespace: 0bec5adc-2787-44b0-b826-e4bb48746c4e

这样，不同环境的微服务就能独立运行，互不干扰。

配置中心

传统配置文件存在修改需重启、多环境管理困难等痛点。Nacos 作为配置中心，支持配置集中管理和实时生效。

引入依赖

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>

Bootstrap 启动文件详解

当配置文件交由 Nacos 管理后，应用程序启动流程变为'先连接配置中心，再加载配置，最后启动应用'。bootstrap.yml 是引导配置文件，优先于 application.yml 被加载。

从 Spring Cloud 2020.0.0 版本开始，默认禁用了 bootstrap 上下文。因此需要引入 spring-cloud-starter-bootstrap 依赖来恢复该功能。

order-service 的 bootstrap.yml 配置示例：

spring:
  application:
    name: order-service
  profiles:
    active: local
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848
        namespace: 0bec5adc-2787-44b0-b826-e4bb48746c4e
        file-extension: yaml
      discovery:
        server-addr: 127.0.0.1:8848
        ephemeral: true
        namespace: 0bec5adc-2787-44b0-b826-e4bb48746c4e

Data ID 规则

Data ID 的构建公式如下：

Data ID = ${prefix} - ${spring.profiles.active} . ${file-extension}

以上述配置为例，order-service 服务将从 Nacos 上读取 order-service-local.yaml 配置文件。实际启动时，会同时监听三个配置文件：

1. order-service-local.yaml：${prefix} - ${spring.profiles.active} . ${file-extension}
2. order-service.yaml：${prefix} . ${file-extension}
3. order-service：${prefix}

优先级测试

通过 @RefreshScope 标注的 Controller 可以实时感知配置变化。测试优先级时，依次删除低优先级的配置文件，观察取值变化。

结论：配置文件优先级 order-service-local.yaml > order-service.yaml > order-service。

这意味着高优先级的配置会覆盖低优先级的配置，确保特定环境下的配置能正确生效。