SpringBoot结合Gradle用local profile启动时Cloud Config连接报错如何解决

核心原因 #

Spring Boot 2.4+ 版本中，spring.config.import 属性默认是累加生效而非覆盖，主配置 application.yml 中的必选配置导入 configserver: 会和 application-local.yml 中的可选配置导入同时生效，因此应用仍会尝试强制连接配置中心，导致启动失败。

以下方案均不需要修改主配置文件提交到代码仓库： #

方案1：Gradle任务中直接禁用Cloud Config（本地开发无需连接配置中心时推荐） #

系统属性优先级高于所有yml配置，直接在自定义启动任务中添加禁用配置中心的参数即可：

tasks.register("bootRunLocal") {
    group = "application"
    description = "Runs the Spring Boot application with the local profile"
    doFirst {
        tasks.bootRun.configure {
            systemProperty("spring.profiles.active", "local")
            // 直接禁用Spring Cloud Config功能
            systemProperty("spring.cloud.config.enabled", "false")
        }
    }
    finalizedBy("bootRun")
}

方案2：Gradle任务中覆盖导入配置（本地仍需可选连接配置中心时推荐） #

通过系统属性直接指定spring.config.import的值，避免和主配置累加：

tasks.register("bootRunLocal") {
    group = "application"
    description = "Runs the Spring Boot application with the local profile"
    doFirst {
        tasks.bootRun.configure {
            systemProperty("spring.profiles.active", "local")
            // 覆盖导入配置，仅保留可选的配置中心连接
            systemProperty("spring.config.import", "optional:configserver:")
        }
    }
    finalizedBy("bootRun")
}

方案3：修改local配置文件开启覆盖模式 #

无需改动Gradle任务，在application-local.yml中添加配置，指定导入属性采用覆盖逻辑替换主配置：

spring:
  application:
    name: mc-service-logistics-v2
  config:
    import: 'optional:configserver:'
    # 开启导入配置覆盖模式，替换主配置的导入项而非累加
    on-override: override

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