如何为Firebase Cloud Functions导入基于模块的依赖？

导入写法差异的原因 #

import * as和require的导入逻辑区别，和puppeteer-extra包本身的导出规范有关：

• import * as xxx from '包名'是ES模块的命名空间导入写法，会把目标包所有顶级导出的内容封装成一个对象返回。puppeteer-extra是典型的CommonJS规范包，它的核心方法（包括launch）全部挂在默认导出对象上，没有做顶级导出适配，所以用命名空间导入后拿到的对象里没有launch属性，自然会报错。
• const xxx = require('包名')是CommonJS的导入写法，直接返回包的默认导出对象，刚好匹配puppeteer-extra的导出结构，所以可以正常调用launch方法。
• 如果你想统一用ES导入写法，可以在tsconfig.json中开启esModuleInterop: true和allowSyntheticDefaultImports: true，之后改用import puppeteer from "puppeteer-extra"的默认导入写法即可正常使用。
• crypto-js没有出现这个问题，是因为这个包同时适配了ES命名空间导入和CommonJS导出规范，两种写法都能拿到正确的调用对象。

依赖体积优化的相关说明 #

你认为拆分模块、按需导入依赖可以减小函数运行时的资源加载体积，这个认知是完全正确的。Firebase Cloud Functions冷启动时只会加载当前被触发函数执行路径上的依赖，如果所有依赖都集中导入在index.ts中，哪怕是和当前触发函数无关的依赖也会被加载，会拉长冷启动时间，浪费运行内存。

正确的依赖处理方式如下：

• 坚持按功能拆分独立模块，每个模块只导入自身需要的专属依赖，不要跨模块导入无关依赖。
• 不要在index.ts的顶级位置批量导入所有子模块，改用动态导入的方式按需加载对应模块，示例代码如下：

// index.ts 示例
import * as functions from "firebase-functions";

// 加密相关函数：只有被触发时才会加载crypto.ts和crypto-js依赖
export const encryptUserData = functions.https.onCall(async (data, context) => {
  const { encryptHandler } = await import("./crypto");
  return encryptHandler(data, context);
});

// 爬虫相关函数：只有被触发时才会加载webscrape.ts和puppeteer相关依赖
export const scrapeWebPage = functions.https.onCall(async (data, context) => {
  const { scrapeHandler } = await import("./webscrape");
  return scrapeHandler(data, context);
});

• 定期清理package.json中的冗余依赖，没有被任何模块用到的包直接移除，避免被打包进部署镜像。
• 针对体积较大的依赖（比如puppeteer），可以考虑用轻量替代包，或者配合Firebase的依赖排除规则进一步缩小部署包体积。

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