如何使用Firebase上传静态网站 解决部署后显示默认欢迎页问题

第一步：确认目录结构与部署工作路径 #

Firebase CLI 仅识别相对路径，所有路径均相对于你执行部署命令的工作目录计算：

• 若你的index.html直接存放在C:\site根目录下，后续所有firebase相关命令都必须在C:\site路径下执行
• 若你选择把站点资源统一存放在子文件夹，需保证index.html直接放在C:\site\public根目录，命令仍在C:\site路径下执行

第二步：正确配置firebase.json #

该文件存放在你执行firebase init的目录下，直接修改对应配置即可：

方案1：直接使用C:\site作为发布目录（无需移动现有文件） #

{
  "hosting": {
    "public": ".",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ],
    "cleanUrls": true
  }
}

方案2：使用C:\site\public作为发布目录 #

{
  "hosting": {
    "public": "public",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ],
    "cleanUrls": true
  }
}

注意：不要在public字段填写绝对路径（如C:\site），仅支持填写相对路径

第三步：排查常见配置错误 #

• 确认public配置指向的目录下直接存在index.html文件，不能嵌套在子文件夹中，否则Firebase会自动加载默认欢迎页
• 执行firebase deploy --debug查看上传文件列表，确认index.html未被ignore规则拦截，且上传路径为根路径
• 执行firebase use确认当前绑定的是目标部署项目，避免误部署到其他项目
• 没有自定义重定向需求的情况下，删除hosting配置下的rewrites字段，避免错误规则拦截首页请求

第四步：部署后缓存清理 #

部署成功后仍显示默认页的话，执行浏览器硬刷新（Windows系统按Ctrl+Shift+R，Mac系统按Cmd+Shift+R），或在站点地址后加参数?v=1访问，排除本地缓存影响。

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