Param ‘serviceName‘ is illegal, serviceName is blank

背景

有个朋友在学习nacos 遇到一个问题，在bootstrap.yml 文件中配置注册服务的地址信息时，启动服务报错：Param ‘serviceName’ is illegal, serviceName is blank 。但是在application.yml 中配置就不会报错。这里记录一下解决的方法。

项目环境：

1. springboot 2.4.2
2. spring-cloud-alibaba-dependencies 2021.1
3. spring-cloud-dependencies 2020.0.0

分析

1、先看一眼bootstrap配置文件

spring:
  application:
    name: nacos-demo
  cloud:
    nacos:
      discovery:
        enabled: true
        server-addr: 127.0.0.1:8848
        

      config:
        ###配置中心连接地址
        server-addr: 127.0.0.1:8848
        ###分组
       # group: DEFAULT_GROUP
        ###类型
        file-extension: yaml

2、serviceName is blank 说明没有serviceName 断点调式看一下源码。

可以发现，这个serviceName 来自于配置文件，如果没有指定，默认使用${spring.application.name:} 如果spring.application.name 没有指定 就默认为"";

3、但是配置文件中spring.application.name 配置了值。为什么serviceName 还是空白呢？ 然后将配置挪到application配置文件中，启动项目没问题。
那就说明bootstrap 没有被加载。 不应该啊，springcloud 项目默认不是优先加载bootstrap 配置文件。难道spring-cloud-dependencies 2020.0.0 对于这个默认规则修改了吗。

4、带着错误提示和疑问百度了一波，终于找到一篇文章，回答了我的疑问。
原来spring-cloud-dependencies 2020.0.0 版本不在默认加载bootstrap 文件，如果需要加载bootstrap 文件需要手动添加依赖。

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-bootstrap</artifactId>
        </dependency>

然后重启项目，项目启动成功。

参考文章：
https://www.gitmemory.com/issue/alibaba/nacos/5448/825744406
https://docs.spring.io/spring-cloud-config/docs/current/reference/html/#config-first-bootstrap

总结

spring-cloud-dependencies 2020.0.0 默认不在加载bootstrap 配置文件，如果项目中要用bootstrap 配置文件 需要手动添加spring-cloud-starter-bootstrap 依赖，不然启动项目会报错的。