Firebase Hosting请求不存在资源为何返回完整HTML响应？

开发者阿泽

2026-5-25

关于Firebase Hosting返回HTML而非404的问题解答

这其实是Firebase Hosting默认的SPA重写规则在搞事情哦！

为什么会出现这种情况？

Firebase Hosting为了适配单页应用（SPA）的前端路由需求，默认会在firebase.json里配置全局重写规则——把所有请求（包括不存在的资源路径）都转发到index.html。比如你的配置文件里大概率有这样的内容：

{
  "hosting": {
    "public": "你的静态资源目录",
    "rewrites": [
      {
        "source": "**",
        "destination": "/index.html"
      }
    ]
  }
}

这里的"source": "**"会匹配所有URL路径，所以哪怕你请求的是不存在的main.css，服务器也会返回index.html，而不是预期的404。

怎么解决这个问题？

分两种情况处理：

如果不需要SPA路由：直接删掉rewrites这部分配置，重新部署后，服务器就会对不存在的资源返回标准404状态码。
如果需要保留SPA路由，但要让静态资源返回正确404：调整重写规则的顺序，先匹配静态资源的路径，再处理SPA路由。比如修改firebase.json为：

{
  "hosting": {
    "public": "你的静态资源目录",
    "rewrites": [
      // 先匹配所有静态资源文件
      {
        "source": "**/*.{css,js,png,jpg,jpeg,gif,svg,ico}",
        "destination": "/$1"
      },
      // 剩下的路径再转发到index.html
      {
        "source": "**",
        "destination": "/index.html"
      }
    ]
  }
}

这样配置后，请求静态资源时会优先查找对应文件，不存在的话就返回404；其他路径则继续由SPA路由处理。