Spring Boot 3集成GCP Pub/Sub时PubSubTemplate Bean缺失问题

核心问题是依赖版本不匹配：你使用的spring-cloud-gcp-starter-pubsub:1.2.8.RELEASE是适配Spring Boot 2.x的老旧版本，但项目基于Spring Boot 3.2，搭配的是Spring Cloud GCP 5.1.2 BOM，版本完全不兼容，导致自动配置类无法正常加载，Spring因此无法创建PubSubTemplate Bean。

具体修复步骤：

• 修正依赖版本：移除spring-cloud-gcp-starter-pubsub的硬编码版本号，让它自动继承BOM中的spring-cloud-gcp-version:5.1.2版本。Gradle依赖写法如下：

  implementation 'org.springframework.cloud:spring-cloud-gcp-starter-pubsub'
  

• 检查自动配置排除项：确保主启动类的@SpringBootApplication注解没有排除GcpPubSubAutoConfiguration类，否则自动配置会失效。
• 验证配置完整性：确认application.yaml中的核心配置正确无误：

  spring:
    cloud:
      gcp:
        project-id: your-project-id
        credentials:
          location: file:/path/to/your/service-account-key.json
        pubsub:
          enabled: true
  

• 确认组件扫描范围：如果com.Extractor类不在主启动类的同级或子包下，需在主启动类添加@ComponentScan(basePackages = "com")，确保Spring能扫描到需要注入PubSubTemplate的类。

补充说明：Spring Cloud GCP 5.x系列专为Spring Boot 3.x设计，1.x系列仅支持Spring Boot 2.x，版本不匹配会导致大量自动配置逻辑失效，这是此类问题的最常见诱因。

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