部署集成OpenAI的Firebase Cloud Functions时遇启动失败错误

问题概述 #

部署集成OpenAI的Firebase Cloud Functions时，Cloud Run服务健康检查失败，容器未监听PORT=8080环境变量指定的端口，导致函数部署失败。

错误详情 #

Cloud Run容器错误提示 #

无法创建或更新Cloud Run服务firstcall，容器健康检查失败。版本'firstcall-00001-jel'未就绪，无法处理流量。用户提供的容器未能启动并监听PORT=8080环境变量定义的端口。该版本的日志可能包含更多信息。

Functions部署错误日志 #

Functions deploy had errors with the following functions:
        firstCall(us-central1)
i  functions: cleaning up build files...
!  functions: Unhandled error cleaning up build images. This could result in a small monthly bill if not corrected. You can attempt to delete these images by redeploying or you can delete them manually at https://console.cloud.google.com/artifacts/docker/clouddeneme-6f208/us-central1/gcf-artifacts
Error: There was an error deploying functions

部署代码 #

const {onRequest} = require("firebase-functions/v2/https");
const {initializeApp} = require("firebase-admin/app");
const {Configuration, OpenAIApi} = require("openai");
const configuration = new Configuration({
  apiKey: process.env.OPENAI_API_KEY,
});
const openai = new OpenAIApi(configuration);
initializeApp();
exports.firstCall = onRequest({maxInstances: 10}, async (request, response) => {
  const chatCompletion = await openai.createChatCompletion({
    model: "gpt-3.5-turbo",
    messages: [{role: "user", content: "Hello world"}],
  });
  response.send(chatCompletion);
});

排查原因 #

1. 环境变量缺失：未正确配置OPENAI_API_KEY，导致OpenAIApi初始化失败，函数服务无法正常启动监听端口。
2. 依赖问题：openai依赖未正确安装，启动时出现模块缺失错误。
3. 未处理异常：async函数中未捕获OpenAI请求的异常，导致服务崩溃。
4. 响应序列化问题：直接返回chatCompletion对象可能包含循环引用，引发序列化错误导致服务异常。

解决方案 #

1. 配置环境变量 #

使用Firebase CLI设置环境变量：

firebase functions:config:set openai.api_key="你的OpenAI API密钥"

修改代码读取Firebase配置（替代直接读取process.env）：

const functions = require("firebase-functions");
const configuration = new Configuration({
  apiKey: functions.config().openai.api_key,
});

也可在Cloud Run控制台的服务设置中手动添加OPENAI_API_KEY环境变量。

2. 确保依赖正确安装 #

检查functions/package.json中的依赖配置，确保包含openai：

"dependencies": {
  "firebase-admin": "^11.8.0",
  "firebase-functions": "^4.3.0",
  "openai": "^3.3.0"
}

在functions目录下执行：

npm install

3. 添加错误处理与修正响应 #

修改函数代码，添加异常捕获并返回正确的响应数据：

const {onRequest} = require("firebase-functions/v2/https");
const {initializeApp} = require("firebase-admin/app");
const {Configuration, OpenAIApi} = require("openai");
const functions = require("firebase-functions");

const configuration = new Configuration({
  apiKey: functions.config().openai.api_key,
});
const openai = new OpenAIApi(configuration);
initializeApp();

exports.firstCall = onRequest({maxInstances: 10}, async (request, response) => {
  try {
    const chatCompletion = await openai.createChatCompletion({
      model: "gpt-3.5-turbo",
      messages: [{role: "user", content: "Hello world"}],
    });
    // 返回data字段避免序列化问题
    response.send(chatCompletion.data);
  } catch (error) {
    console.error("OpenAI请求失败:", error);
    response.status(500).send({ error: "请求处理失败，请稍后重试" });
  }
});

4. 本地验证 #

启动Firebase模拟器测试函数：

firebase emulators:start --only functions

访问本地地址（如http://localhost:5001/clouddeneme-6f208/us-central1/firstCall），确认正常返回结果。

5. 清理残留镜像 #

手动访问Google Cloud控制台的Artifacts Registry，删除clouddeneme-6f208/us-central1/gcf-artifacts下的残留镜像，避免不必要的费用。

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