关于 Nacos 配置加载的问题说明

[xuxiaowei-com-cn]

1. 无论使用哪个版本的 spring-cloud-alibaba，保持 com.alibaba.nacos:nacos-client 与 nacos 服务版本接近，请勿跨大版本使用：
   1. spring-cloud-alibaba 2025.0.0.0 中的 nacos 版本是 3.0.3，需要使用 nacos 3.x，使用 nacos 2.x 将无法正确获取到配置，如果无法升级 nacos 服务，请排除 spring-cloud-starter-alibaba-nacos-discovery、spring-cloud-starter-alibaba-nacos-config 中的 com.alibaba.nacos:nacos-client:3.0.3，使用 com.alibaba.nacos:nacos-client:2.5.1（Nacos 在 namespace 为空的情况，无法读取public命名空间的文件 #4094 ）
2. application.yml 配置如下：

spring:
  application:
    name: gateway
  profiles:
    # 环境配置
    active: dev
  config:
    import:
      - optional:nacos:application-${spring.profiles.active}.${spring.cloud.nacos.config.file-extension}
      - optional:nacos:${spring.application.name}-${spring.profiles.active}.${spring.cloud.nacos.config.file-extension}
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
      config:
        server-addr: 127.0.0.1:8848
        file-extension: yml

[xuxiaowei-com-cn]

@Shiyajian

[baifachuan]

#4104

我的这个issue的nacos server和client的版本是对齐了的，并且nacos注册成功了的，我通过手动debug在代码里面进行调试，也能拿到注册在nacos的配置，我现在debug到的位置是发现：

NacosPropertySourceLocator#locate(Environment env)

这个方法没有被调用，也就是并没有把nacos的config注入到spring的context中，不是nacos server和client的版本问题。

[xuxiaowei-com-cn]

你是使用哪种方式引入的 nacos 的配置？ 我在B站有视频，最后遇见这个问题，解决了： 【RuoYi-Cloud 升级 Spring Boot 4.0.0、Spring Cloud 2025.1.0【直播录像】-哔哩哔哩】 https://b23.tv/qclFfdt

[baifachuan]

4.0.0

<dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>

这种引入。

[baifachuan]

4.0.0

<dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>

这种引入。

这种方式引入的nacos client的版本是3.0.3，我的nacos server也是3.0.3，版本是没有问题，读取注册也没有问题，现在的问题就是相关的config没有注入到spring 的context里面，链路就是NacosPropertySourceLocator#locate(Environment env) 这个相关的整个链路流程都没有被调用。

[xuxiaowei-com-cn]

我问的不是这个，是配置文件名的使用方式，比如：system-dev.yml

[baifachuan]

我问的不是这个，是配置文件名的使用方式，比如：system-dev.yml

bootstrap.yml

的配置文件引入的，内容是：

spring:
  debug: true
  logging:
    level:
      com.alibaba.nacos.client.config: DEBUG
      org.springframework.cloud.alibaba.nacos: DEBUG
  mvc:
    servlet:
      load-on-startup: 1
  application:
    name: xiaoman-gateway
  profiles:
    active: dev
  cloud:
    bootstrap:
      enabled: true
    nacos:
      username: nacos # 替换为您的Nacos用户名
      password: nacos # 替换为您的Nacos密码
      discovery:
        server-addr: ${nacos_host:127.0.0.1}:${nacos_port:8848}
        # 命名空间，默认：public
        namespace: ${nacos_namespace:}
        service: ${spring.application.name}
      config:
        server-addr: ${spring.cloud.nacos.discovery.server-addr}
        namespace: ${spring.cloud.nacos.discovery.namespace}
        file-extension: yaml
        fileExtension: yaml
        # 指定配置
        extension-configs:
          - data-id: datasource.yaml
            refresh: true

我自己写了个debug类的流程：

import com.alibaba.cloud.nacos.client.NacosPropertySourceLocator;
import jakarta.annotation.PostConstruct;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.env.Environment;
import org.springframework.core.env.PropertySource;

@Configuration
public class NacosDebugConfig {
    @Autowired
    private NacosPropertySourceLocator nacosPropertySourceLocator;
    @Autowired
    private Environment environment;

    @PostConstruct
    public void debugLocate() {
        // 手动调用locate方法，验证是否能加载配置
        PropertySource<?> propertySource = nacosPropertySourceLocator.locate(environment);
        System.out.println("手动调用locate()结果：" + propertySource);
    }
}

就能load到spring中，但是已经是事后了，bean已经出来了，默认启动的话，能读取到nacos的配置，但是就是没有注入进去。

[xuxiaowei-com-cn]

你试试用 application.yml spring.config.import

[baifachuan]

👍 从 bootstrap.yml 的配置文件变更到 application.yml 去，内容不变：

spring:
  cloud:
    nacos:
      username: nacos # 替换为您的Nacos用户名
      password: nacos # 替换为您的Nacos密码
      discovery:
        server-addr: ${nacos_host:127.0.0.1}:${nacos_port:8848}
        # 命名空间，默认：public
        namespace: ${nacos_namespace:}
        service: ${spring.application.name}
      config:
        server-addr: ${spring.cloud.nacos.discovery.server-addr}
        namespace: ${spring.cloud.nacos.discovery.namespace}
        file-extension: yaml
        # 指定配置
        extension-configs:
          - data-id: datasource.yaml
            refresh: true
  config:
    import:
      # 导入nacos配置中心的配置文件
      - optional:nacos:datasource.yaml
  

就能注入到spring context中了，看起来是两种加载方式下， bootstrap.yml 的load的地方哪儿有点问题。