Firebase模拟器无视配置，持续使用随机已占用端口

问题分析 #

你的问题核心出在配置项无效和使用过时命令两个点，导致Firebase CLI没有读取到指定端口配置，进而随机选择端口还出现占用报错。

修复步骤 #

1. 修正firebase.json配置 #

functions节点下的port字段是无效配置，Firebase CLI不会在这里读取端口设置，只有emulators节点下的端口配置才会生效。删除functions里的port字段，修正后的配置如下：

{
  "hosting": {
    "public": "build",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ],
    "rewrites": [
      {
        "source": "/api/**",
        "function": "server"
      },
      {
        "source": "**",
        "function": "app"
      }
    ]
  },
  "functions": {
    "source": "server",
    "runtime": "nodejs18",
    "ignore": [
      "public/**",
      "src/**"
    ]
  },
  "emulators": {
    "functions": {
      "port": 5001
    }
  }
}

2. 使用正确的本地启动命令 #

firebase serve是官方弃用的旧命令，它不会正确读取emulators节点的配置。改用官方推荐的命令启动本地模拟器：

firebase emulators:start

3. 彻底清理残留进程 #

如果仍提示端口占用，用以下命令强制清理占用5001端口的进程：

• macOS/Linux：

  lsof -ti :5001 | xargs kill -9
  

• Windows（PowerShell）：

  Stop-Process -Id (Get-NetTCPConnection -LocalPort 5001).OwningProcess -Force
  

4. 清空Firebase CLI缓存 #

缓存可能导致配置不生效，执行以下命令清空缓存：

firebase clear

或者直接删除项目根目录下的.firebase文件夹。

额外验证 #

启动后检查终端输出，确认Functions模拟器是否使用了5001端口，正常输出应包含：

✔  functions: Emulator started at http://localhost:5001

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