Spring Boot集成Firestore启动失败：缺失firestoreTemplate Bean求助

问题根源 #

CodeRepository继承的FirestoreReactiveRepository依赖FirestoreTemplate Bean；你当前的配置手动初始化了Firebase Admin SDK，但未将Firestore实例注册为Spring Bean，也未让Spring Cloud GCP自动生成FirestoreTemplate，导致容器无法找到所需依赖。

解决方案 #

方案1：利用Spring Cloud GCP自动配置（推荐） #

1. 确认依赖
   确保项目依赖中包含Spring Cloud GCP的Reactive Firestore Starter：

   <!-- Maven 依赖 -->
   <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>spring-cloud-gcp-starter-data-firestore-reactive</artifactId>
   </dependency>
   

2. 简化配置类
   删除手动初始化FirebaseApp的代码，Spring会通过GOOGLE_APPLICATION_CREDENTIALS环境变量自动加载凭证并初始化Firestore：

   package spring.framework._2fa_application.config;
   
   import org.springframework.cloud.gcp.data.firestore.repository.config.EnableReactiveFirestoreRepositories;
   import org.springframework.context.annotation.Configuration;
   
   @Configuration
   @EnableReactiveFirestoreRepositories(basePackages = "spring.framework._2fa_application.totp.codeOTP")
   public class FirebaseConfig {
       // 无需手动初始化逻辑，Spring Cloud GCP自动处理
   }
   

方案2：手动注册Firestore与FirestoreTemplate Bean #

若必须手动初始化FirebaseApp，需将Firestore实例注册为Spring Bean，并手动创建FirestoreTemplate：

package spring.framework._2fa_application.config;

import com.google.auth.oauth2.GoogleCredentials;
import com.google.cloud.firestore.Firestore;
import com.google.firebase.FirebaseApp;
import com.google.firebase.FirebaseOptions;
import com.google.firebase.cloud.FirestoreClient;
import org.springframework.cloud.gcp.data.firestore.FirestoreTemplate;
import org.springframework.cloud.gcp.data.firestore.repository.config.EnableReactiveFirestoreRepositories;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.io.FileInputStream;
import java.io.IOException;

@Configuration
@EnableReactiveFirestoreRepositories(basePackages = "spring.framework._2fa_application.totp.codeOTP")
public class FirebaseConfig {

    @Bean
    public FirebaseApp firebaseApp() throws IOException {
        FileInputStream serviceAccount = new FileInputStream("./ConnectionString.json");
        FirebaseOptions options = new FirebaseOptions.Builder()
                .setCredentials(GoogleCredentials.fromStream(serviceAccount))
                .build();
        // 避免重复初始化已存在的FirebaseApp实例
        return FirebaseApp.getApps().isEmpty() ? FirebaseApp.initializeApp(options) : FirebaseApp.getInstance();
    }

    @Bean
    public Firestore firestore(FirebaseApp firebaseApp) {
        return FirestoreClient.getFirestore(firebaseApp);
    }

    @Bean
    public FirestoreTemplate firestoreTemplate(Firestore firestore) {
        return new FirestoreTemplate(firestore);
    }
}

关键注意点 #

• FirestoreReactiveRepository底层依赖FirestoreTemplate完成数据库操作，必须保证该Bean存在于Spring容器中。
• 手动初始化FirebaseApp时，要检查实例是否已存在，避免重复初始化引发异常。
• 确保GOOGLE_APPLICATION_CREDENTIALS环境变量配置正确，或手动指定的密钥文件路径无误。

内容的提问来源于stack exchange，提问作者Bianca Daniela Ionascu