Firebase部署后显示欢迎页而非自定义应用问题求助

云原生阿岚

2026-8-20

Firebase部署后显示默认欢迎页的解决办法

检查firebase.json配置是否正确
正确配置需包含指向build的public字段，以及单页应用必需的重写规则，示例如下：
```
{
  "hosting": {
    "public": "build",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ],
    "rewrites": [
      {
        "source": "**",
        "destination": "/index.html"
      }
    ]
  }
}
```
若配置缺少rewrites或规则错误，会导致单页应用无法正常加载，甚至显示默认欢迎页。
验证本地build目录内容
直接在本地打开build/index.html，确认显示的是你的应用内容而非Firebase欢迎页。同时检查build目录是否存在多余的index.html，避免默认欢迎页文件混入其中。
强制刷新缓存重新部署
部署时添加--force参数强制刷新缓存，执行命令：
```
firebase deploy --only hosting --force
```
也可前往Firebase控制台托管页面，手动找到「缓存存储」选项清除缓存。
确认部署目标项目
用firebase use命令查看当前选中的Firebase项目，若选错则切换至正确项目后重新部署：
```
firebase use <你的项目ID>
```
检查文件上传完整性
尽管仪表盘显示上传了727个文件，仍需前往Firebase控制台「文件」选项卡，确认build目录下文件完整，尤其是index.html内容为你的应用打包代码，而非默认欢迎页代码。