SpringCloud读取Nacos配置中心报错:Could not resolve placeholder ‘xxx’ in value ‘${xxx}
作者:mmseoamin日期:2023-12-18

hello,我是灰小猿,一个超会写bug的程序员!

近期在写一个spring cloud Alibaba读取Nacos配置中心远程配置文件的内容时,出现了几个比较坑的bug,在此记录一下,帮大家避避坑。

我的使用场景:

  • SpringBoot版本为2.6.0
  • Spring Cloud版本为2021.0.1
  • Spring Cloud Alibaba版本为2021.0.1.0

    如果你的Cloud版本是2020.0.0版本之后的,建议直接先看是否是由第二个坑引起的。

    第一个坑:Could not resolve placeholder ‘xxx’ in value ‘${xxx}

    出现该报错的意思一般是使用@Value()注解读取的配置文件数据无法解析

    可能情况有两种:一种是配置文件注册进去了,但是没有读取到配置文件中的指定参数

    第二种情况:配置文件就没有解析注册,导致无法读取到参数信息,我的是由于第二种,解决在第二个坑。

    如果第一种就检查yml中参数格式是否正确,拼写是否正确等

    如果确认都正确就可能是下面的原因:

    因为根据官方文件介绍,

    SpringCloud读取Nacos配置中心报错:Could not resolve placeholder ‘xxx’ in value ‘${xxx},第1张

     因此需要检查你本地代码中的bootstrap.yml中写的配置文件的名称,是否能够和Nacos中的配置文件的名称对应上,

    在这里还应该注意:Nacos中的配置文件的DataId中要写入文件的后缀,并且Nacos是区分yaml和yml的,所以Nacos中的后缀要和本地bootstrap.yml中的file-extension的参数对应!

    正确的情况下,我的Nacos文件如下:

    SpringCloud读取Nacos配置中心报错:Could not resolve placeholder ‘xxx’ in value ‘${xxx},第2张

    我的 bootstrap.yaml文件如下:

    server:
      port: 8081
    spring:
      application:
        name: nacos-config-a
      cloud:
        nacos:
          config: # 项目在启动时,配置怎么去哪里拿去配置文件?
            server-addr: localhost:8848
            username: nacos
            password: nacos
            file-extension: yaml # 配置文件类型
            # namespace: public # namespace不写时去默认名称空间获取
            # group: DEFAULT_GROUP # group不写时去默认组获取
            # prefix: nacos-config-a # 表示读取哪个配置文件?不写时默认使用${spring.application.name}
    

    以上配置文件名称对应完毕之后,先启动Nacos,再重启启动本地IDEA,测试是否启动成功!

    如果确定上述文件配置没有问题的话,建议看一下是否是第二个坑,

    第二个坑:Param ‘serviceName‘ is illegal, serviceName is blank

    我就是上面确定文件类型对应没有问题了,但是启动还是会报第一个错误,经过很多尝试之后出现了第二个报错,当然同学们也肯定没有出现第二个报错,仍然还是启动不起来,

    我们知道SpringCloud连接远程Nacos是需要使用bootstrap配置文件的,

    但是在2020.0.0版本之后,SpringCloud不再默认识别并加载bootstrap.yml配置了,也就是说就算你有bootstrap.yml文件,在不引入相关依赖的情况下,系统启动也不会给你读取的,坑!!!

    因此如果你需要启动bootstrap配置,需要在你的pom中加入如下依赖,

            
                org.springframework.cloud
                spring-cloud-starter-bootstrap
            

    之后重新加载pom,并启动项目即可!

    如果大家有遇到相关问题或其他解决,也欢迎在评论区留言讨论!

    我是灰小猿,我们下期见!