Spring Boot在GCE上无法从GCP Secret Manager加载DataSource配置

尝试配置部署在GCE（Google Compute Engine）上的Spring Boot应用，从GCP Secret Manager获取数据库连接属性，目标是将数据库URL、用户名、密码等存储为单条secret（格式类似.properties），让Spring Boot启动时自动加载。

环境配置 #

• GCP Secret Manager：已创建名为db-info的secret，latest版本内容为：

spring_datasource_url=jdbc:mysql://0.0.0.0/name
spring_datasource_username=username
spring_datasource_password=password

（注：使用下划线_而非Spring Boot常用的点.，不确定格式是否正确）

• GCE实例：Spring Boot应用为Gradle构建的JAR，已确认可通过gcloud命令访问secret内容，实例已设置GCP_PROJECT_ID环境变量，关联服务账号拥有roles/secretmanager.secretAccessor权限。
• Gradle配置：Spring Boot 3.3.10，Java 17，已引入spring-cloud-gcp-starter-secretmanager依赖。
• Spring Boot配置：application.properties中配置了spring.config.import=sm://db-info，DataSource相关属性留空等待覆盖。

启动报错 #

应用启动失败，无法配置DataSource，错误日志如下：

25-04-23T15:49:53.224+09:00  INFO 56776 --- [lagom-api] [           main] s.n.l.LagomPortoneApplicationKt          : No active profile set, falling back to 1 default profile: "default"
2025-04-23T15:49:58.108+09:00  WARN 56776 --- [lagom-api] [           main] ConfigServletWebServerApplicationContext : Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'entityManagerFactory' defined in class path resource [org/springframework/boot/autoconfigure/orm/jpa/HibernateJpaConfiguration.class]: Failed to initialize dependency 'dataSourceScriptDatabaseInitializer' of LoadTimeWeaverAware bean 'entityManagerFactory': Error creating bean with name 'dataSourceScriptDatabaseInitializer' defined in class path resource [org/springframework/boot/autoconfigure/sql/init/DataSourceInitializationConfiguration.class]: Unsatisfied dependency expressed through method 'dataSourceScriptDatabaseInitializer' parameter 0: Error creating bean with name 'dataSource' defined in class path resource [org/springframework/boot/autoconfigure/jdbc/DataSourceConfiguration$Hikari.class]: Failed to instantiate [com.zaxxer.hikari.HikariDataSource]: Factory method 'dataSource' threw exception with message: Failed to determine suitable jdbc url
2025-04-23T15:49:58.262+09:00 ERROR 56776 --- [lagom-api] [           main] o.s.b.d.LoggingFailureAnalysisReporter   :

***************************
APPLICATION FAILED TO START
***************************

Description:

Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.

Reason: Failed to determine suitable jdbc url


Action:

Consider the following:
        If you want an embedded database (H2, HSQL or Derby), please put it on the classpath.
        If you have database settings to be loaded from a particular profile you may need to activate it (no profiles are currently active).

疑问 #

• spring-cloud-gcp-starter-secretmanager能否正确解析单条secret中的多行properties格式内容？
• 是否是因为secret中使用下划线（spring_datasource_url）而非点（spring.datasource.url）导致的问题？是否需要修改secret格式？
• spring.config.import=sm://...是否需要额外配置才能支持该格式？
• 如何修改配置让Spring Boot成功从该GCP单条secret加载数据库属性？

1. 多行properties格式解析支持 #

spring-cloud-gcp-starter-secretmanager完全支持解析单条secret中的多行properties格式内容，只要导入方式正确，Spring会将其识别为合法的配置属性源。

2. 下划线vs点格式的问题 #

这是核心问题。Spring Boot的配置属性默认使用点分隔（spring.datasource.url），下划线分隔的spring_datasource_url无法被Spring正确映射到对应的DataSource配置属性，必须修改secret内容为标准点格式：

spring.datasource.url=jdbc:mysql://0.0.0.0/name
spring.datasource.username=username
spring.datasource.password=password

3. spring.config.import的额外配置要求 #

对于Spring Boot 3.x + 最新版Spring Cloud GCP，spring.config.import=sm://db-info本身不需要额外配置，但需注意两点：

• 确保spring-cloud-gcp-starter-secretmanager版本与Spring Boot 3.3.10兼容（建议使用2.0.x及以上版本）
• 若secret不是使用默认的latest版本，需指定版本号，比如sm://db-info?version=1

4. 完整配置修改步骤 #

1. 更新Secret Manager中的secret内容：将db-info的latest版本替换为标准点格式的properties内容
2. 验证Gradle依赖配置：确保依赖版本兼容，示例配置如下：

plugins {
    id 'org.springframework.boot' version '3.3.10'
    id 'io.spring.dependency-management' version '1.1.6'
    id 'java'
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'

java {
    sourceCompatibility = '17'
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'com.google.cloud:spring-cloud-gcp-starter-secretmanager'
    runtimeOnly 'com.mysql:mysql-connector-j'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

tasks.named('test') {
    useJUnitPlatform()
}

3. 确认application.properties配置：保留spring.config.import=sm://db-info，无需手动配置DataSource相关属性，Spring会自动从secret加载覆盖
4. 重启应用：将更新后的应用部署到GCE，验证DataSource初始化是否正常

额外排查点 #

• 在GCE实例上执行gcloud secrets versions access latest --secret=db-info，确认服务账号能正常获取secret内容
• 查看应用启动日志，确认是否有Secret Manager相关的加载日志，验证secret是否被成功拉取
• 若问题仍存在，可开启调试日志：添加logging.level.org.springframework.cloud.gcp.secretmanager=DEBUG到application.properties，查看secret加载细节

内容的提问来源于stack exchange，提问作者Chang Hyeon Kim