Spring Boot 3.x迁移GCP PubSub：缺失PubSubTemplate Bean问题求助

问题原因 #

Spring Cloud GCP 4.x（适配Spring Boot 3.x）中，PubSubTemplate的自动注入依赖特定starter包与自动配置触发条件，你当前的依赖配置缺少触发自动配置的必要组件，导致Spring无法自动创建该Bean。

解决方案 #

1. 替换为Spring Cloud GCP PubSub Starter依赖 #

将现有spring-cloud-gcp-pubsub和spring-cloud-gcp-core依赖替换为starter包，它会自动包含所有核心组件与自动配置类：

<dependencies>
    <!-- 替换原pubsub、core依赖 -->
    <dependency>
        <groupId>com.google.cloud</groupId>
        <artifactId>spring-cloud-gcp-starter-pubsub</artifactId>
    </dependency>
    <!-- 保留GCS操作依赖 -->
    <dependency>
        <groupId>com.google.cloud</groupId>
        <artifactId>google-cloud-storage</artifactId>
    </dependency>
</dependencies>

该starter会引入PubSubAutoConfiguration自动配置类，只要满足配置条件，Spring就会自动生成PubSubTemplate Bean。

2. 配置GCP基础信息 #

确保应用配置文件（如application.properties/application.yml）中包含GCP项目ID，或应用运行环境能提供默认凭据（如GCP云环境、本地已登录gcloud）：

# application.properties
spring.cloud.gcp.project-id=你的GCP项目ID
# 本地运行时可选指定凭据文件路径（默认读取gcloud默认凭据）
# spring.cloud.gcp.credentials.location=file:/本地凭据文件路径/service-account-key.json

无有效项目ID或凭据时，自动配置类会跳过PubSubTemplate的Bean创建。

3. 确认自动配置未被排除 #

检查主配置类（带@SpringBootApplication注解）是否排除了GCP相关自动配置，若有如下代码需移除：

@SpringBootApplication(exclude = {PubSubAutoConfiguration.class})

4. 手动创建PubSubTemplate（自动配置失效时） #

若上述方案无效，可手动构建PubSubTemplate Bean，需依赖客户端工厂与模板实现：

import com.google.cloud.spring.pubsub.core.PubSubTemplate;
import com.google.cloud.spring.pubsub.core.PubSubPublisherTemplate;
import com.google.cloud.spring.pubsub.core.PubSubSubscriberTemplate;
import com.google.cloud.spring.pubsub.support.DefaultPublisherFactory;
import com.google.cloud.spring.pubsub.support.DefaultSubscriberFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class PubSubConfig {

    @Bean
    public PubSubTemplate pubSubTemplate(PubSubPublisherTemplate publisherTemplate, PubSubSubscriberTemplate subscriberTemplate) {
        return new PubSubTemplate(publisherTemplate, subscriberTemplate);
    }

    @Bean
    public PubSubPublisherTemplate publisherTemplate(DefaultPublisherFactory publisherFactory) {
        return new PubSubPublisherTemplate(publisherFactory);
    }

    @Bean
    public PubSubSubscriberTemplate subscriberTemplate(DefaultSubscriberFactory subscriberFactory) {
        return new PubSubSubscriberTemplate(subscriberFactory);
    }

    @Bean
    public DefaultPublisherFactory defaultPublisherFactory() {
        return new DefaultPublisherFactory();
    }

    @Bean
    public DefaultSubscriberFactory defaultSubscriberFactory() {
        return new DefaultSubscriberFactory();
    }
}

手动创建时需确保GCP项目ID、凭据配置正确，否则客户端初始化会失败。

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