Firebase Functions AppCheck 安卓端调用持续校验失败排查问询

你遇到的onCall云函数context.app为空的核心问题是AppCheck令牌没有被自动附加到请求头，常见触发原因如下：

• 应用初始化顺序错误：你当前的代码中super.onCreate()调用时机晚于Firebase组件初始化，会导致上下文异常，AppCheck初始化未被正确注册
• Firebase依赖版本不匹配：旧版本的Firebase Functions SDK默认不会自动附加AppCheck头，仅20.0.0及以上版本的Functions SDK支持自动集成AppCheck
• AppCheck令牌获取失败：初始化配置错误导致令牌无法正常生成，自然不会被附加到请求

1. 修正Application初始化顺序，将父类onCreate调用放到最前面：

class Application : MultiDexApplication() {
    override fun onCreate() {
        // 先调用父类初始化
        super.onCreate()
        FirebaseApp.initializeApp(this)
        val appCheck = FirebaseAppCheck.getInstance()
        if (BuildConfig.DEBUG) {
            appCheck.installAppCheckProviderFactory(
                DebugAppCheckProviderFactory.getInstance(), 
                true
            )
        } else {
            appCheck.installAppCheckProviderFactory(
                SafetyNetAppCheckProviderFactory.getInstance(), 
                true
            )
        }
    }
}

2. 升级Firebase依赖到兼容版本，推荐使用BOM统一管理版本避免冲突：

// 模块级build.gradle依赖配置
dependencies {
    implementation platform('com.google.firebase:firebase-bom:32.7.0')
    implementation 'com.google.firebase:firebase-functions-ktx'
    implementation 'com.google.firebase:firebase-appcheck-debug'
    implementation 'com.google.firebase:firebase-appcheck-safetynet'
}

3. 先主动验证AppCheck令牌是否能正常获取，排除令牌生成失败问题：

// 在调用云函数前添加这段逻辑
FirebaseAppCheck.getInstance().getAppCheckToken(false)
    .addOnSuccessListener { token ->
        Log.d("AppCheck", "令牌获取成功: ${token.token}")
        // 确认令牌获取成功后再调用云函数
        Firebase.functions.getHttpsCallable("test").call(data).addOnCompleteListener {
            // 原有业务逻辑
        }
    }
    .addOnFailureListener { e ->
        Log.e("AppCheck", "令牌获取失败", e)
    }

如果令牌获取失败，优先检查Firebase控制台的AppCheck配置：确认包名、签名SHA值、Debug令牌是否和当前应用匹配。
4. 如自动附加逻辑始终不生效，可手动给onCall请求添加AppCheck头：

val callable = Firebase.functions.getHttpsCallable("test")
callable.setHttpsCallOptions { options ->
    options.addHeader("X-Firebase-AppCheck", 你获取到的AppCheck令牌)
}
callable.call(data)

• 使用抓包工具（如Charles）抓取云函数请求，确认请求头中是否携带X-Firebase-AppCheck字段，排除断点无法读取隐藏头的问题
• 开启Firebase AppCheck的调试日志，查看初始化、令牌申请全流程是否有报错
• 核对云函数所在的Firebase项目和安卓端集成的google-services.json对应的项目是否一致

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