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

部署在Firebase上的React应用显示空白页面问题求助

React部署Firebase Hosting后空白页的解决办法

先给你揪出最可能的问题——你的firebase.json里写错了一个关键字段:"rewires"应该是"rewrites"!这个拼写错误会让React单页应用必需的路由重写规则完全失效,这就是为什么部署后只有页面标题显示、内容空白的核心原因。

第一步:修正配置文件

把firebase.json里的"rewires"改成"rewrites",正确配置如下:

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

第二步:重新构建部署

  1. 先执行npm run build生成最新的生产构建文件,确保client/build目录是完整的
  2. 重新部署到Firebase:firebase deploy --only hosting

额外排查方向

如果修正后还是有问题,再检查这几点:

  • 确认client/build目录下确实有index.html和静态资源文件夹(比如static/css、static/js),如果构建失败会导致部署的文件不完整
  • 看浏览器控制台的错误信息:如果是静态资源404,那可能是React的homepage配置问题,需要在package.json里添加"homepage": "."(如果部署在根域名)或者对应子路径
  • 确认你部署的是正确的Firebase项目,别不小心部署到其他测试项目去了

你提到本地firebase serve正常,是因为本地开发服务器自带了单页应用的 fallback 逻辑,但Firebase Hosting是严格按照你写的配置文件执行的,拼写错误直接导致重写规则不生效,自然加载不了React应用内容。

内容的提问来源于stack exchange,提问作者Keingtobin

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.21 21:21:03