Spring Cloud Alibaba 2021.0.1.0之Nacos升级

1 背景

本次隆重发布的 Spring Cloud Alibaba 2021.0.1.0 版本在 Spring Cloud 2021.0.1、Spring Boot 2.6.3 的基础上对其中包括注册配置中心、分布式消息等在内的众多组件进行重大升级：

• Nacos：升级 Nacos 客户端到 1.4.2 版本，修复了 Nacos 1.4.1 所存在的相关问题，支持了 Nacos 服务发现失败容错等相关能力。
• RocketMQ：升级到了 4.9.2，并将之前项目中的 RocketMQ 单独分支融入到了项目主分支，跟随大版本一起发布迭代，使用户可在最新 Spring Cloud Alibaba 中直接使用 RocketMQ 新支持的批量消息、异步消息回调处理、Push 模式下指定消费起始位等众多新特性。
• Sentinel：升级到了 1.8.3，除了修复部分之前版本所存在的问题外，还提供了丰富的针对 FeignClient 的容错能力，支持针对全局 FeignClient 配置默认熔断规则，支持对单个 FeignClient 配置特定容错规则以及支持针对单个方法配置熔断规则等能力。
• Spring Boot：在Spring Boot 2.6.3 版本基础上，支持了 spring.config.import 的应用配置方式，方便用户更友好地在应用中配置和使用 Nacos 配置中心。
• 除了组件升级，另外也修复了很多之前版本所存在的问题，进一步提升了 Spring Cloud Alibaba 使用的稳定性与健壮性。

2 Nacos升级指南

2.1 升级操作

如果项目中需要使用 Spring Cloud Alibaba 2021.0.1.0 版本，请在项目中添加如下依赖：

<dependencyManagement>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-dependencies</artifactId>
        <version>2.6.3</version>
        <type>pom</type>
        <scope>import</scope>
    </dependency>
    
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-dependencies</artifactId>
        <version>2021.0.1</version>
        <type>pom</type>
        <scope>import</scope>
    </dependency>

    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-alibaba-dependencies</artifactId>
        <version>2021.0.1.0</version>
        <type>pom</type>
        <scope>import</scope>
    </dependency>
</dependencyManagement>

注意事项：spring-cloud-starter-alibaba-nacos-config 模块移除了 spring-cloud-starter-bootstrap 依赖，如果你想以旧版的方式使用，你需要手动加上该依赖，现在推荐使用 spring.config.import 方式引入配置。完成以上步骤就能无缝切换到 spring cloud alibaba 2021.0.1.0 版本。

2.2 新特性以及使用方式

2.2.1 支持 spring.config.import

这里假设有一个配置文件(bootstrap.yml)，升级到新版本应该怎么配置呢？

spring:
  cloud:
    nacos:
      config:
        name: test.yml
        group: DEFAULT_GROUP
        server-addr: 127.0.0.1:8848
        extension-configs:
          - dataId: test01.yml
            group: group_01
          - dataId: test02.yml
            group: group_02
            refresh: false

这两个配置是等价的：

# application.yml

spring:
  cloud:
    nacos:
      config:
        group: DEFAULT_GROUP
        server-addr: 127.0.0.1:8848
  config:
    import:
      - optional:nacos:test.yml  # 监听 DEFAULT_GROUP:test.yml
      - optional:nacos:test01.yml?group=group_01 # 覆盖默认 group，监听 group_01:test01.yml
      - optional:nacos:test02.yml?group=group_02&refreshEnabled=false # 不开启动态刷新
      - nacos:test03.yml # 在拉取nacos配置异常时会快速失败，会导致 spring 容器启动失败

注意事项:
如果使用 spring.config.import 就不能使用 bootstrap.yml/properties 引入配置的方式了 !!!
如果引入了 spring-cloud-starter-alibaba-nacos-config，并且使用 import 方式导入配置， 项目启动时会自动检测是否引入了 nacos: 条目，如果没有 import nacos 条目，会出现错误。

上述解决办法如下：
你可以手动通设置 spring.cloud.nacos.config.import-check.enabled=false 关闭它，但是不建议这么做，这个功能可以帮助你检查是否引入多余依赖。

假如想保留以前的使用方式 (bootstrap引入配置)，你只需要添加依赖 spring-cloud-starter-bootstrap 依赖，不需要修改一行代码。

3 Nacos 容错能力

新增配置项 spring.cloud.nacos.discovery.failure-tolerance-enabled， 设置为 true (默认 false) 开启 nacos 服务发现失败容错能力，该功能会在 nacos 获取实例失败时返回上一次获取的实例，可以在 nacos server 网络不稳定时提供容错能力，不会导致请求全部挂掉。