Android开发：切换Firestore数据库未生效问题及多库配置咨询

一、可能的操作失误点 #

1. 缓存未清理 #

Android Studio和Gradle会缓存构建资源，替换google-services.json后可能未生效：

• 执行File -> Invalidate Caches...，勾选"Clear file system cache and local history"后重启IDE
• 清理构建目录：在终端运行./gradlew clean，再重新构建项目

2. 构建变体/Flavor配置错误 #

如果你的项目使用了productFlavors（比如debug/release、dev/prod），需要将对应环境的google-services.json放到对应flavor的目录下：

• 开发环境：app/src/debug/google-services.json
• 生产环境：app/src/release/google-services.json
  如果直接替换根目录的google-services.json，可能被flavor目录下的文件覆盖。

3. 代码中硬编码了数据库实例 #

检查代码中是否直接指定了旧数据库的URL或实例：

// 错误示例：硬编码旧数据库URL
val settings = FirebaseFirestoreSettings.Builder()
    .setDatabaseUrl("https://old-project.firebaseio.com")
    .build()
val db = FirebaseFirestore.getInstance().apply { firestoreSettings = settings }

如果有这类代码，即使替换google-services.json，应用仍会连接硬编码的数据库。

4. SHA-1指纹与构建类型不匹配 #

你提到提取的是签名APK的SHA-1，但如果当前运行的是debug构建（Android Studio直接运行），使用的是debug keystore的SHA-1，而非签名APK的release SHA-1。需要：

• 确认开发数据库中添加的是debug keystore的SHA-1（可通过./gradlew signingReport获取）
• 检查google-services.json中oauth_client[0].android_info.certificate_hash是否与当前构建的SHA-1一致（注意hash是SHA-1的小写无冒号形式）

二、单应用配置多Firestore数据库的实现 #

google-services.json本身仅支持配置一个默认Firebase项目，但可以通过代码初始化多个数据库实例，连接不同环境的Firestore：

1. 方案一：通过代码指定不同数据库 #

无需修改google-services.json，直接在代码中初始化不同实例：

// 连接默认项目（google-services.json配置的）
val defaultDb = FirebaseFirestore.getInstance()

// 连接开发数据库
val devDbSettings = FirebaseFirestoreSettings.Builder()
    .setDatabaseUrl("https://dev-project.firebaseio.com")
    .build()
val devDb = FirebaseFirestore.getInstance(FirebaseApp.initializeApp(
    FirebaseOptions.Builder()
        .setProjectId("dev-project-id")
        .setApplicationId("dev-app-id")
        .setApiKey("dev-api-key")
        .build(), "dev"
)).apply { firestoreSettings = devDbSettings }

// 连接生产数据库
val prodDbSettings = FirebaseFirestoreSettings.Builder()
    .setDatabaseUrl("https://prod-project.firebaseio.com")
    .build()
val prodDb = FirebaseFirestore.getInstance(FirebaseApp.initializeApp(
    FirebaseOptions.Builder()
        .setProjectId("prod-project-id")
        .setApplicationId("prod-app-id")
        .setApiKey("prod-api-key")
        .build(), "prod"
)).apply { firestoreSettings = prodDbSettings }

2. 方案二：使用Product Flavors区分环境 #

为dev和prod flavor分别配置google-services.json，自动加载对应环境的配置：

• 在app/build.gradle中定义flavors：

android {
    flavorDimensions "environment"
    productFlavors {
        dev {
            dimension "environment"
            applicationIdSuffix ".dev"
        }
        prod {
            dimension "environment"
        }
    }
}

• 将dev环境的google-services.json放到app/src/dev/，prod的放到app/src/prod/，构建时Gradle会自动加载对应flavor的配置。

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