Flutter项目重新部署Firebase Hosting后URL无法正常访问

架构老林

2026-8-4

解决Flutter项目更新部署Firebase后跳转文档页的问题

排查与解决步骤

核对firebase.json配置
重点检查hosting节点的public路径，Flutter Web编译后的默认输出目录是build/web，正确配置应该类似：
```
{
  "hosting": {
    "public": "build/web",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ],
    "rewrites": [
      {
        "source": "**",
        "destination": "/index.html"
      }
    ]
  }
}
```
如果public指向空目录或错误路径，Firebase找不到可托管的内容就会跳转到默认文档页。
重新编译Flutter Web项目
更新代码后必须重新编译生成最新资源，执行命令：
```
flutter build web
```
确认编译无报错，且build/web目录下有index.html、main.dart.js等完整文件。
检查firebase init的配置选项
再次执行firebase init时可能误改了设置：
- 选择Hosting时，确认指定的公共目录是build/web；
- 必须勾选"Configure as a single-page app (rewrite all urls to /index.html)"，这个选项是Flutter单页应用正常运行的关键。
强制清理缓存重新部署
缓存残留可能导致旧配置生效，执行强制部署命令：
```
firebase deploy --only hosting --force
```
验证本地资源可用性
直接在本地浏览器打开build/web/index.html，确认应用能正常加载，排除代码编译或资源缺失的问题。