Spring Cloud Nacos 微服务注册发现与配置中心实战

远程调用优化

RestTemplate 基础用法

在微服务间通信时，传统的 RestTemplate 需要硬编码 IP 地址。例如订单服务调用商品服务时，如果直接写死 http://127.0.0.1:9000/product/getProductById?id=...，一旦服务 IP 变更或环境切换，代码就需要修改。

@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 实现负载均衡

引入 spring-cloud-loadbalancer 依赖后，只需给 RestTemplate 添加 @LoadBalanced 注解，调用时直接使用服务名而非 IP，Nacos 会自动解析服务名对应的具体 IP。

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

此时 URL 可改为：

String url = "http://product-service/product/getProductById?id=" + orderInfo.getProductId();

权重与集群策略

Nacos 本身不直接提供负载均衡能力，需配合客户端负载均衡器使用。若要让 Nacos 中配置的权重生效，需在消费者配置中开启 Nacos 负载均衡策略：

spring:
  cloud:
    loadbalancer:
      nacos:
        enabled: true

在 Nacos 控制台的服务详情页编辑实例，设置权重值即可控制流量分发比例。

对于跨机房部署场景，可通过配置 cluster-name 实现同集群优先访问，减少网络延迟。例如将北京机房的实例和消费者都配置为 cluster-beijing。

健康检查机制

Nacos 确保调用始终指向健康实例，主要有两种模式：

1. 客户端主动上报：默认临时实例采用此模式。客户端每 5 秒心跳一次，超过 15 秒未收到心跳标记为不健康，30 秒后删除。
2. 服务器端反向探测：非临时实例采用此模式。Nacos 主动探知，间隔 20 秒，失败后标记不健康但不立即删除。

如需将服务注册为非临时实例，在配置中添加 ephemeral: false。注意实例类型确定后不可随意更改，否则可能报错，必要时需清理 Nacos 的 Raft 数据目录并重启。

环境隔离

多环境（开发、测试、生产）之间需要严格隔离。Nacos 通过 Namespace（命名空间）实现隔离，不同 Namespace 下的服务互不可见。

创建命名空间后，在配置文件中指定 namespace ID：

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 引导文件

从 Spring Cloud 2020.0.0 版本开始，默认禁用了 bootstrap 上下文。为了加载 Nacos 配置，需引入 spring-cloud-starter-bootstrap 依赖，并编写 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 为例，会依次尝试加载以下优先级递减的配置：

1. order-service-local.yaml
2. order-service.yaml
3. order-service

利用 @RefreshScope 注解的 Controller 可以验证配置变更是否实时生效，无需重启服务。

@RestController
@RequestMapping("/config")
@RefreshScope
public class NacosConfigController {
    @Value("${test.value}")
    private String value;

    @GetMapping("/getValue")
    public void getValue() {
        System.out.println("getValue:" + value);
    }
}

访问接口查看当前生效的配置值，删除低优先级配置文件后再次访问，即可观察到配置自动回退到下一优先级的结果。