Spring Cloud Alibaba Nacos 使用详解

编写接口 提供一个简单的 REST 接口供消费者调用：

@RestController
@RequestMapping("/nacos")
public class TestController {
    @GetMapping("/test")
    public String test() {
        return "调用了服务者提供服务接口";
    }
}

启动项目后，登录 Nacos 控制台即可查看服务是否成功注册。

2. 创建服务消费者 (Consumer)

消费者端配置与提供者类似，主要区别在于需要实现负载均衡调用。

添加依赖 除了 Nacos Discovery 依赖，还需引入 Spring Cloud LoadBalancer：

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

配置 YML 文件

server:
  port: 9902
spring:
  application:
    name: nacos-consumer
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848

配置 RestTemplate 在配置类中注册带 @LoadBalanced 注解的 RestTemplate，以便通过服务名进行调用：

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

调用接口

@RestController
public class ConsumerController {
    @Resource
    private RestTemplate restTemplate;

    @GetMapping("/test")
    public ResponseEntity<String> test() {
        // 直接使用服务名 nacos-provider 即可
        return restTemplate.getForEntity("http://nacos-provider/nacos/test", String.class);
    }
}

启动消费者后，访问 http://localhost:9902/test，若返回正确内容，说明服务调用链路打通。

二、配置管理

微服务数量增多时，逐个修改配置文件不仅效率低且容易出错。Nacos 支持集中化管理配置，并能在变更时实时通知客户端，实现热更新。

1. 添加配置文件

在 Nacos 控制台新建配置。Data ID 的命名规则通常为：${prefix}-${spring.profiles.active}.${file-extension}。

• prefix：默认为应用名称，也可通过 spring.cloud.nacos.config.prefix 自定义。
• spring.profiles.active：当前环境标识（如 dev, prod）。
• file-extension：文件格式，支持 properties 或 yaml。

建议将核心配置及频繁变更的配置放入 Nacos，本地保留基础配置。

2. 拉取配置

创建一个测试模块，重点在于 bootstrap.yml 文件的配置。该文件优先级高于 application.yml，用于引导应用连接 Nacos。

添加依赖

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

配置 bootstrap.yml

spring:
  application:
    name: nacos-config
  profiles:
    active: dev
  cloud:
    nacos:
      server-addr: localhost:8848
      config:
        file-extension: yaml

此时应用会尝试从 Nacos 拉取名为 nacos-config-dev.yaml 的配置。

3. 读取配置

使用 @Value 注解注入配置项：

@RestController
public class NacosController {
    @Value("${datas.version}")
    private String version;

    @GetMapping("/test")
    public String test() {
        return "这是在 Nacos 中添加的配置信息：version = " + version;
    }
}

默认情况下，修改 Nacos 中的配置后，应用不会立即生效。如需实现热更新，请参考下文。

4. 配置热更新

方式一：添加 @RefreshScope 注解

在包含 @Value 注入的 Bean 类上添加 @RefreshScope，该类下的配置属性会在 Nacos 变更时自动刷新。

@RestController
@RefreshScope
public class NacosController { ... }

方式二：使用 @ConfigurationProperties

对于复杂配置，推荐使用 @ConfigurationProperties 绑定到对象，同样配合 @RefreshScope 使用。

@Component
@Data
@RefreshScope
@ConfigurationProperties(prefix = "datas")
public class DatasProperties {
    private String version;
}

这种方式比 @Value 更适合批量配置管理，且类型安全。

5. 多环境共享

Nacos 支持不同环境读取同一份公共配置。例如，所有环境共用的数据库连接池配置可以放在不带环境后缀的文件中（如 nacos-config.yaml），而环境特有配置放在 nacos-config-dev.yaml 中。

加载顺序通常是：

1. 本地配置文件
2. 公共配置文件 (${prefix}.yaml)
3. 环境配置文件 (${prefix}-${profiles.active}.yaml)

后加载的配置会覆盖先加载的配置，从而实现灵活的环境隔离与共享。

三、多环境配置隔离

开发、测试、生产环境的配置往往差异巨大。Nacos 通过 Namespace（命名空间） 实现数据隔离。

1. 创建命名空间

在 Nacos 控制台创建不同的 Namespace（如 dev, test, prod）。每个 Namespace 内的配置互不可见。

2. 指定命名空间

在客户端配置中指定 namespace-id：

spring:
  cloud:
    nacos:
      config:
        namespace: ${你的 namespace id}

这样，即使 Data ID 相同，不同环境的应用也会读取各自命名空间下的配置。

四、业务配置隔离

当微服务众多时，除了环境隔离，还需要按业务分组。Group 是 Nacos 中组织配置的另一个维度。

1. 指定 Group

在 Nacos 创建配置时，可以指定 Group（默认为 DEFAULT_GROUP）。例如订单系统可用 ORDER_GROUP，用户系统用 USER_GROUP。

2. 读取 Group 配置

客户端配置中指定对应的 Group：

spring:
  cloud:
    nacos:
      config:
        group: ORDER_GROUP

结合 Namespace 和 Group，可以实现精细化的配置权限控制。

五、Nacos 持久化

Nacos 默认使用内嵌 Derby 数据库，仅适合单机测试。生产环境务必切换为 MySQL。

1. 在 MySQL 中创建数据库 nacos_config。
2. 执行 Nacos 安装目录 conf 下的 schema/mysql.sql 脚本初始化表结构。
3. 修改 Nacos 配置文件 application.properties，取消 MySQL 数据源注释并填入账号密码。
4. 重启 Nacos Server。

六、集群搭建

为避免单点故障，推荐采用集群模式部署。官方架构通常包含多个 Nacos 节点及一个负载均衡器（如 Nginx）。

1. 配置集群

复制 cluster.conf.example 为 cluster.conf，填写集群节点 IP 列表：

192.168.124.1:8847
192.168.124.1:8848
192.168.124.1:8849

确保各节点端口不冲突，且网络互通。

2. 负载均衡

使用 Nginx 反向代理统一入口：

upstream nacos {
    server 192.168.124.1:8847;
    server 192.168.124.1:8848;
    server 192.168.124.1:8849;
}

server {
    listen 80;
    location / {
        proxy_pass http://nacos;
    }
}

客户端只需指向 Nginx 的地址即可自动感知集群节点。

七、高级配置

Nacos 默认支持 AP 模式（高可用），但在特定场景下可切换到 CP 模式（强一致性）。选择哪种模式取决于业务对数据一致性与可用性的权衡要求。如果对数据准确性要求极高，建议在配置中调整相关参数启用 CP 模式。