Spring Boot集成GCP Secret Manager遇Cloud SQL自动配置冲突问题

问题根源 #

添加spring-cloud-gcp-starter-secretmanager后，因项目中存在spring-cloud-gcp-starter-sql-mysql依赖，Cloud SQL的自动配置逻辑仍被触发——即便在application-dev.properties中排除GcpCloudSqlAutoConfiguration，仍有相关关联配置类（如DefaultCloudSqlJdbcInfoProvider）试图读取Cloud SQL实例连接名，最终导致参数缺失报错。

解决方案 #

方案1：直接禁用Cloud SQL自动配置（推荐） #

在application-dev.properties中添加以下配置，强制关闭Cloud SQL的自动配置开关：

spring.cloud.gcp.sql.enabled=false

该配置会直接阻止Cloud SQL相关自动配置类的初始化，无需手动排除多个配置类，简单高效。

方案2：在启动类中精确排除所有相关配置类 #

如果方案1不生效，可在Spring Boot启动类中排除所有与Cloud SQL相关的自动配置类，彻底切断触发逻辑：

@SpringBootApplication(exclude = {
    org.springframework.cloud.gcp.autoconfigure.sql.GcpCloudSqlAutoConfiguration.class,
    org.springframework.cloud.gcp.autoconfigure.sql.GcpCloudSqlProperties.class,
    org.springframework.cloud.gcp.autoconfigure.sql.CloudSqlJdbcAutoConfiguration.class
})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

方案3：检查并清理冗余配置 #

确认application-dev.properties中是否存在Cloud SQL相关配置，若有则删除或注释：

# 若存在类似配置，需移除
spring.cloud.gcp.sql.instance-connection-name=xxx
spring.cloud.gcp.sql.database-name=xxx
spring.cloud.gcp.sql.username=xxx
spring.cloud.gcp.sql.password=xxx

这类配置会触发Cloud SQL配置类的初始化逻辑，即便已排除自动配置类也可能引发冲突。

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