使用BuildFastify时Google Cloud Function无法识别函数名的问题求助

错误根源 #

Google Cloud Functions（GCF）加载Node.js模块时，会同步查找导出的目标函数。你的代码里module.exports = { myFunction: ... }是放在buildFastify().then()的异步回调中执行的——当GCF完成模块加载时，这个异步回调还没触发，自然找不到myFunction，导致报错。问题和Fastify中间件无关，核心是模块导出时机不对。

修复方案 #

调整代码结构，直接同步导出myFunction，把Fastify的初始化逻辑放在函数内部处理，确保GCF加载模块时能立即找到目标函数。

修改后的代码示例：

const buildFastify = require('./app');
const path = require("path");

global.nodeRoot = path.resolve(__dirname) + "/";

// 用单例模式缓存Fastify实例，避免重复初始化
let fastifyInstance;

async function getFastifyInstance() {
  if (!fastifyInstance) {
    fastifyInstance = await buildFastify();
    await fastifyInstance.ready();
  }
  return fastifyInstance;
}

// 直接同步导出myFunction，GCF加载时就能找到
module.exports.myFunction = async (request, reply) => {
  const fastify = await getFastifyInstance();
  fastify.server.emit('request', request, reply);
};

// 本地运行逻辑，仅在非GCF环境执行
if (process.env.SERVE_MODE !== 'GCP-FUNCTION') {
  getFastifyInstance().then(fastify => {
    fastify.listen(8011, "0.0.0.0", (err, address) => {
      if (err) throw err;
      fastify.log.info(`server listening on ${address}`);
    });
  }).catch(console.error);
}

关键改动说明 #

1. 同步导出目标函数：直接把myFunction挂载到module.exports上，GCF加载模块时能立刻识别到这个函数。
2. 延迟初始化Fastify：将Fastify的初始化逻辑封装到getFastifyInstance函数中，用单例模式确保只初始化一次，第一次调用myFunction时完成初始化，后续复用实例。
3. 分离本地运行逻辑：把本地启动服务的代码放到环境判断分支中，不影响GCF的模块导出逻辑。

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