Spring Cloud GCP PubSubTemplate注入失败：求Bean找不到问题解决方案

1. 确保Spring Cloud GCP PubSub自动配置生效 #

Spring Cloud GCP默认会自动创建PubSubTemplate Bean，但需满足核心条件：

• 配置文件中指定GCP项目ID（若用本地模拟器，需额外配置模拟器地址）
• 依赖版本兼容（Spring Boot与Spring Cloud GCP版本匹配）

配置文件示例（application.yml） #

spring:
  cloud:
    gcp:
      pubsub:
        project-id: 你的GCP项目ID
        # 本地调试时启用模拟器配置
        emulator-host: localhost:8085

若自动配置未触发，可手动声明PubSubTemplate Bean：

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

2. 修复配置类注解缺失 #

你的outboundConfiguration类未添加@Configuration注解，Spring无法识别并加载其中的Bean定义，修改后：

@Configuration
public class outboundConfiguration {
    // 原有代码保持不变
}

3. 确保配置类被Spring扫描 #

检查配置类所在包是否在Spring Boot主类的扫描范围内。若主类包为org.example.mediumpubsub，则子包org.example.mediumpubsub.config、org.example.mediumpubsub.outbound会被自动扫描；若不在扫描范围内，需在主类添加：

@ComponentScan(basePackages = "你的配置类所在包路径")

4. 修复控制器依赖注入问题 #

outboundController中的messagingGateway未正确注入，@RequiredArgsConstructor要求依赖为final类型，修改后：

@RestController
@RequestMapping("/send")
@RequiredArgsConstructor
@Slf4j
public class outboundController {
    private final outboundConfiguration.PubsubOutboundGateway messagingGateway;

    @PostMapping("/pubsub")
    public void sendMessage(@RequestParam("message") String message) {
        log.info(message);
        messagingGateway.sendToPubsub(message);
    }
}

5. 验证依赖版本兼容性 #

确保Spring Boot与Spring Cloud GCP版本匹配，例如：

• Spring Boot 3.x → Spring Cloud GCP 4.x
• Spring Boot 2.x → Spring Cloud GCP 3.x

Maven依赖管理示例：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-gcp-dependencies</artifactId>
            <version>4.1.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-gcp-starter-pubsub</artifactId>
    </dependency>
</dependencies>

验证步骤 #

1. 确认GCP项目ID配置正确，或本地PubSub模拟器已启动
2. 启动应用，查看日志中是否有PubSubTemplate初始化相关记录
3. 测试消息收发接口，确认功能正常

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