Nacos 配置热更新：Spring Boot Bean 自动获取最新配置

前言：简单记录下nacos的动态刷新获取以及版本兼容问题

nacos 配置相关

命名空间

配置列表

一些简单的配置

代码

demo

package com.ruoyi.web.mytest.nacos;import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;/*** 实现功能测试：nacos的配置文件修改了数据，这个bean就会动态的刷新获取。** 涉及到的代码：添加了一个 bootstrap.yml 的配置类，然后nacos再添加一个配置来测试--命名空间和配置管理那里** @author lujinhong* @since 2025-08-14*/
@RefreshScope //nacos 配置刷新
@RestController
@RequestMapping("/nacos")
public class NacosTest {/*** 问题：为什么 ${user.name} 能拿到nacos服务端的配置数据。** Spring Cloud Alibaba Nacos Config 会在Spring Boot 启动的最早阶段，在加载到bootstrap.yml时，* 去 Nacos 服务器加载对应 Data ID 的配置文件，然后把这些配置项放进 Spring Environment 里，* 而且优先级比本地 application.yml 高。** @Value("${user.name}") 能拿到 Nacos 的值，* 是因为 Nacos 配置会在启动时注入到 Spring Environment 里，* 而 @Value 从 Environment 取值，不管值来自本地文件、远程配置还是系统变量，只要名字匹配就能取到*/@Value("${user.name}")private String userName;@GetMapping("/user")public String getUserName(){System.err.println("获取nacos中的user.name的值：" + userName);return "获取nacos中的user.name的值：" + userName;}}

配置文件 bootstrap.yml

# bootstrap.yml 加载时机比 application.yml 快
spring:application:name: demo-servicecloud:nacos:discovery:server-addr: 19xxxxxxxxx9:8848namespace: test_ruoyigroup: ljh_ruoyi-groupconfig:server-addr: 19xxxxxxxxx9:8848namespace: test_ruoyigroup: ljh_ruoyi-groupfile-extension: ymlcompatibility-verifier:enabled: false

测试

注释事项

版本兼容问题

我这个是使用若依框架来测试的，框架版本和cloud版本不一样，因为使用 @RefreshScope 这个动态获取数据，需要用到【org.springframework.cloud.context.config.annotation.RefreshScope;】这个依赖。

【@RefreshScope 是 Spring Cloud 提供的注解，用来让 Spring 管理的 Bean 支持动态刷新配置】

Description: Your project setup is incompatible with our requirements due to following reasons:- Spring Boot [2.5.15] is not compatible with this Spring Cloud release train Action: - Consider applying the following actions:

问题解决方法：

主要记录的就是这个版本兼容问题，用的是这些依赖

依赖的版本

        <!-- nacos 配置中心--><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId><version>2021.1</version></dependency><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-bootstrap</artifactId><version>3.0.1</version></dependency><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId><version>2021.1</version></dependency>

关闭兼容错误提示

如果在启动的时候一直说版本不一样，如：

Spring Cloud 在启动时，会默认 检查 Spring Boot 和 Spring Cloud 版本是否兼容，如果不兼容就会抛出错误
（比如之前的 “Spring Boot [2.5.15] is not compatible with this Spring Cloud release train”）

spring.cloud.compatibility-verifier.enabled: false 是 Spring Cloud 的兼容性验证开关，在配置文件把它关闭就行了。