Firebase Functions JS：拆分内部函数至外部文件及调用方法

嘿，我之前拆分Firebase Functions的时候也遇到过这个问题，刚好可以给你分享下具体的操作步骤，完全能解决index.js臃肿的问题！

1. 在internalFunctions.js中导出多个函数 #

你可以根据项目的模块系统选择两种导出方式：

方式一：CommonJS（Node.js默认，适合大多数Firebase Functions项目）

直接用exports或者module.exports把需要复用的函数暴露出去，示例代码如下：

// internalFunctions.js
// 记得先导入Firebase Admin SDK（如果函数里需要用到的话）
const admin = require('firebase-admin');

// 定义第一个内部函数：处理用户数据
exports.processUser = async (userId) => {
  const userDoc = await admin.firestore().collection('users').doc(userId).get();
  if (!userDoc.exists) {
    throw new Error('用户不存在');
  }
  return userDoc.data();
};

// 定义第二个内部函数：发送推送通知
exports.sendNotification = async (userId, messageContent) => {
  const message = {
    notification: {
      title: '系统通知',
      body: messageContent
    },
    token: userId // 假设userId对应FCM设备令牌，根据你的实际情况调整
  };

  await admin.messaging().send(message);
  console.log(`已向用户${userId}发送通知`);
};

方式二：ES模块（如果你的项目配置了"type": "module"）

如果你的package.json里添加了"type": "module"，就可以用ES模块语法导出：

// internalFunctions.js
import admin from 'firebase-admin';

export const processUser = async (userId) => {
  // 同上的业务逻辑
};

export const sendNotification = async (userId, messageContent) => {
  // 同上的业务逻辑
};

2. 在index.js中导入并调用这些函数 #

导入之后，你就可以在公开的Firebase函数里直接调用这些内部函数了，代码示例：

CommonJS导入方式

// index.js
const functions = require('firebase-functions');
const admin = require('firebase-admin');
// 导入internalFunctions里的两个函数
const { processUser, sendNotification } = require('./internalFunctions');

admin.initializeApp();

// 示例1：HTTP触发器函数，调用内部函数
exports.getUserProfile = functions.https.onRequest(async (req, res) => {
  try {
    const userId = req.query.userId;
    const userProfile = await processUser(userId);
    // 调用发送通知的内部函数
    await sendNotification(userId, `你查看了自己的个人资料`);
    res.status(200).json(userProfile);
  } catch (err) {
    res.status(500).send(`请求失败：${err.message}`);
  }
});

// 示例2：Firestore触发器函数，调用内部函数
exports.onUserUpdated = functions.firestore.document('users/{userId}')
  .onUpdate(async (change, context) => {
    const userId = context.params.userId;
    const updatedData = change.after.data();
    await sendNotification(userId, `你的资料已更新：姓名改为${updatedData.name}`);
    return null;
  });

ES模块导入方式

如果用ES模块，导入语法改成：

import functions from 'firebase-functions';
import admin from 'firebase-admin';
import { processUser, sendNotification } from './internalFunctions.js';

admin.initializeApp();

// 后面的函数逻辑和上面一样

小提示 #

• 内部函数不需要在index.js里导出，只有需要对外暴露的Firebase触发器函数（比如HTTP、Firestore触发器）才需要用exports.xxx导出，这样部署的时候Firebase只会部署这些公开函数。
• 如果内部函数依赖Firebase的服务，记得在internalFunctions.js里导入对应的SDK（比如admin），保证每个文件的独立性。

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