Flutter集成twilio_voice调用Firebase云函数出现NOT_FOUND报错如何解决

• 错误firebase_functions/not-found的核心原因是客户端调用的云函数无法被Firebase识别，首先确认你是否已经正确部署了名为voice-accessToken的Firebase可调用云函数：检查Firebase项目functions目录下的入口文件（index.js/ts），是否导出了名称完全匹配的可调用函数，大小写不能有偏差，示例正确导出格式参考：

exports.voice-accessToken = functions.https.onCall((data, context) => {
  // 生成Twilio访问令牌的业务逻辑
});

如果没有编写对应函数、函数名拼写错误，或者编写后没有执行firebase deploy --only functions部署到云端，都会触发该错误。

• 检查云函数部署区域与客户端调用区域是否一致：如果你部署云函数时指定了非默认区域（比如us-central1、asia-southeast1等），客户端调用时必须同步指定相同区域，否则会找不到函数，修改客户端调用代码即可：

// 替换为你实际部署云函数的区域
final function = FirebaseFunctions.instanceFor(region: 'us-central1').httpsCallable("voice-accessToken");

你可以登录Firebase控制台进入「函数」菜单，查看已部署函数的端点URL，核对其中的区域、函数名是否和客户端调用参数一致。

• 确认客户端绑定的Firebase项目和部署函数的项目匹配：检查Flutter项目中google-services.json（Android）、GoogleService-Info.plist（iOS）对应的项目ID，和你部署云函数时使用的Firebase项目ID是否一致，避免连错环境。
• 补充代码潜在问题修复：你当前代码中iOS侧未获取VoIP推送令牌就直接调用setTokens，后续iOS端会无法接收来电推送，需要补充iOS端的VoIP token获取逻辑后再传入deviceToken参数。

内容的提问来源于stack exchange，提问作者Doing Things Occasionally