Spring Boot集成GCP Pub/Sub启动报UnsatisfiedDependencyException如何解决

org.springframework.beans.factory.UnsatisfiedDependencyException 异常的根因为 spring-cloud-gcp-starter-pubsub 自动装配流程中，未读取到合法的GCP项目ID，导致PubSubTemplate及关联的messageSender Bean初始化失败。

以下方案任选其一即可：

• 配置文件注入（最常用）
  若使用application.properties配置文件，添加如下配置：

  spring.cloud.gcp.project-id=你的GCP项目ID
  # 可选配置：指定GCP服务账号密钥文件路径
  spring.cloud.gcp.credentials.location=classpath:gcp-service-account.json
  

  若使用application.yml配置文件，添加如下配置：

  spring:
    cloud:
      gcp:
        project-id: 你的GCP项目ID
        # 可选配置：指定GCP服务账号密钥文件路径
        credentials:
          location: classpath:gcp-service-account.json
  

• 环境变量注入（适配容器/本地开发场景）
  配置系统环境变量SPRING_CLOUD_GCP_PROJECT_ID，值为你的GCP项目ID，Spring Boot会自动读取该环境变量完成配置。
• 启动参数注入
  启动应用时在命令行添加参数指定项目ID：
  java -jar your-app.jar --spring.cloud.gcp.project-id=你的GCP项目ID
• 手动注册配置Bean（自定义场景适用）
  若需要自定义项目ID的读取逻辑，可手动声明GcpProjectIdProvider Bean绕过自动装配校验：

  import com.google.cloud.spring.core.GcpProjectIdProvider;
  import org.springframework.context.annotation.Bean;
  import org.springframework.context.annotation.Configuration;
  
  @Configuration
  public class GcpPubSubCustomConfig {
      @Bean
      public GcpProjectIdProvider gcpProjectIdProvider() {
          // 此处可自定义项目ID获取逻辑，比如从第三方配置中心读取
          return () -> "你的GCP项目ID";
      }
  }
  

注意：GCP项目ID为Google Cloud控制台中项目的唯一标识，不是自定义的项目名称，可登录GCP控制台在「项目信息」卡片中查询获取。

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