SpringBoot整合Nacos自動刷新配置

• 2022 年 1 月 28 日
• 筆記
• nacos, Spring Boot, Spring Cloud, springboot, SpringCloud, 微服務, 自動刷新配置

目的

Nacos作為SpringBoot服務的註冊中心和配置中心。

在NacosServer中修改配置文件，在SpringBoot不重啟的情況下，獲取到修改的內容。

本例將在配置文件中配置一個 cml.age=100 的配置項，程序中編寫一個方法讀取配置文件，並通過 Get—>/test/age 接口提供給瀏覽器訪問。

• 若配置文件中的 age 修改為 200 ，不用重新啟動程序，直接訪問 /test/age 接口，將獲取到最新的值 200
• 若配置文件中沒有age 的配置項，或乾脆沒有 cml 的配置項，訪問 /test/age 接口將返回默認的值 18

環境

• SpringCloud：2020.0.3
• SpringCloudAlibaba：2021.1
• SpringBoot：2.5.2

pom

pom中引入 nacos 相關配置：discovery，config，bootstrap

網上有人說，需要引入 actuator ，其實不用。本例中還集成了 spring-cloud-starter-oauth2 ，根本沒有 SpringSecurity 攔截的問題

問題：NacosServer和NacosClient是如何通訊的？如果是http接口方式來回調用，為什麼沒有被SpringSecurity攔截？是否是rpc？

  <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring.cloud.dependencies}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>${spring.cloud.alibaba.dependencies}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
    <dependencies>
        <!-- nacos-discovery -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>
           <!--nacos config -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>
         <!--bootstrap-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-bootstrap</artifactId>
        </dependency>
    </dependencies>

配置文件

bootstrap.yml

server:
  port: 9556
spring:
  application:
    name: app
  profiles:
    active: test
    nacos:
      discovery:
        username: nacos
        password: nacos
        server-addr: 192.168.1.61:8848
      config:
        server-addr: 192.168.1.61:8848
        file-extension: yaml

app-dev.yml

此配置指 NacosServer 中的配置文件 app-dev.yml ，僅截取 cml.age 部分

cml:
   age: 100

代碼

• RefreshScope註解：必須加在 controller 上面，加在主啟動內上面不好使。哪些資源需要自動刷新配置就在該controller上面添加此註解，可封裝一個 BaseController 。
• @Value(“${cml.age:18}”)：讀取配置文件中的 cml.age 配置項值，賦給變量 age ，默認值為 18
• getAge：獲取年齡接口
• /test/age接口需要添加到 Security.permitAll

問題：RefreshScope註解為什麼一定要添加在 controller 上面？為什麼在主啟動類上面添加不生效

     @RefreshScope
     @Api(tags = "測試 - api")
     @Slf4j
     @RestController
     @RequestMapping("/test")
     public class TestController {
     
         /**
          * 獲取配置文件中的 cml.age 內容，若未獲取到，默認值為18
          */
         @Value("${cml.age:18}")
         private String age;
     
         @ApiOperation(value = "獲取年齡 - 測試配置自動刷新", notes = "獲取年齡 - 測試配置自動刷新")
         @GetMapping("/age")
         public String getAge() {
             return age;
         }
     }
     

日誌

開啟 nacos-refresh 日誌，打印配置內容更新情況

logging:
  level:
     com.alibaba.cloud.nacos.refresh: debug

打印的日誌：

2022-01-28 13:43:30.574 [com.alibaba.nacos.client.Worker.longPolling.fixed-192.168.1.61_8848-zjrkm-admin] DEBUG com.alibaba.cloud.nacos.refresh.NacosContextRefresher.innerReceive:136 - Refresh Nacos config group=DEFAULT_GROUP,dataId=identityQrCodeAdmin-service-cml-test.yaml,configInfo=spring:
  application:
    name: 
    .
    .
    .
    .
    .
    

測試

在不重啟SpringBoot服務的情況，多次在 NacosServer 中修改 cml.age 配置項的值，然後通過瀏覽器訪問 /test/age 接口，發現每次都可以獲取到最新的 age 值。