Spring Cloud Nacos 核心功能实战：服务注册与配置中心

直接使用硬编码 IP 调用（如 http://127.0.0.1:9000/product/...），一旦服务 IP 变更或环境切换，代码需频繁修改。

基于 Nacos 的负载均衡调用

利用 Nacos 的服务名解析能力，配合 @LoadBalanced 注解，实现服务名的动态路由。

1. 引入 LoadBalancer 依赖

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

2. 配置 RestTemplate

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

3. 调用示例

此时 URL 中使用服务名而非 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://product-service/product/getProductById?id=" + orderInfo.getProductId();
        ProductInfo productInfo = restTemplate.getForObject(url, ProductInfo.class);
        orderInfo.setProductInfo(productInfo);
        return orderInfo;
    }
}

4. 负载均衡与集群

Nacos 本身不直接处理负载均衡，而是配合客户端负载均衡器（如 Spring Cloud LoadBalancer）。默认策略（轮询、随机）可能忽略 Nacos 实例权重，需显式开启：

spring:
  cloud:
    loadbalancer:
      nacos:
        enabled: true

权重配置

在 Nacos 控制台编辑服务实例，设置权重值，高权重实例将接收更多流量。

同集群优先访问

为避免跨机房调用增加延迟，可配置集群名称。例如北京机房服务均设置为 cluster-beijing：

启动参数：

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

配置文件：

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

5. 健康检查机制

Nacos 支持两种健康检查模式，取决于实例类型：

• 临时实例（默认）：采用客户端主动上报心跳。若超过 15 秒未收到心跳标记为不健康，30 秒后剔除。
• 非临时实例：采用服务端反向探测。宕机后不会立即剔除，适合持久化服务。

如需将服务注册为非临时实例，配置如下：

spring:
  cloud:
    nacos:
      discovery:
        ephemeral: false

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

6. 环境隔离

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

创建与配置

在 Nacos 控制台创建命名空间，并在配置文件中指定 ID：

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

7. 配置中心

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

Bootstrap 上下文

从 Spring Cloud 2020.0.0 版本起，默认禁用 bootstrap 上下文。需引入额外依赖以支持 bootstrap.yml 加载：

<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

Data ID 规则

应用读取的配置文件的 Data ID 遵循以下公式：

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

实际启动时，系统会按优先级加载多个配置文件：

1. ${prefix}-${profiles.active}.${extension} (最高)
2. ${prefix}.${extension}
3. ${prefix}

例如 order-service-local.yaml > order-service.yaml > 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);
    }
}