Spring 2升级至3后GCP Pub/Sub凭证缺失致应用启动失败

问题总结 #

将应用从Spring Boot 2升级到Spring Boot 3后，使用GCP Pub/Sub时出现凭证加载错误，提示默认凭证未找到。已配置spring.cloud.gcp.credentials.location=classpath:test.json，且主方法能读取到该文件，但仍报错。使用依赖版本为spring-cloud-gcp-starter-pubsub:3.5.4。

排查与解决步骤 #

1. 修复重复的配置项 #

你的配置文件中重复定义了spring.cloud.gcp.project-id，重复配置会导致属性值被覆盖，可能引发配置加载逻辑异常，保留唯一的project-id配置：

spring.cloud.gcp.project-id=local-project
spring.cloud.gcp.pubsub.emulator-host=localhost:8681
spring.cloud.gcp.credentials.location=classpath:test.json

2. 确认是否手动创建Pub/Sub客户端 #

如果你的AbstractEntityPublisher是手动实例化Publisher（而非使用Spring提供的PubSubTemplate），Spring Cloud GCP的自动配置不会生效，需要手动加载凭证：

// 替换手动创建Publisher的代码，加入凭证加载逻辑
GoogleCredentials credentials = GoogleCredentials.fromStream(
    new ClassPathResource("test.json").getInputStream()
);
Publisher publisher = Publisher.newBuilder(TopicName.of(projectId, topicId))
    .setCredentialsProvider(FixedCredentialsProvider.create(credentials))
    .build();

如果使用PubSubTemplate，确保它由Spring容器管理（通过@Autowired注入），而非手动创建。

3. 验证运行时类路径中的凭证文件 #

主方法能读取到文件不代表镜像运行时该文件存在：

• 检查构建镜像的打包脚本，确认test.json被正确打包到classpath下（比如Maven/Gradle的resources目录是否配置正确）。
• 在镜像中执行jar tf your-app.jar，查看test.json是否在BOOT-INF/classes/目录下。

4. 检查Spring Cloud GCP自动配置是否生效 #

确保Spring Boot应用启用了GCP自动配置：

• 启动类上可显式添加@EnableGcpPubSub，避免自动配置失效。
• 检查是否存在禁用自动配置的注解（比如@SpringBootApplication(exclude = ...)），排除了GCP相关的自动配置类。

5. 排查配置优先级问题 #

Spring Cloud GCP会优先读取环境变量或系统属性中的凭证配置，检查是否存在GOOGLE_APPLICATION_CREDENTIALS环境变量，它会覆盖配置文件中spring.cloud.gcp.credentials.location的设置。

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