分布式微服务--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 接口(对于手动刷新场景)。

相关推荐
IT利刃出鞘12 分钟前
Intellij Idea--解决Cannot download “https://start.spring.io‘: Connect timedout
java·ide·intellij-idea
中国lanwp23 分钟前
Spring 全局异常处理机制:多个 @ControllerAdvice 与重复 @ExceptionHandler
java·数据库·spring
Ashlee_code25 分钟前
关税战火中的技术方舟:新西兰证券交易所的破局之道 ——从15%关税冲击到跨塔斯曼结算联盟,解码下一代交易基础设施
java·python·算法·金融·架构·系统架构·区块链
怒码ing2 小时前
分布式事务----spring操作多个数据库,事务以及事务回滚还有用吗
数据库·分布式·spring
hqxstudying2 小时前
SpringBoot启动项目详解
java·spring boot·后端
你我约定有三2 小时前
分布式微服务--Nacos作为配置中心(一)
分布式·微服务·架构
小熊h2 小时前
【分布式的个人博客部署】
linux·运维·服务器·分布式
keepDXRcuriosity3 小时前
IDEA识别lombok注解问题
java·ide·intellij-idea
酷飞飞3 小时前
C语言的复合类型、内存管理、综合案例
java·c语言·前端