Flutter调用Firebase Cloud Functions删用户触发internal错误排查

我有一个带权限分级的Flutter项目，需要让管理员通过Firebase Auth彻底删除用户（之前仅设置“Deactivated”权限限制登录，现在要完全移除用户）。用Firebase Cloud Functions实现了deleteUserByEmail函数，PostMan调用可正常删除测试用户，但Flutter代码调用时触发[firebase_functions/internal] INTERNAL错误。已尝试添加try-catch、配置admin.initializeApp()凭证等方法，均未解决问题。

云函数index.js代码 #

const functions = require("firebase-functions");
const admin = require('firebase-admin');

admin.initializeApp();

exports.deleteUserByEmail = functions.https.onRequest(async (request, response) => {
    try {
        const userEmail = request.body.userEmail;
        admin.auth().getUserByEmail(userEmail)
            .then(userRecord => {
                const uid = userRecord.uid
                return admin.auth().deleteUser(uid)
                    .then(() => {
                        console.log("Successfully deleted user");
                        response.status(200).send('Delete User');
                        return
                    })
            }).catch(error => {
                throw new functions.https.HttpsError('invalid-argument', error.HttpsError);

            });
    } catch (err) {
        throw new functions.https.HttpsError('invalid-argument', "Error passing arguments into");
    }

})

Flutter调用代码 #

HttpsCallable callable =
          FirebaseFunctions.instance.httpsCallable('deleteUserByEmail');
      try {
        final resp = await callable.call<String, dynamic>({
          "userEmail" : userModel.email,
        });
      } on FirebaseFunctionsException catch (e) {
        debugPrint(e.toString());
      }

错误日志 #

E/flutter (20323): [ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: [firebase_functions/internal] INTERNAL
E/flutter (20323):
E/flutter (20323): #0      StandardMethodCodec.decodeEnvelope
package:flutter/…/services/message_codecs.dart:653
E/flutter (20323): #1      MethodChannel._invokeMethod
package:flutter/…/services/platform_channel.dart:296
E/flutter (20323): <asynchronous suspension>
E/flutter (20323): #2      MethodChannelHttpsCallable.call
package:cloud_functions_platform_interface/…/method_channel/method_channel_https_callable.dart:23
E/flutter (20323): <asynchronous suspension>
E/flutter (20323): #3      HttpsCallable.call
package:cloud_functions/src/https_callable.dart:49
E/flutter (20323): <asynchronous suspension>
E/flutter (20323):
E/flutter (20323): #0      StandardMethodCodec.decodeEnvelope
package:flutter/…/services/message_codecs.dart:653
E/flutter (20323): #1      MethodChannel._invokeMethod
package:flutter/…/services/platform_channel.dart:296
E/flutter (20323): <asynchronous suspension>
E/flutter (20323): #2      MethodChannelHttpsCallable.call
package:cloud_functions_platform_interface/…/method_channel/method_channel_https_callable.dart:23

问题原因及修复方案 #

核心问题：云函数类型不匹配 #

你写的是HTTP触发函数（functions.https.onRequest），但Flutter中用的是Callable函数（HttpsCallable）调用，两种函数的协议、参数传递逻辑完全不同，导致请求解析失败。

修复步骤： #

1. 修改云函数为Callable类型
   将onRequest替换为onCall，调整参数获取与返回逻辑，Callable函数通过data接收参数，用return返回结果，同时添加管理员权限校验避免恶意调用：

   const functions = require("firebase-functions");
   const admin = require('firebase-admin');
   
   admin.initializeApp();
   
   exports.deleteUserByEmail = functions.https.onCall(async (data, context) => {
       try {
           // 校验调用者是否为管理员
           if (!context.auth || !context.auth.token.admin) {
               throw new functions.https.HttpsError('permission-denied', '仅管理员可执行此操作');
           }
   
           const userEmail = data.userEmail;
           const userRecord = await admin.auth().getUserByEmail(userEmail);
           await admin.auth().deleteUser(userRecord.uid);
           console.log("Successfully deleted user");
           return {message: '用户删除成功'};
       } catch (error) {
           if (error.code === 'auth/user-not-found') {
               throw new functions.https.HttpsError('not-found', '用户不存在');
           }
           throw new functions.https.HttpsError('internal', '删除失败', error.message);
       }
   });
   

2. 优化Flutter调用的错误处理
   原有Flutter调用逻辑无需修改，可增强错误信息打印便于调试：

   HttpsCallable callable = FirebaseFunctions.instance.httpsCallable('deleteUserByEmail');
   try {
       final resp = await callable.call({
           "userEmail": userModel.email,
       });
       debugPrint(resp.data.toString());
     } on FirebaseFunctionsException catch (e) {
       debugPrint('错误代码：${e.code}，错误信息：${e.message}');
     } catch (e) {
       debugPrint('未知错误：$e');
     }
   

3. 重新部署云函数
   执行firebase deploy --only functions部署修改后的函数，确保生效。

为什么PostMan能正常调用？ #

PostMan是直接发送标准HTTP请求给onRequest函数的接口，符合该函数的调用规范；而Flutter的HttpsCallable会发送符合Callable协议的特殊格式请求，onRequest函数无法解析，因此触发内部错误。

内容的提问来源于stack exchange，提问作者Marcos Vinícius