GCP Pub/Sub集成Spring时缺失PubSubPublisherTemplate Bean求助

针对你遇到的No qualifying bean of type 'com.google.cloud.spring.pubsub.core.publisher.PubSubPublisherTemplate' available错误，结合你的版本（Spring Cloud 2023.0.0 + Spring Cloud GCP 5.1.0），给出以下可行排查和解决步骤：

1. 校验自定义PubSubTemplate bean的正确性 #

如果你手动添加了@Primary的PubSubTemplate bean，确保它的构造参数正确依赖了PubSubPublisherTemplate和PubSubSubscriberTemplate：

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

如果你的自定义bean没有正确注入这两个底层template，会直接触发找不到bean的错误。如果不需要自定义逻辑，建议先移除自定义的PubSubTemplate bean，让自动配置生成默认实例，先验证基础功能是否正常。

2. 确认自动配置未被禁用 #

检查你的启动类或配置文件，确保没有禁用PubSub相关的自动配置：

• 启动类上是否有@SpringBootApplication(exclude = {GcpPubSubAutoConfiguration.class})这类排除配置？
• 配置文件中是否设置了spring.autoconfigure.exclude=com.google.cloud.spring.autoconfigure.pubsub.GcpPubSubAutoConfiguration？
  如果有，移除这些排除项，让自动配置正常加载PubSubPublisherTemplate和PubSubSubscriberTemplate。

3. 验证依赖完整性与版本兼容性 #

• 确认pom.xml中spring-cloud-gcp-starter-pubsub的依赖是否正确，没有被其他依赖排除相关组件：

<dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>spring-cloud-gcp-starter-pubsub</artifactId>
    <version>5.1.0</version>
</dependency>

• 检查Spring Boot版本是否匹配：Spring Cloud 2023.0.0（Leyton）要求Spring Boot 3.2.x，如果你的项目使用其他版本（比如3.1.x），会导致自动配置逻辑异常，需调整Spring Boot版本到对应范围。

4. 排查发布端的GCP配置 #

虽然订阅功能正常，但发布端的配置可能存在缺失：

• 确认配置文件中是否设置了spring.cloud.gcp.project-id（或通过环境变量GOOGLE_CLOUD_PROJECT、默认GCP凭证配置了项目ID）。自动配置需要正确的项目ID才能初始化PubSubPublisherTemplate。
• 如果使用了模拟器，确认是否配置了spring.cloud.gcp.pubsub.emulator-host，且模拟器正常运行。

5. 检查组件扫描范围 #

如果你的启动类自定义了@ComponentScan的路径，确保com.google.cloud.spring.autoconfigure.pubsub包被包含在扫描范围内，否则自动配置类无法被加载，也就无法生成PubSubPublisherTemplate bean。

最后建议先恢复到最小配置：移除自定义的PubSubTemplate bean，确保依赖和版本正确，配置好GCP项目ID，重启应用测试注入是否正常，再逐步添加自定义逻辑。

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