分布式微服务--Nacos作为配置中心(补)关于bosststrap.yml与@RefreshScope

一、关于bosststrap.yml

bootstrap.ymlapplication.yml 的区别

对比项 bootstrap.yml application.yml
加载时机 优先于 application.yml 加载(启动早期) 程序初始化完成后加载
主要用途 设置应用的外部配置源注册中心信息 设置应用内部配置,如端口、日志级别、bean 配置等
使用场景 需要在程序启动早期就完成配置加载的情况 常规配置

✅ Nacos 配置中心为什么推荐用 bootstrap.yml

Spring Cloud Alibaba 的配置加载机制,是基于 Spring Cloud Config 客户端架构 实现的,读取远程配置的行为是发生在应用上下文启动之前

🚨 也就是说:如果你把 Nacos 的配置写到 application.yml,此时还没加载配置中心,自然就读取不到远程配置。

所以要写到 bootstrap.yml


✅ 实际建议(记住这个就行):

凡是涉及到外部配置源(如 Nacos 配置中心、Spring Cloud Config Server、Apollo 等)的信息,必须写在 bootstrap.yml 中。

比如这些字段:

java 复制代码
spring:
  application:
    name: nacos-config-demo
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848
        file-extension: yaml

✅ Spring Boot 3.x 的变化(附加知识)

从 Spring Boot 2.4 开始,引入了一个新的配置机制叫做 config 子系统 ,官方推荐使用 application.yml + configimport 替代 bootstrap.yml

比如你可以写成:

java 复制代码
spring:
  config:
    import: nacos:nacos-config-demo.yaml

但目前大多数 Spring Cloud Alibaba 项目依旧推荐 bootstrap.yml,特别是 Spring Boot 2.x 的项目。

一、@RefreshScope注解

✅为什么需要 @RefreshScope

在使用 Nacos 作为配置中心时,我们常常希望在不重启服务的情况下,动态刷新配置项的值 。Spring Cloud 提供了 @RefreshScope 注解来实现这个需求。

默认情况下,Spring 容器中注入的配置值(如通过 @Value@ConfigurationProperties)在应用启动后就被固定了,即使 Nacos 中的配置发生了变更,也不会自动刷新,除非重启服务。

因此:

@RefreshScope 的作用就是:

让被注解的类或 Bean 在配置变更时,能够自动重新加载最新的配置,实现配置的热更新。


✅加在哪里?

1. 用在配置类上(推荐)
java 复制代码
@RefreshScope
@Configuration
@ConfigurationProperties(prefix = "user")
public class UserConfig {
    private String name;
    private Integer age;
    // 省略 getter/setter
}

此时,如果 Nacos 中 user.nameuser.age 的配置发生变更,该类会自动重新加载配置。

2. 用在使用 @Value 的类上
java 复制代码
@RestController
@RefreshScope  // 必须加在类上
public class UserController {

    @Value("${user.name}")
    private String name;

    @GetMapping("/user/name")
    public String getName() {
        return name;
    }
}

注意:如果你用的是 @Value必须加在类上才会生效。加在字段上无效!


✅ 配合使用的前提

要使 @RefreshScope 生效,还需确保:

  1. Nacos 配置变更时已开启 自动刷新refresh: true)。

  2. 引入了必要依赖(Spring Cloud Alibaba Nacos Config)。

  3. 项目中引入了 Spring Boot Actuator,并暴露了 /actuator/refresh 接口(对于手动刷新场景)。

相关推荐
cyforkk2 小时前
ArrayList vs LinkedList:底层原理与实战选择指南
java
孟婆来包棒棒糖~4 小时前
泛型与反射
java·反射·javase·泛型
A尘埃4 小时前
Spring Event 企业级应用
java·spring·event
YuTaoShao6 小时前
【LeetCode 热题 100】139. 单词拆分——(解法一)记忆化搜索
java·算法·leetcode·职场和发展
Best_Liu~6 小时前
策略模式 vs 适配器模式
java·spring boot·适配器模式·策略模式
小陈永不服输6 小时前
Windows下RabbitMQ完整安装指南
windows·分布式·rabbitmq
direction__7 小时前
Java Main无法初始化主类的原因与解决方法(VsCode工具)
java·vscode
帧栈7 小时前
开发避坑指南(29):微信昵称特殊字符存储异常修复方案
java·mysql
每天的每一天7 小时前
面试可能问到的问题思考-Redis
java
青云交7 小时前
Java 大视界 -- Java 大数据在智能安防人脸识别系统中的活体检测与防伪技术应用
java·大数据·生成对抗网络·人脸识别·智能安防·防伪技术·活体测试