Spring Cloud Alibaba 2025.0.0 配置中心踩坑日记

Spring Cloud Alibaba 2025.0.0 配置中心踩坑日记从 2021.x 升到 2025.0.0 之后配置中心的写法全变了。bootstrap.yml 默认关掉、spring.config.import接入方式也换了、Nacos Server 版本还不对齐。踩了一堆坑整理下来备忘。环境组件版本Spring Boot3.5.16Spring Cloud2025.0.0Spring Cloud Alibaba2025.0.0.0Nacos Server3.0.3Java17坑spring-cloud-starter-bootstrap 和 spring.config.import 不能共存现象加了spring-cloud-starter-bootstrap依赖同时又在application-dev.yml里用spring.config.import导入 Nacos 配置。Nacos 控制台改了配置服务端也收到了推送但RefreshScope的 Bean 不刷新。日志里永远是Refresh keys changed: []涉及的依赖先说清楚这里涉及哪几个包!-- 这个必须引入Nacos 配置中心的核心包 --dependencygroupIdcom.alibaba.cloud/groupIdartifactIdspring-cloud-starter-alibaba-nacos-config/artifactId/dependency!-- 这个可选作用是重新打开 Spring Cloud 默认关闭的 bootstrap 上下文 --dependencygroupIdorg.springframework.cloud/groupIdartifactIdspring-cloud-starter-bootstrap/artifactId/dependencyspring-cloud-starter-alibaba-nacos-config这个包内部带了两套加载机制NacosPropertySourceLocator——走 bootstrap 阶段加载配置。需要spring-cloud-starter-bootstrap打开 bootstrap 上下文才会触发NacosConfigDataLoader——走spring.config.import阶段加载配置。不需要bootstrapSpring Cloud 2025 默认方式如果你同时引入上面两个依赖又在application-dev.yml里配了spring.config.import两套机制会一起跑。原因两套机制一起跑Nacos 配置被加载了两次pom.xml 里引入了触发无需 bootstrap拉配置又拉一次ContextRefresher 刷新这一份ConfigurationProperties 绑的是这一份spring-cloud-starter-bootstrap打开了 bootstrap 上下文spring-cloud-starter-alibaba-nacos-config自带两套加载器bootstrap 阶段NacosPropertySourceLocatorspring.config.import 阶段NacosConfigDataLoaderNacos ServerPropertySource A挂到 EnvironmentPropertySource B又挂到 Environment刷新事件Bean 绑定Nacos 推送配置变更时NacosContextRefresher→ 刷新 PropertySource A → A 的值确实变了但你的ConfigurationPropertiesBean → 绑的是 PropertySource B → B 没变ContextRefresher对比新旧值 → 穿帮了 → 检测不到变化 →Refresh keys changed: []两条链路各玩各的刷新了个寂寞。解决二选一只留一条路。方案 A只用spring.config.import推荐删掉spring-cloud-starter-bootstrap!-- ❌ 删掉 --!-- dependency groupIdorg.springframework.cloud/groupId artifactIdspring-cloud-starter-bootstrap/artifactId /dependency --!-- ✅ 只留这一个 --dependencygroupIdcom.alibaba.cloud/groupIdartifactIdspring-cloud-starter-alibaba-nacos-config/artifactId/dependencyapplication-dev.yml——不要有bootstrap.ymlspring:config:import:-optional:nacos:idle-store-oss-dev.yaml?groupDEFAULT_GROUPrefreshEnabledtruecloud:nacos:config:group:DEFAULT_GROUPserver-addr:127.0.0.1:8848namespace:idlestorediscovery:enabled:truegroup:DEFAULT_GROUPnamespace:idlestoreserver-addr:127.0.0.1:8848方案 B只用 bootstrap.yml老项目过渡用2025.1.x 之后废弃保留两个依赖dependencygroupIdcom.alibaba.cloud/groupIdartifactIdspring-cloud-starter-alibaba-nacos-config/artifactId/dependencydependencygroupIdorg.springframework.cloud/groupIdartifactIdspring-cloud-starter-bootstrap/artifactId/dependencybootstrap.ymlspring:application:name:idle-store-authcloud:nacos:config:server-addr:127.0.0.1:8848namespace:idlestorefile-extension:yamlrefresh-enabled:truediscovery:server-addr:127.0.0.1:8848namespace:idlestoreapplication-dev.yml——不要写spring.config.importspring:application:name:idle-store-auth2025.0.0 的正确打开方式踩完上面的坑总结一套能跑的配置模板。父 pompropertiesjava.version17/java.versionspring-boot.version3.5.16/spring-boot.versionspring-cloud.version2025.0.0/spring-cloud.versionspring-cloud-alibaba.version2025.0.0.0/spring-cloud-alibaba.version/propertiesdependencyManagementdependenciesdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-dependencies/artifactIdversion${spring-boot.version}/versiontypepom/typescopeimport/scope/dependencydependencygroupIdorg.springframework.cloud/groupIdartifactIdspring-cloud-dependencies/artifactIdversion${spring-cloud.version}/versiontypepom/typescopeimport/scope/dependencydependencygroupIdcom.alibaba.cloud/groupIdartifactIdspring-cloud-alibaba-dependencies/artifactIdversion${spring-cloud-alibaba.version}/versiontypepom/typescopeimport/scope/dependency/dependencies/dependencyManagement子模块依赖!-- Nacos 配置中心 --dependencygroupIdcom.alibaba.cloud/groupIdartifactIdspring-cloud-starter-alibaba-nacos-config/artifactId/dependency!-- Nacos 服务发现 --dependencygroupIdcom.alibaba.cloud/groupIdartifactIdspring-cloud-starter-alibaba-nacos-discovery/artifactId/dependency!-- 不要引入 spring-cloud-starter-bootstrap --配置文件推荐 spring.config.import 方式# application-dev.ymlspring:application:name:your-service-nameconfig:import:-optional:nacos:your-service-name-dev.yaml?groupDEFAULT_GROUPrefreshEnabledtrue# 这个前面对应的是 nacos 的>cloud:nacos:config:group:DEFAULT_GROUPserver-addr:127.0.0.1:8848namespace:your-namespacediscovery:enabled:truegroup:DEFAULT_GROUPnamespace:your-namespaceserver-addr:127.0.0.1:8848# Nacos 里的 your-service-name-dev.yaml —— 放需要动态刷新的业务配置your-property:your-value代码里绑定配置ConfigurationProperties(storage)ComponentRefreshScope// 别忘了DatapublicclassStorageProperties{privateStringtype;}