Firebase .web.app域名提示Site Not Found但.firebaseapp.com访问正常问题咨询

排查解决步骤 #

1. 确认部署配置正确 #

检查项目根目录下的firebase.json文件，确保Hosting配置包含单页应用必要的重定向规则，适配React Router的客户端路由：

{
  "hosting": {
    "public": "build",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ],
    "rewrites": [
      {
        "source": "**",
        "destination": "/index.html"
      }
    ]
  }
}

确认public字段指向的是React项目打包后的build目录，没有写错路径。

2. 检查Firebase多站点配置 #

如果你的项目配置了Firebase多站点，需要确认.web后缀的默认域名绑定的站点，和你执行firebase deploy部署的站点是同一个：

• 执行firebase target:list查看当前项目的所有部署目标
• 确认.web域名关联的站点ID和你部署的站点ID一致
• 如果不一致，执行firebase deploy --only hosting:[你的.web域名对应站点ID]重新部署

3. 核对Firebase控制台域名状态 #

登录Firebase控制台，进入对应项目的Hosting页面：

• 查看两个默认域名的部署状态，确认.web域名显示的最近部署时间和.firebaseapp域名一致
• 如果.web域名显示部署未完成，等待5-10分钟再重试访问，Firebase域名同步存在一定延迟
• 如果显示部署失败，查看部署日志排查具体错误原因

4. 排除缓存问题 #

• 打开浏览器无痕模式访问.web域名，排除本地浏览器缓存影响
• 执行DNS刷新命令清空本地DNS缓存：
  • Windows系统：ipconfig /flushdns
  • Mac/Linux系统：sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
• 切换手机移动网络访问，排除当前网络的DNS缓存问题

5. 强制重新部署 #

如果以上步骤都没问题，执行强制重新部署触发域名同步：

firebase deploy --only hosting --force

部署完成后等待15分钟再访问.web域名测试。如果仍然无法访问，可在Firebase控制台提交支持工单排查域名侧绑定异常。

内容的提问来源于stack exchange，提问作者Saif Al Siam