使用Firebase Cloud Functions可调用函数查询手机号遇内部错误

嘿，我明白你碰到的麻烦了——当查询认证系统里不存在的手机号时，云函数直接抛出了内部错误，而不是返回一个前端能友好处理的结果。这其实是因为admin.auth().getUserByPhoneNumber()在找不到用户时会抛出异常，而你的代码没有捕获这个异常，导致Firebase把它当作未处理的服务器错误返回了。

问题根源 #

getUserByPhoneNumber方法如果找不到匹配的用户，会抛出一个带有auth/user-not-found错误码的异常。但如果你的云函数没有捕获并处理这个异常，Firebase就会默认返回一个内部服务器错误（HTTP 500），前端只能看到一堆模糊的栈追踪信息，没法区分具体错误类型。

修改方案 #

我们需要在云函数里添加try/catch块来捕获异常，然后用Firebase的HttpsError返回结构化的错误信息，这样前端就能轻松处理不同的错误场景了。

1. 修正云函数代码（functions/index.js）

const functions = require('firebase-functions');
const admin = require('firebase-admin');
admin.initializeApp(functions.config().firebase);

exports.checkPhoneNumber = functions.https.onCall(async (data, context) => {
  try {
    // 尝试获取用户信息
    const user = await admin.auth().getUserByPhoneNumber(data.phoneNumber);
    // 返回明确的存在标识和用户数据
    return { exists: true, user };
  } 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. 优化前端错误处理（front-end.js）

现在前端可以根据错误码来做针对性的提示，而不是只打印一堆栈信息：

toPress = () => {
  const getNumberInText = '+12321123232';
  const checkPhone = Firebase.functions.httpsCallable('checkPhoneNumber');
  
  checkPhone({ phoneNumber: getNumberInText })
    .then((result) => {
      console.log('手机号已注册:', result.data.user);
      // 这里可以跳转到下一步或者显示成功提示
    })
    .catch((error) => {
      switch (error.code) {
        case 'not-found':
          console.log(error.message); // 输出"该手机号尚未注册"
          // 给用户显示友好提示，比如弹窗或Toast
          break;
        case 'internal':
          console.error('服务器出错:', error.details);
          // 显示通用错误提示
          break;
        default:
          console.error('未知错误:', error);
      }
    });
}

为什么这样改？ #

Firebase的HTTPS Callable函数要求必须用functions.https.HttpsError来抛出错误，这样它会自动把错误信息格式化成前端能解析的JSON结构，包含code、message和可选的details字段。如果直接抛出普通异常，Firebase会把它包装成内部错误，前端就没法区分是用户不存在还是其他服务器问题了。

这样修改后，不管手机号存在与否，前端都能得到清晰的反馈，再也不会看到那些莫名其妙的内部错误栈了！

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