Nacos配置项必须写在spring.cloud.nacos.config下，而非spring.nacos或spring.cloud.nacos；server-addr必填且不带http://，namespace和group需显式指定，依赖、@RefreshScope、鉴权等缺一不可，多环境需对齐dataId命名规则。
application.yml里nacos配置项写在哪一层
Spring Cloud Alibaba的Nacos配置必须放在spring.cloud.nacos.config下，不是spring.nacos或spring.cloud.nacos——后者只管注册中心，前者才管配置中心。很多人配了半天不生效，就是因为把server-addr直接挂在spring.cloud.nacos下面，结果配置拉不到，服务却能注册成功，造成“配置没变但服务重启了”的错觉。
常见错误现象：Unable to load configuration from nacos 或启动时没打印Located property source: [BootstrapPropertySource]
-
spring.cloud.nacos.config.server-addr：必填，格式为host:port（如127.0.0.1:8848），不能带http:// -
spring.cloud.nacos.config.namespace：非空字符串才生效，空字符串或注释掉等于用public空间；生产环境务必显式指定 -
spring.cloud.nacos.config.group：默认DEFAULT_GROUP，微服务间隔离靠它，别和注册中心的group混淆 - 如果用了
bootstrap.yml，配置必须放这里；若没启用bootstrap，application.yml也行，但得加spring.cloud.bootstrap.enabled=true
为什么服务注册到Nacos但配置不刷新
Nacos配置中心和注册中心是两套独立逻辑，注册成功 ≠ 配置加载成功。典型表现是服务在Nacos控制台可见，但修改配置后@Value或@ConfigurationProperties值不变，日志里也没有Refresh keys changed。
原因多是漏了依赖或注解：
立即学习“Java免费学习笔记（深入）”；
- 缺
spring-cloud-starter-alibaba-nacos-config依赖（仅引nacos-discovery不够） - 没加
@RefreshScope在使用@Value的类上（@ConfigurationProperties类不用加，但类本身要被@Component扫描到） -
spring.cloud.nacos.config.auto-refresh默认true，但如果配置了ext-config且其中某项refresh: false，整组都不会监听变更 - Nacos服务端开了鉴权但客户端没配
username/password，会导致长轮询静默失败，无报错但不刷新
多环境配置怎么对应Nacos的namespace+group+dataId
Spring Boot的spring.profiles.active=dev不会自动映射到Nacos的命名空间，得手动对齐。dataId生成规则是：${prefix}-${spring.profiles.active}.${file-extension}，其中prefix默认是spring.application.name。
例如服务名user-service，激活prod环境，file-extension=yaml，则dataId是user-service-prod.yaml；它必须存在于对应namespace和group下才能被加载。
- 别指望Nacos控制台“新建命名空间”后配置自动生效——namespace ID是UUID，客户端配的是ID，不是名称，复制错了就找不到
-
spring.cloud.nacos.config.ext-config[0].data-id=user-common.yaml这种扩展配置，group和refresh必须显式指定，否则走默认值，容易和主配置冲突 - 开发时用
localhost:8848，测试/生产换地址，建议用spring.cloud.nacos.config.server-addr=${NACOS_SERVER_ADDR:127.0.0.1:8848}，通过环境变量注入
Spring Cloud 2022+版本兼容Nacos 2.x要注意什么
Spring Cloud 2022.0.0（对应Spring Boot 3.x）起，spring-cloud-starter-alibaba-nacos-config官方已停止维护，必须用社区维护的spring-cloud-starter-alibaba-nacos-config 2022.x 分支（如2022.0.0.0-RC1），否则启动报NoClassDefFoundError: com/alibaba/nacos/api/config/listener。
关键差异点：
- 不再支持
com.alibaba.cloud:spring-cloud-starter-alibaba-nacos-config:2.2.10.RELEASE这类旧坐标，必须切到com.alibaba.cloud新组织下的2022+版本 -
spring.cloud.nacos.config.contextPath废弃，改用spring.cloud.nacos.config.endpoint（用于集群寻址） - Nacos 2.2+默认开启gRPC，客户端需确保
netty-all版本与Nacos服务端匹配（推荐4.1.94.Final），否则连接闪断 - Spring Boot 3要求Java 17+，而Nacos 2.0+客户端最低支持Java 11，但2.2+建议Java 17，低版本运行时可能触发
UnsupportedClassVersionError
ApplicationContext刷新前就完成了，所以@PostConstruct里取不到动态刷新后的值；真要等配置就绪，得监听RefreshEvent或者用@EventListener，这点容易被忽略。 
