Node.js同时保留端口监听和云函数代码时Firebase部署报错如何解决？

Cloud Run error: Container failed to start. Failed to start and then listen on the port defined by the PORT environment variable.
这个报错的核心原因是Firebase Cloud Functions/Cloud Run 运行时会自动处理HTTP请求的端口监听逻辑，你手动调用app.listen()会和平台默认的端口绑定规则冲突，导致容器启动时出现端口占用、或者绑定了不符合平台要求的端口，最终启动失败。
本地开发阶段你需要app.listen()来启动本地服务做测试，但部署到云端时这行代码是多余且会引发错误的。

只需要给app.listen()加上运行环境判断，只有在本地开发环境下才执行端口监听逻辑，云端运行时跳过即可。常见的判断方式可以通过Firebase本地模拟器的内置环境变量process.env.FUNCTIONS_EMULATOR，或者自定义环境变量区分，修复后的代码示例如下：

const functions = require("firebase-functions");
const express = require('express');
const app = express();

require('dotenv').config();
app.get('/', (req, res,next) => {
    res.send(`Hello  world received a request!\n`);
    next();
  });
  
// 仅本地开发时启动端口监听
if (process.env.NODE_ENV === 'development' || process.env.FUNCTIONS_EMULATOR) {
  const port = process.env.PORT || 5000;
  app.listen(port, () => {
    console.log('Hello world listening on port', port);
  });
}
  
exports.cloudrun = functions.https.onRequest(app);

• 不要修改exports.cloudrun = functions.https.onRequest(app)这行代码，它负责将express实例和Firebase的HTTP触发器绑定，云端的请求转发全靠这行逻辑实现
• 本地启动测试的时候，可以在启动命令前加NODE_ENV=development的环境变量，确保app.listen正常执行
• 部署前不需要额外修改代码，云端运行时不会命中app.listen的判断分支，不会触发端口冲突

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