Spring Boot 2.4+本地开发如何禁用Spring Config Server连接

问题根因 #

Spring Cloud 2020.0.4对应Spring Boot 2.4+版本后，spring.config.import的配置处理优先级远高于普通application配置文件中的属性，所以你在application-local.yaml中写的spring.cloud.config.enabled=false加载时机晚于配置导入逻辑，无法拦截Config Server的连接请求。

可行方案（均满足不使用bootstrap、不引入legacy依赖的要求） #

• 方案1：分环境声明spring.config.import
  不要在全局application.yaml中写死configserver导入配置，通过多文档块或者环境专属配置文件，只在非本地环境声明导入规则，示例如下：

  # 主application.yaml公共配置
  spring:
    profiles:
      active: ${SPRING_PROFILES_ACTIVE:local}
  ---
  # 非local环境专属配置
  spring:
    config:
      activate:
        on-profile: "!local"
      import: configserver:${CONFIG_SERVER_URI:http://localhost:8888}
    cloud:
      config:
        fail-fast: true
  

  本地启用local profile时不会加载configserver导入规则，自然不会触发连接逻辑，无需额外配置禁用。

• 方案2：本地启动时用启动参数覆盖规则
  本地启动服务时，添加启动参数直接清空import配置，优先级高于配置文件：

  --spring.config.import=
  

  也可以直接添加禁用Config Server的启动参数，优先级足够提前拦截导入逻辑：

  --spring.cloud.config.enabled=false
  

• 方案3：用optional前缀配置导入规则
  全局配置里直接用optional前缀声明非强制导入，本地即使没有Config Server也会跳过连接直接启动：

  spring:
    config:
      import: "optional:configserver:${CONFIG_SERVER_URI:http://localhost:8888}"
  

  这个方案不需要分环境配置，非本地环境如果Config Server不可用才会跳过，如果你需要非本地环境强制校验Config Server可用性，不推荐该方案。

异常现象说明 #

1. 启动后无日志卡住：默认不带optional前缀的configserver导入是强制的，连接失败会静默重试，且重试日志默认级别为debug，所以看不到输出，看起来像卡住。
2. IntelliJ无法识别import-check属性：是spring-cloud-starter-config:3.0.5版本的配置元数据缺失导致的，不影响实际功能运行，升级到3.0.6及以上版本即可恢复正常识别。

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