Spring Boot中firebase-admin与google-cloud-storage共存启动冲突问题

该故障与两个SDK共用同一份凭证文件无关，由两个问题共同触发：

• 依赖版本冲突：firebase-admin 8.2.0内置的Google Cloud核心依赖、gRPC传输层依赖版本偏旧，与google-cloud-storage 2.8.1携带的新版同组依赖在类路径下混用时，会出现接口实现不匹配问题，报错信息中的getTransportChannel() called when needsExecutor() is true就是gRPC版本错乱的典型异常。
• 自动配置误触发：引入google-cloud-storage后，类路径下存在Firestore相关类，Spring Cloud GCP自动配置组件会尝试自动创建Firestore实例，该默认初始化逻辑与手动初始化FirebaseApp的逻辑不兼容，直接导致Bean创建失败。

按以下步骤操作即可解决问题：

1. 引入Google Cloud官方BOM统一所有Google生态依赖版本，从根源解决传递依赖版本冲突。在pom.xml的dependencyManagement节点添加如下配置：

   <dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>com.google.cloud</groupId>
               <artifactId>google-cloud-bom</artifactId>
               <version>2.8.1</version>
               <type>pom</type>
               <scope>import</scope>
           </dependency>
       </dependencies>
   </dependencyManagement>
   

   添加BOM后，删除原有firebase-admin、google-cloud-storage依赖上的版本号配置，由BOM自动拉取互相兼容的版本：

   <dependency>
       <groupId>com.google.firebase</groupId>
       <artifactId>firebase-admin</artifactId>
   </dependency>
   <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>google-cloud-storage</artifactId>
   </dependency>
   

2. 禁用Spring Cloud GCP多余的自动配置，避免其覆盖手动初始化逻辑。在Spring Boot启动类的@SpringBootApplication注解中排除不需要的自动配置类：

   import org.springframework.boot.SpringApplication;
   import org.springframework.boot.autoconfigure.SpringBootApplication;
   import org.springframework.cloud.gcp.autoconfigure.firestore.GcpFirestoreAutoConfiguration;
   import org.springframework.cloud.gcp.autoconfigure.storage.GcpStorageAutoConfiguration;
   
   @SpringBootApplication(exclude = {
       GcpFirestoreAutoConfiguration.class,
       GcpStorageAutoConfiguration.class
   })
   public class ApiApplication {
       public static void main(String[] args) {
           SpringApplication.run(ApiApplication.class, args);
       }
   }
   

3. （可选优化）无需重复读取密钥文件流，全局初始化一次GoogleCredentials实例即可同时供FirebaseApp和Storage客户端复用，读取流后注意及时关闭避免资源泄漏。

修复后两个SDK可正常共存，不需要拆分服务账号密钥：只要密钥对应的服务账号同时拥有Firebase身份校验、Cloud Storage的操作权限，同一份密钥可同时供两个SDK使用，不存在凭证冲突问题。

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