Flutter Web迁移健全空安全后Firebase Cloud Functions无法运行如何解决

1. 首要问题：Firebase Web SDK版本不兼容 #

你的web/index.html里引入的各Firebase JS SDK版本存在跨大版本混用问题：

• firebase-app.js、firebase-functions.js使用版本为8.6.1
• firebase-auth.js、firebase-firestore.js使用版本为7.19.1
  版本不匹配会导致内部调用链路异常，是触发internal错误的核心原因之一。
  修复方式：将所有JS SDK的版本统一为8.6.1，修改后引入部分如下：

<script src="https://www.gstatic.com/firebasejs/8.6.1/firebase-app.js"></script>
<script src="https://www.gstatic.com/firebasejs/8.6.1/firebase-functions.js"></script>
<script src="https://www.gstatic.com/firebasejs/8.6.1/firebase-auth.js"></script>
<script src="https://www.gstatic.com/firebasejs/8.6.1/firebase-firestore.js"></script>

2. 云函数逻辑漏洞与错误处理缺失 #

逻辑漏洞 #

当前云函数中如果role参数不匹配预设的admin/editor值，会直接走default分支return，后续的then分支中userId还是初始的null，调用admin.firestore().collection("users").doc(userId).update会触发空指针错误。
修复方式：在default分支抛出参数错误，终止后续逻辑执行：

switch (data.role) {
    case 'admin':
        currentCustomClaims.admin = (data.permission == 'grant') ? true : false;
    break;
    case 'editor':
        currentCustomClaims.editor = (data.permission == 'grant') ? true : false;
    break;
    default:
        throw new functions.https.HttpsError('invalid-argument', '无效的角色参数');
}

错误处理缺失 #

当前云函数的catch分支仅在服务端打印日志，没有把错误信息返回给客户端，所以客户端只能拿到无意义的internal错误，无法定位具体问题。
修复方式：修改catch逻辑，把错误抛出给客户端：

.catch(err => {
    console.log(err.toString());
    // 抛出错误让客户端接收具体信息
    throw new functions.https.HttpsError('internal', err.message, err.toString());
});

修改后如果还有报错，客户端就能拿到具体的错误原因，比如用户不存在、参数为空等问题。

3. 可选检查项 #

• 确认空安全重构后，Dart调用时传递的email、role、permission三个参数都不为空，空参数会导致云函数逻辑异常
• 如果你同时在移动端测试，cloud_functions 1.x版本需要移动端单独配置模拟器，在初始化阶段添加以下代码：

FirebaseFunctions.instance.useFunctionsEmulator(origin: 'http://10.0.2.2:5001');

• 确认云函数侧users集合的文档权限，默认admin SDK会跳过权限校验，如果你手动修改过admin权限规则，需要确保有写入权限

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