Firebase v9模块化SDK调用Stripe createPortalLink报functions非函数错误

在Firebase Functions环境中使用Stripe官方Firebase扩展，重构代码适配Firebase v9模块化SDK后，调用Stripe相关的createPortalLink()函数时控制台抛出类型错误。

Uncaught (in promise) TypeError: _firebase__WEBPACK_IMPORTED_MODULE_2__.default.functions is not a function
    at createPortalLink (Subscription.js:99:1)

async function createPortalLink() {
    const functionRef = app
      .functions("europe-west1")
      .httpsCallable("ext-firestore-stripe-payments-createPortalLink");

    const { data } = await functionRef({
      returnUrl: `${window.location.origin}/dashboard-pro/abonnement/`,
      locale: "auto",
    });
    window.location.assign(data.url);
  }

报错的核心原因是Firebase v9 模块化SDK完全移除了v8版本中从FirebaseApp实例链式挂载服务方法的命名空间式写法，直接在初始化好的app实例上调用.functions()会找不到对应方法，触发类型错误。

• 先检查依赖：确认项目安装的Firebase版本为v9及以上，且已引入functions对应的模块（v9版本各服务能力需要单独从对应入口导入，不会默认挂在app实例上）
• 排查写法混用：确认代码中没有同时混用v8命名空间写法和v9模块化写法，如果需要过渡兼容可以临时使用firebase/compat/functions的兼容包，长期建议直接切换为原生模块化写法
• 修正调用逻辑：放弃链式调用写法，单独导入functions服务的初始化、可调用方法相关API

// 从对应服务入口导入需要的模块化API
import { getFunctions, httpsCallable } from "firebase/functions";
// 导入你项目中已经初始化完成的FirebaseApp实例
import { app } from "@/firebase/config"; // 替换为你自己的firebase初始化文件路径

async function createPortalLink() {
  // 初始化指定区域的Functions服务实例
  const functionsInstance = getFunctions(app, "europe-west1");
  // 获取Stripe扩展部署的可调用函数引用
  const createPortalLinkRef = httpsCallable(functionsInstance, "ext-firestore-stripe-payments-createPortalLink");

  const { data } = await createPortalLinkRef({
    returnUrl: `${window.location.origin}/dashboard-pro/abonnement/`,
    locale: "auto",
  });
  window.location.assign(data.url);
}

补充说明：如果本地开发需要对接Functions模拟器，connectFunctionsEmulator方法同样需要从firebase/functions入口导入，传入初始化好的functions实例作为参数即可，不要尝试从app实例上调用该方法。

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