Spring Cloud Nacos 实战指南：服务注册、配置管理与负载均衡

传统 RestTemplate 的痛点

早期开发中，我们常直接在代码中写死 IP 地址，例如：

String url = "http://127.0.0.1:9000/product/getProductById?id=" + orderInfo.getProductId();
ProductInfo productInfo = restTemplate.getForObject(url, ProductInfo.class);

这种方式耦合度极高，一旦服务 IP 变更或环境切换，就必须修改代码并重新部署。

基于 Nacos 的动态调用

借助 Nacos 和 Spring Cloud LoadBalancer，我们可以直接使用服务名进行调用，无需关心具体 IP。

1. 引入负载均衡依赖

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

2. 配置 @LoadBalanced

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

3. 调用示例

@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://product-service/product/getProductById?id=" + orderInfo.getProductId();
        ProductInfo productInfo = restTemplate.getForObject(url, ProductInfo.class);
        orderInfo.setProductInfo(productInfo);
        return orderInfo;
    }
}

此时，Nacos 会自动将 product-service 解析为具体的 IP 地址列表。

4. 负载均衡策略

Nacos 本身不直接提供负载均衡算法，而是配合客户端负载均衡器（如 Spring Cloud LoadBalancer）工作。默认情况下，客户端可能忽略 Nacos 实例配置的权重，因此需要显式开启。

开启 Nacos 权重支持

在消费者服务的配置文件中添加：

spring:
  cloud:
    loadbalancer:
      nacos:
        enabled: true

设置实例权重

进入 Nacos 控制台 -> 服务管理 -> 服务列表 -> 点击具体服务 -> 编辑实例。可以手动调整权重值，权重越高，被调用的概率越大。

5. 同集群优先访问

在多机房部署场景下，为了降低跨机房延迟，通常希望优先调用同一集群内的服务。

配置集群名称

提供者端（启动参数）：

-Dspring.cloud.nacos.discovery.cluster-name=cluster-beijing

消费者端（配置文件）：

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

这样，消费者只会发现并调用标记为 cluster-beijing 的实例。

6. 健康检查机制

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

1. 客户端主动上报（临时实例）：默认模式。客户端定时发送心跳，若超过 15 秒未收到心跳，标记为不健康；30 秒未收到则剔除。
2. 服务器端反向探测（非临时实例）：Nacos 主动探测。失败后标记不健康，但不会立即删除。

切换实例类型

如需将服务注册为非临时实例（持久化），需在配置中添加：

spring:
  cloud:
    nacos:
      discovery:
        ephemeral: false

避坑提示：实例类型一旦确定，中途更改可能导致启动报错。若需修改，请先停止 Nacos，清理 /data/protocol/raft 目录下的元数据文件后再重启。

7. 环境隔离

不同环境（开发、测试、生产）之间必须严格隔离，避免相互干扰。Nacos 通过命名空间（Namespace）实现这一目标。

创建与配置

1. 在 Nacos 控制台创建新的命名空间（如 dev）。
2. 在应用配置中指定该 Namespace ID：

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

配置生效后，不同 Namespace 下的服务彼此不可见，实现了物理层面的隔离。

8. 配置中心

相比本地配置文件，Nacos 配置中心解决了配置修改需重启、多环境管理混乱等痛点，支持配置实时生效。

Bootstrap 引导文件

从 Spring Cloud 2020.0.0 版本开始，默认禁用了 bootstrap 上下文。我们需要引入依赖来恢复其功能：

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

随后创建 bootstrap.yml，优先级高于 application.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 与优先级

Nacos 根据规则构建 Data ID：${prefix} - ${spring.profiles.active} . ${file-extension}。

对于 order-service 且 active=local 的配置，实际会加载三个文件，优先级如下：

1. order-service-local.yaml（最高）
2. order-service.yaml
3. order-service

动态刷新

使用 @RefreshScope 注解标注的 Bean 会在配置变更时自动重建，无需重启服务。

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

    @GetMapping("/getValue")
    public void getValue() {
        log.info("getValue:{}", value);
    }
}

修改 Nacos 控制台中的配置值后，接口返回的数据会即时更新，真正实现了配置的动态热加载。