Firebase Functions模拟器调用Express应用报错：指定函数不存在

问题 #

在Docker容器中运行Firebase Functions模拟器，端口映射为8087:8080。调用http://0.0.0.0:8087/MY-PROJECT-NAME/europe-west1/app/api/v2及子路由时，返回错误：Function europe-west1-app does not exist, valid functions are:且无有效函数。模拟器日志显示已加载函数定义，代码中已将Express应用导出为europe-west1区域的HTTP函数，尝试多种端点组合均无效，请问问题出在哪里？

模拟器日志 #

i  emulators: Starting emulators: functions
⚠  hub: Error when trying to check port 4400 on ::1: Error: listen EADDRNOTAVAIL: address not available ::1:4400
⚠  hub: Port 4400 is available on 127.0.0.1 but not ::1. This may cause issues with some clients.
⚠  hub: If you encounter connectivity issues, consider switching to a different port or explicitly specifying "host": "<ip address>" instead of hostname in firebase.json
⚠  logging: Error when trying to check port 4500 on ::1: Error: listen EADDRNOTAVAIL: address not available ::1:4500
⚠  logging: Port 4500 is available on 127.0.0.1 but not ::1. This may cause issues with some clients.
⚠  logging: If you encounter connectivity issues, consider switching to a different port or explicitly specifying "host": "<ip address>" instead of hostname in firebase.json
⚠  eventarc: Error when trying to check port 9299 on ::1: Error: listen EADDRNOTAVAIL: address not available ::1:9299
⚠  eventarc: Port 9299 is available on 127.0.0.1 but not ::1. This may cause issues with some clients.
⚠  eventarc: If you encounter connectivity issues, consider switching to a different port or explicitly specifying "host": "<ip address>" instead of hostname in firebase.json
⚠  functions: The following emulators are not running, calls to these services from the Functions emulator will affect production: auth, firestore, database, hosting, pubsub, storage
✔  functions: Using node@16 from host.
 i  ui: Emulator UI logging to ui-debug.log
 i  functions: Watching "/app/functions" for Cloud Functions...
⚠  functions: package.json indicates an outdated version of firebase-functions. Please upgrade using npm install --save firebase-functions@latest in your functions directory.
⚠  functions: Please note that there will be breaking changes when you upgrade.
✔  functions: Loaded functions definitions from source: .

核心代码 #

import * as functions from "firebase-functions"
import * as admin from "firebase-admin"
import express, { Express } from "express"
const bodyParser = require("body-parser")
const cors = require("cors")
const routes = require("./routes")

if (admin.apps.length === 0) {
    admin.initializeApp()
}

const app: Express = express()

app.use(cors({ origin: true }))
app.use("/api/v2", routes)
app.use(bodyParser.json())
app.use(bodyParser.urlencoded({ extended: false }))

exports.app = functions.region("europe-west1").https.onRequest(app)

路由代码 #

router.get("/", centre.hello)
router.post("/centre/add", centre.addCentre)

问题排查与解决方案 #

1. 端点路径格式错误 #

Firebase Functions模拟器的本地调用格式和生产环境不同，不需要带上项目名。正确的调用路径应该是：
http://0.0.0.0:8087/europe-west1/app/api/v2
或者省略区域（模拟器支持直接调用）：
http://0.0.0.0:8087/app/api/v2

2. Firebase Functions版本不兼容 #

日志明确提示firebase-functions版本过时，旧版本模拟器可能存在路由解析bug。执行以下命令升级：

cd functions
npm install --save firebase-functions@latest

升级后重启模拟器，确保函数定义被正确加载。

3. Docker容器内模拟器绑定地址问题 #

日志多次出现::1地址不可用的警告，说明模拟器默认绑定IPv6地址，但Docker容器内可能未启用IPv6。修改firebase.json，指定模拟器绑定到0.0.0.0（允许外部访问）：

{
  "emulators": {
    "functions": {
      "port": 8080,
      "host": "0.0.0.0"
    },
    "hub": {
      "host": "0.0.0.0"
    },
    "logging": {
      "host": "0.0.0.0"
    },
    "eventarc": {
      "host": "0.0.0.0"
    }
  }
}

修改后重启模拟器，确保容器内服务可被外部访问。

4. 函数加载验证 #

如果模拟器日志仅显示Loaded functions definitions from source: .但未列出具体函数名，可能是函数入口文件存在问题：

• 确保函数入口文件名为index.ts/index.js，放在functions目录下
• 检查package.json中的main字段是否指向正确的入口文件（默认是index.js）

5. Express中间件顺序问题 #

核心代码中路由挂载在bodyParser之前，会导致路由无法正确解析请求体。调整中间件顺序：

// 先解析请求体，再挂载路由
app.use(bodyParser.json())
app.use(bodyParser.urlencoded({ extended: false }))
app.use(cors({ origin: true }))
app.use("/api/v2", routes)

这个问题不会直接导致函数不存在，但会影响后续接口正常工作，建议一并修正。

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