Firebase Hosting模拟器忽略firebase.json端口配置默认5002问题排查

核心原因分析 #

从你的日志和配置来看，最可能的问题是端口配置位置错误：你将port和host配置在了hosting根节点下，但Firebase模拟器的端口配置需要放在emulators节点的hosting子项中。Firebase CLI只会读取emulators节点下的端口配置来启动模拟器，hosting根节点的端口配置仅适用于生产部署或旧版工具，对模拟器无效。

另外还有几种次要可能：

• 项目根目录存在firebase.emulators.json文件，覆盖了firebase.json的配置
• firebase.json存在语法错误，导致CLI无法正确解析配置
• 多Hosting站点配置冲突（若你的项目包含多个Hosting站点）

解决与排查步骤 #

1. 修正配置文件结构 #

将端口配置移至emulators节点下，正确的firebase.json示例：

{
  "hosting": {
    "public": "public",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ],
    "rewrites": [
      {
        "source": "**",
        "destination": "/index.html"
      }
    ]
  },
  "emulators": {
    "hosting": {
      "port": 9000,
      "host": "localhost"
    },
    // 其他模拟器配置可按需添加
    "firestore": {
      "port": 8080
    }
  }
}

2. 检查覆盖配置文件 #

若项目根目录存在firebase.emulators.json文件，该文件的配置优先级高于firebase.json，请删除该文件或修改其中的Hosting端口配置。

3. 单独启动Hosting模拟器验证 #

执行以下命令单独启动Hosting模拟器，排除其他服务干扰：

firebase emulators:start --only hosting

观察日志是否显示使用了你指定的9000端口。

4. 验证配置文件语法 #

使用JSON校验工具检查firebase.json是否存在语法错误（如缺失逗号、引号不匹配），可执行本地命令：

npx jsonlint firebase.json

5. 命令行指定端口测试 #

正确的Hosting端口命令行参数是--hosting-port，而非--port，执行：

firebase emulators:start --hosting-port 9000

验证是否能正常启动在指定端口。

6. 确认当前关联项目 #

执行以下命令确认CLI当前关联的项目正确，避免配置文件对应错误项目：

firebase use

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