Firebase部署React前端与Node.js/Express后端函数报错求助

我在Firebase上部署的React前端运行正常，但通过Firebase Functions部署的Node.js/Express后端仅能本地运行。日志显示用户代码存在错误，但本地运行无异常，刚接触Firebase，尝试过网上的修复方案仍未解决，附上相关代码片段与Firebase调试日志。

代码结构及片段 #

项目根目录结构：

root/
├── functions/
│   └── index.js
├── src/
│   ├── app.js
│   ├── server.js
│   └── [其他路由/错误处理模块]
├── firebase.json
└── .env

functions/index.js #

const functions = require("firebase-functions");
const express = require("express");
const cors = require("cors");

const expressApp = express();
const serviceApp = require("../src/app");

expressApp.use(cors());
expressApp.use("/", serviceApp);

exports.app = functions.https.onRequest(expressApp);

firebase.json #

{
  "functions": {
    "ignore": [
      "node_modules",
      ".git",
      "firebase-debug.log",
      "firebase-debug.*.log"
    ],
    "source": "functions"
  },
  "hosting": {
    "site": "gys-be-test",
    "public": "public",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ],
    "rewrites" : [{"source" : "**", "function" : "app"}]
  }
}

src/app.js #

const path = require("path");

require("dotenv").config({ path: path.join(__dirname, "..", ".env") });

const express = require("express");
const cors = require("cors");

const errorHandler = require("./errors/errorHandler");
const notFound = require("./errors/notFound");

const resourcesRouter = require("./Resources/resources.router");
const contactsRouter = require("./Contacts/contacts.router");
const postsRouter = require("./Posts/posts.router");
const usersRouter = require("./Users/users.router");
const promptsRouter = require("./Prompts/prompts.router");
const eventsRouter = require("./Events/events.router");

const app = express();

app.use(cors());
app.use(express.json());

app.use("/users", usersRouter);
app.use("/posts", postsRouter);
app.use("/prompts", promptsRouter);
app.use("/events", eventsRouter);
app.use("/resources", resourcesRouter);
app.use("/contacts", contactsRouter);

app.use(notFound);
app.use(errorHandler);

module.exports = app;

src/server.js #

const { PORT = 5001 } = process.env;

const app = require("./app");
const knex = require("./db/connection");

knex.migrate
  .latest()
  .then((migrations) => {
    console.log("migrations", migrations);
    app.listen(PORT, listener);
  })
  .catch((error) => {
    console.error(error);
    knex.destroy();
  });

function listener() {
  console.log(`Listening on Port ${PORT}!`);
}

Firebase调试日志片段 #

[info] Functions deploy had errors with the following functions:
    app(us-central1)
[debug] [2022-09-04T20:22:06.986Z] Not printing URL for HTTPS function. Typically this means it didn't match a filter or we failed deployment
[info] i  functions: cleaning up build files... 
[debug] [2022-09-04T20:22:06.988Z] >>> [apiv2][query] DELETE https://artifactregistry.googleapis.com/v1beta2/projects/gys-be-test/locations/us-central1/repositories/gcf-artifacts/packages/app [none]
[debug] [2022-09-04T20:22:06.989Z] >>> [apiv2][query] GET https://us.gcr.io/v2/gys-be-test/gcf/us-central1/tags/list [none]
[debug] [2022-09-04T20:22:07.199Z] <<< [apiv2][status] GET https://us.gcr.io/v2/gys-be-test/gcf/us-central1/tags/list 200
[debug] [2022-09-04T20:22:07.199Z] <<< [apiv2][body] GET https://us.gcr.io/v2/gys-be-test/gcf/us-central1/tags/list {"child":[],"manifest":{},"name":"gys-be-test/gcf/us-central1","tags":[]}
[debug] [2022-09-04T20:22:07.200Z] Could not find image for function projects/gys-be-test/locations/us-central1/functions/app

问题排查与修复方案 #

1. 核心问题：文件结构不兼容Firebase Functions部署规则 #

Firebase Functions部署时只会打包functions目录下的文件，你的src目录在根目录，部署时无法被包含，导致函数找不到依赖模块。

修复步骤：

• 将src目录移动到functions目录内部，调整后结构：

  root/
  ├── functions/
  │   ├── src/
  │   │   ├── app.js
  │   │   ├── server.js
  │   │   └── [其他模块]
  │   └── index.js
  ├── firebase.json
  └── .env
  

• 修改functions/index.js中的引用路径：

  const serviceApp = require("./src/app");
  

• 修改functions/src/app.js中的.env路径：

  require("dotenv").config({ path: path.join(__dirname, "../../.env") });
  

2. 处理Knex迁移与环境变量 #

• Firebase Functions不会自动执行Knex迁移，需在函数初始化时触发，或提前手动将迁移同步到数据库。
• 本地.env文件不会被部署到Firebase，建议使用Firebase环境变量存储敏感信息：
  执行命令设置环境变量：

  firebase functions:config:set db.host="你的数据库地址" db.user="数据库用户名" db.password="数据库密码" db.database="数据库名"
  

  在代码中读取环境变量：

  const functions = require("firebase-functions");
  const knex = require("knex")({
    client: 'pg', // 替换为你的数据库客户端类型
    connection: {
      host: functions.config().db.host,
      user: functions.config().db.user,
      password: functions.config().db.password,
      database: functions.config().db.database
    }
  });
  

3. 验证部署命令与权限 #

• 确保使用正确的部署命令：

  firebase deploy --only functions,hosting
  

• 若权限异常，重新登录Firebase CLI：

  firebase logout
  firebase login
  

4. 获取详细错误信息 #

当前日志未显示具体代码错误，需查看Firebase控制台的函数日志：
打开Firebase控制台 → 进入Functions服务 → 选择app函数 → 查看「日志」标签页，获取模块缺失、数据库连接失败等具体报错。

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