Spring Cloud通过application.yml配置GCP凭据时Credentials为Null问题

可能的原因及对应解决方案 #

1. 核对依赖与版本兼容性 #

确保项目引入了正确的Spring Cloud GCP Starter依赖，且版本与Spring Boot匹配：

• Maven项目（pom.xml）：

<dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>spring-cloud-gcp-starter-storage</artifactId>
    <!-- 请使用与Spring Boot版本适配的对应版本 -->
</dependency>

• Gradle项目（build.gradle）：

implementation 'com.google.cloud:spring-cloud-gcp-starter-storage'

版本不匹配会导致配置逻辑无法正常生效，务必保证版本对应。

2. 补全配置项内容 #

检查application.yml配置是否完整，除了凭据路径，需明确指定GCP项目ID（若未通过环境变量GOOGLE_CLOUD_PROJECT设置）：

spring:
  cloud:
    gcp:
      credentials:
        location: classpath:key.json
      project-id: 你的GCP项目ID

3. 排查配置覆盖问题 #

Spring Cloud GCP凭据加载有优先级：环境变量GOOGLE_APPLICATION_CREDENTIALS的优先级高于配置文件中的spring.cloud.gcp.credentials.location。如果启动应用时该环境变量仍存在，会直接覆盖配置文件的设置，导致你看到credentials为null的情况。启动前务必清除这个环境变量。

4. 验证资源文件打包状态 #

确认key.json确实放在src/main/resources目录下，且打包后的jar/war文件中存在该文件。可以通过解压包或查看IDE的target/classes目录验证；若文件缺失，检查build配置（比如Maven的resources插件）是否将其排除。

5. 手动构建Storage客户端（备选方案） #

若自动配置仍未生效，可手动创建Storage对象指定凭据，绕过自动配置的问题：

import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.io.ClassPathResource;

import java.io.IOException;
import java.io.InputStream;

@Configuration
public class GcpStorageConfig {

    @Bean
    public Storage storage() throws IOException {
        try (InputStream credentialsStream = new ClassPathResource("key.json").getInputStream()) {
            return StorageOptions.newBuilder()
                    .setCredentials(com.google.auth.oauth2.GoogleCredentials.fromStream(credentialsStream))
                    .setProjectId("你的GCP项目ID")
                    .build()
                    .getService();
        }
    }
}

6. 检查自动配置是否被排除 #

若项目中通过@SpringBootApplication排除了GcpCredentialsAutoConfiguration或GcpStorageAutoConfiguration，会导致自动配置失效，需确保这些类未被排除：

// 避免此类排除配置
@SpringBootApplication(exclude = {GcpCredentialsAutoConfiguration.class})

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