升级Spring Boot2.5.5与Spring Cloud2020.0.4后spring.config.import未定义如何解决

报错的根本原因 #

• Spring Cloud 2020.0.x（代号Ilford）及以上版本默认禁用了bootstrap启动流程，你未引入spring-cloud-starter-bootstrap依赖时，bootstrap.properties文件的所有配置都不会被加载，写在里面的禁用规则自然不生效。
• 引入spring-cloud-starter-bootstrap后仍然报错的核心原因是配置加载顺序问题：Spring Boot 2.4+重构了配置加载逻辑，spring.config.import相关的校验会在配置加载的极早期执行，如果禁用配置的优先级不够、或者配置规则冲突，就会触发校验失败。
• 你添加spring.config.import=optional:configserver:后报文件扩展名错误的原因是：项目中没有引入Spring Cloud Config客户端依赖，没有对应的PropertySourceLoader去解析configserver:前缀的导入地址，因此无法识别该配置格式。

正确解决办法 #

根据你是否使用Spring Cloud Config选择对应方案即可：

方案1：完全不需要使用Spring Cloud Config（推荐） #

不需要引入spring-cloud-starter-bootstrap依赖，也不需要修改bootstrap.properties，直接在application.properties最顶部添加以下两行配置即可：

# 完全禁用Spring Cloud Config功能
spring.cloud.config.enabled=false
# 关闭spring.config.import存在性校验
spring.cloud.config.import-check.enabled=false

注意：该场景下不要添加spring.config.import=optional:configserver:配置，没有Config客户端依赖时这行配置会触发解析错误。

方案2：需要使用Spring Cloud Config #

首先确保已引入Config客户端依赖：

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

之后在application.properties中添加配置即可：

# 可选标识optional代表配置中心连接失败也不终止启动，不需要可以去掉
spring.config.import=optional:configserver:
# 配置你的Config Server访问地址
spring.cloud.config.uri=http://你的配置中心地址:端口

如果你习惯用bootstrap.properties存放配置中心相关配置，再额外引入spring-cloud-starter-bootstrap依赖，把上述配置挪到bootstrap.properties中即可。

spring.config.import的正确格式说明 #

• Spring Cloud Config场景：格式为spring.config.import=[optional:]configserver:[配置中心地址]，optional为可选标识，加了之后配置中心连接失败不会终止启动；如果已经通过spring.cloud.config.uri单独配置了地址，只需要写spring.config.import=optional:configserver:即可。
• 本地/自定义配置文件导入场景：格式为spring.config.import=classpath:/自定义配置文件.properties或spring.config.import=file:/本地文件路径/xxx.yml，文件后缀必须是Spring Boot默认支持的properties/yml/yaml等格式。

内容的提问来源于stack exchange，提问作者mirec