Firebase云函数抛HttpsError时客户端返回code为cancelled且details缺失

• 最常见的是云函数部署区域和客户端调用指定的区域不匹配：@nuxtjs/firebase默认调用的云函数区域是us-central1，如果你的云函数部署时指定了其他区域（如亚太区域asia-east1、欧洲区域europe-west1等），客户端未对应修改配置的情况下，无法正常接收云函数返回的错误结构，会默认返回code: cancelled、details: unknown的错误。
• 云函数侧异步逻辑未加await导致函数提前终止：如果你的云函数内查询用户等逻辑是异步操作，未添加await等待异步操作完成就结束了函数执行，抛出的HttpsError无法正常返回给客户端，连接提前断开就会触发cancelled错误。
• 客户端侧插件拦截响应：广告拦截、隐私防护类浏览器插件会拦截Firebase云函数的跨域响应，导致客户端无法拿到完整的错误结构。
• 本地调试时emulator配置不匹配：如果使用Firebase本地模拟器测试，客户端配置的模拟器端口、host和实际启动的模拟器参数不一致，也会出现该问题。
• 依赖版本不兼容：云函数侧的firebase-functions、firebase-admin和客户端的firebase、@nuxtjs/firebase跨大版本使用时存在兼容性问题，导致错误结构解析失败。

• 对齐云函数调用区域
  在nuxt.config.js的firebase配置中指定和云函数部署一致的区域：

// nuxt.config.js 配置示例
export default {
  modules: [
    '@nuxtjs/firebase'
  ],
  firebase: {
    // 其余firebase配置（apiKey、projectId等保持不变）
    functions: {
      location: '你的云函数实际部署的区域ID', // 替换为实际值，如'asia-east1'
      // 本地调试用的模拟器配置
      emulatorPort: process.env.NODE_ENV === 'development' ? 5001 : undefined,
      emulatorHost: '127.0.0.1'
    }
  }
}

也可以在调用时单独指定区域：

const loginWithEmailFunc = this.$fire.app.functions('你的云函数区域ID').httpsCallable('loginWithEmail')

• 补全云函数异步逻辑的await
  确保云函数内所有异步操作都添加了await，示例写法：

// 云函数侧正确写法示例
const functions = require('firebase-functions');
const admin = require('firebase-admin');
admin.initializeApp();

exports.loginWithEmail = functions.https.onCall(async (data, context) => {
  const userEmail = data.userEmail;
  try {
    // 异步操作必须加await
    const userRecord = await admin.auth().getUserByEmail(userEmail);
    return {
      uid: userRecord.uid,
      email: userRecord.email
    };
  } catch (err) {
    if (err.code === 'auth/user-not-found') {
      throw new functions.https.HttpsError("not-found", "No user found with this email", "here are some meaningless details");
    }
    throw new functions.https.HttpsError("internal", "服务端处理错误");
  }
});

• 排查拦截类问题
  暂时禁用所有浏览器插件后重试，确认没有插件拦截云函数的请求和响应。

• 对齐依赖版本
  将客户端的firebase、@nuxtjs/firebase，以及云函数侧的firebase-functions、firebase-admin都升级到对应大版本下的最新稳定版，避免兼容性问题。

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