Flutter中Firebase App Check调试令牌与提供商处理问题

官方文档部分内容不够清晰，我已在Flutter中尝试集成Firebase App Check两周，在iOS和Android设备上使用调试令牌时出现诸多异常行为。以下是项目中的配置代码：

main.dart #

void main() async {
  WidgetsBinding widgetsBinding = WidgetsFlutterBinding.ensureInitialized();

  MobileAds.instance.initialize();

  // preserves splash screen
  FlutterNativeSplash.preserve(widgetsBinding: widgetsBinding);

  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);

  await FirebaseAppCheck.instance.activate(
      webRecaptchaSiteKey: 'recaptcha-v3-site-key',
      androidProvider:
      kReleaseMode ? AndroidProvider.playIntegrity : AndroidProvider.debug,
      appleProvider: kReleaseMode ? AppleProvider.deviceCheck : AppleProvider.debug
  );
  runApp(...);
}

Android MainActivity.kt #

package com.baroraproject.app.barora
//
import android.os.Bundle
import com.google.firebase.FirebaseApp
import com.google.firebase.appcheck.FirebaseAppCheck
import com.google.firebase.appcheck.debug.DebugAppCheckProviderFactory

import io.flutter.embedding.android.FlutterActivity

class MainActivity: FlutterActivity(){
    override fun onCreate(savedInstanceState: Bundle?) {

        if (BuildConfig.DEBUG) {
            FirebaseApp.initializeApp(/*context=*/this)
            val firebaseAppCheck = FirebaseAppCheck.getInstance()
            firebaseAppCheck.installAppCheckProviderFactory(
                    DebugAppCheckProviderFactory.getInstance()
            )
        }
        super.onCreate(savedInstanceState)
    }
}

iOS Runner/AppDelegate.swift #

import UIKit
import Flutter
import awesome_notifications
import shared_preferences_foundation
import FirebaseCore
import FirebaseAppCheck


@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
      
      // This function registers the desired plugins to be used within a notification background action
      SwiftAwesomeNotificationsPlugin.setPluginRegistrantCallback { registry in
          SwiftAwesomeNotificationsPlugin.register(
            with: registry.registrar(forPlugin: "io.flutter.plugins.awesomenotifications.AwesomeNotificationsPlugin")!) 
          SharedPreferencesPlugin.register(
            with: registry.registrar(forPlugin: "io.flutter.plugins.sharedpreferences.SharedPreferencesPlugin")!) 
      }
      
      // Use the debug provider in Debug builds:
  #if DEBUG
      let providerFactory = AppCheckDebugProviderFactory()
      AppCheck.setAppCheckProviderFactory(providerFactory)
  #endif
      
      FirebaseApp.configure()
      GeneratedPluginRegistrant.register(with: self)
      
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
}

1. 获取调试令牌并在Firebase中存储后，是否需要移除调试提供商代码？ #

不需要移除。只要你用环境判断（比如kReleaseMode、BuildConfig.DEBUG）区分了调试和正式提供商，Release构建会自动切换到正式服务（Play Integrity/DeviceCheck），调试代码不会影响发布包的功能。留着代码还能方便后续调试时快速启用调试模式，无需重新编写。

2. Firebase App Check调试令牌何时会刷新或变更？如何避免该情况发生？ #

调试令牌通常在以下场景会变更：

• 卸载重装App；
• 清除App的存储数据；
• 重置设备的广告标识符（IDFA/AAID）；
• 更换App的Debug签名密钥。

要避免令牌变更，尽量不要触发上述操作。同一台设备、同一个Debug签名下的同一个App，调试令牌是固定的，只要维持当前环境不变，令牌就不会失效。如果不小心变更，重新获取新令牌添加到Firebase控制台即可。

3. 如何确保调试提供商代码不会进入Release构建？目前调试语句失效，发布时需手动注释相关代码、清理并重新构建，过程繁琐。 #

你当前的代码已经做了环境区分，但可能是构建配置出了问题，优化方案如下：

• Flutter端：kReleaseMode的判断是有效的，Release构建时会自动使用正式提供商，调试逻辑不会执行；
• Android端：BuildConfig.DEBUG是系统自动生成的变量，Release构建时会自动设为false，包裹的代码会被编译器剔除，无需手动注释；
• iOS端：#if DEBUG是Xcode的条件编译宏，Release模式下这部分代码会被直接忽略。

如果调试语句仍出现在Release包中，检查以下几点：

• Android：确认打包时选择的是Release构建变体，不要用Debug变体发布；
• iOS：在Xcode中确认当前构建配置为Release，确保DEBUG宏仅在Debug模式下定义；
• Flutter：打包时使用flutter build apk --release或flutter build ios --release命令，避免用Debug命令构建。

按上述配置后，发布时无需手动修改代码，直接构建Release包即可，调试代码不会被包含进去。

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