本地运行Firebase Cloud Functions模拟器遇EADDRINUSE问题求助

我之前也碰到过几乎一模一样的问题，折腾了好一会儿才搞定，给你几个亲测有效的解决思路：

1. 先检查你的Functions代码（最可能的根源！） #

看报错信息里提到你的index.js第61行调用了listen方法——这大概率是问题核心！Firebase Cloud Functions的HTTP函数不需要你手动调用app.listen()，不管是部署到线上还是用模拟器运行，Firebase都会自动帮你处理端口绑定和请求路由。

如果你的代码里保留了本地Express项目的app.listen(5000)（或者其他端口），当模拟器启动你的函数时，就会触发两次端口监听：一次是模拟器本身的绑定，一次是你代码里的手动监听，直接导致端口冲突。

解决方法：删掉代码里的app.listen()语句，只导出HTTP函数就行，比如：

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

// 你的路由逻辑
app.get("/test", (req, res) => {
  res.send("测试响应");
});

// 只导出函数，不要自己启动服务器
exports.main = functions.https.onRequest(app);

2. 彻底清理Firebase模拟器的残留进程 #

有时候模拟器退出时会残留后台子进程，导致端口被占用但你用常规命令找不到（因为进程名不是直接的firebase）。可以这样操作：

• 先执行命令停止所有模拟器：

  firebase emulators:stop
  

• 然后找所有和Firebase/Node相关的进程：
  • Mac/Linux：

    ps aux | grep -E "firebase|node"
    

    找到可疑的进程后用kill -9 <PID>杀掉（替换成实际的进程ID）
  • Windows：

    tasklist | findstr /i "firebase node.exe"
    

    用taskkill /F /PID <PID>强制终止进程
• 也可以直接找占用5000端口的进程：
  • Mac/Linux：lsof -i :5000
  • Windows：netstat -ano | findstr :5000

3. 清除模拟器缓存 #

模拟器会缓存一些配置文件，残留的缓存可能导致多实例冲突警告。删除缓存目录：

• Mac/Linux：rm -rf ~/.cache/firebase/emulators
• Windows：打开文件管理器，进入%APPDATA%\Roaming\firebase\emulators，删除里面的所有内容

4. 手动指定模拟器端口（避免默认端口冲突） #

在项目根目录的firebase.json里手动指定所有模拟器的端口，避免和系统其他服务或残留进程冲突：

{
  "emulators": {
    "functions": {
      "port": 5002
    },
    "ui": {
      "port": 4001
    },
    "database": {
      "port": 9000
    }
  }
}

修改后重新启动模拟器：firebase emulators:start

按这个顺序排查，先看代码里的listen语句，这个是最容易忽略也最常见的问题，应该能解决你的端口冲突和多实例警告。

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