Flutter调用Firebase Functions遇App Check未部署错误的解决咨询

核心解决方法 #

你遇到的错误是因为Firebase Functions客户端SDK默认尝试获取App Check令牌，但你未配置对应的App Check Provider。可通过以下两种方式解决：

1. Flutter客户端显式跳过App Check校验 #

在初始化Firebase后，直接禁用Functions的App Check校验逻辑：

// 初始化Firebase后添加
FirebaseFunctions.instance.appCheckProvider = null;

// 之后正常调用函数
result = await FirebaseFunctions.instance.httpsCallable(triggerName).call<void>();

或者在创建Callable时通过选项跳过：

final callable = FirebaseFunctions.instance.httpsCallable(
  triggerName,
  options: const HttpsCallableOptions(appCheckToken: ''),
);
result = await callable.call<void>();

2. Firebase控制台关闭函数的App Check强制校验 #

如果你的Cloud Functions后台开启了App Check强制执行，也会触发该错误：

• 打开Firebase控制台，进入目标项目
• 切换到「Cloud Functions」页面，选择出错的函数
• 进入「触发器」标签，找到「App Check」设置项
• 关闭「强制执行App Check」开关

关于调试断点停滞的问题 #

调试时断点停滞但单步正常，一般是异步任务的调度延迟导致：

• 确认调用代码在async函数内，且正确使用await等待结果
• 如果使用本地模拟器，检查模拟器是否正常启动，本地网络无异常
• 可以尝试使用Flutter DevTools的异步跟踪功能，查看函数调用的执行栈状态

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