You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Firebase Hosting未生成firebase.json且部署后显示默认页面求助

解决Firebase Hosting部署后显示默认欢迎页而非自定义index.html的问题

我来帮你一步步排查解决这个问题——既然你提到初始化过程提示已经写入firebase.json,但访问时还是显示默认欢迎页,咱们从这几个方向入手:

1. 确认firebase.json文件是否存在且配置正确

首先打开项目根目录,检查是否有firebase.json文件:

  • 如果文件不存在,手动创建一个,内容如下(确保public字段和你初始化时指定的公共目录一致):
    {
      "hosting": {
        "public": "public",
        "ignore": [
          "firebase.json",
          "**/.*",
          "**/node_modules/**"
        ]
      }
    }
    
  • 如果文件存在,打开检查hosting.public的值是否指向你存放自定义index.html的目录,有没有拼写错误。

2. 验证公共目录下的文件是否正确

  • 打开你指定的公共目录(比如public/),确认index.html是你自己的页面内容,而非Firebase的默认欢迎页。如果不小心被覆盖了,把你自己的index.html替换进去。
  • 同时检查目录内的其他静态资源(CSS、JS、图片等)路径是否正确,避免因资源引用错误导致页面显示异常。

3. 重新执行初始化或部署操作

如果配置文件存在但仍有问题,可以尝试重置部署配置:

  1. 删除项目根目录下的firebase.json和.firebaserc文件;
  2. 重新运行firebase init,仔细确认每一步:
    • 选择正确的Firebase项目;
    • 确认Hosting功能被选中;
    • 准确指定存放静态文件的公共目录;
    • 按需选择是否配置单页应用;
    • 询问是否覆盖现有文件时,选择N以保留你的自定义页面;
  3. 完成初始化后,执行firebase deploy --only hosting(仅部署Hosting服务,避免影响其他功能)。

4. 强制清除浏览器缓存后重新访问

浏览器可能缓存了旧的默认欢迎页,尝试:

  • 使用Ctrl+Shift+R(Windows/Linux)或Cmd+Shift+R(Mac)强制刷新页面;
  • 或者用浏览器的隐身模式打开Hosting URL,查看是否显示你的自定义页面。

5. 检查Firebase控制台的部署状态

登录Firebase控制台进入你的项目,找到Hosting板块:

  • 查看部署历史,确认最近一次部署是否成功上传了你的文件;
  • 确认Hosting的默认域名配置正常,没有指向错误的资源。

内容的提问来源于stack exchange,提问作者Rafael de Azeredo

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.28 06:07:41