Flutter部署Firebase Hosting访问报null的gCr属性读取TypeError

报错本质 #

这是Flutter Web release编译混淆后的JS运行时空引用错误，部署全流程无报错仅说明构建、上传环节未触发显性校验失败，问题出在运行时资源加载、初始化逻辑或配置匹配环节，其中gCr是Firebase JS SDK混淆后的内部属性，90%以上的同场景报错都和Firebase初始化异常相关。

按优先级排查步骤 #

• 先做本地release环境复现，排除托管平台影响
  执行flutter clean && flutter build web --release生成正式构建产物，在build/web目录下启动本地静态服务（比如执行python -m http.server 8080），通过本地地址访问测试：
  • 本地release环境就复现报错：问题出在代码逻辑、依赖兼容或构建配置，和Firebase Hosting无关
  • 本地release访问正常、仅部署到Firebase Hosting后报错：问题出在Hosting配置、缓存或资源重写规则
• 定位报错对应源码位置
  执行带source map的构建命令flutter build web --release --source-maps，将产物部署后打开浏览器开发者工具，点击报错调用栈的对应行，借助source map直接映射到未混淆的Dart源码位置，精准定位空值对象的来源。
• 核对Firebase相关逻辑与配置
  优先检查初始化顺序、依赖版本、Hosting缓存/重写规则三类高频问题点。

高频可行解决方案 #

• 修正Firebase初始化顺序
  禁止在main函数中不等待Firebase初始化完成就直接启动App，错误写法如下：

  void main() {
    // 错误：异步初始化未执行完成就启动应用，运行时拿不到Firebase实例
    Firebase.initializeApp();
    runApp(const MyApp());
  }
  

  替换为强制等待初始化完成的标准写法：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    runApp(const MyApp());
  }
  

• 修正Firebase Hosting配置
  打开项目根目录firebase.json，核对hosting节点的公共目录、重写规则、缓存策略，避免旧JS缓存、路由重写错误导致资源加载不全，参考正确配置：

  {
    "hosting": {
      "public": "build/web",
      "ignore": [
        "firebase.json",
        "**/.*",
        "**/node_modules/**"
      ],
      "rewrites": [
        {
          "source": "**",
          "destination": "/index.html"
        }
      ],
      "headers": [
        {
          "source": "/index.html",
          "headers": [
            {
              "key": "Cache-Control",
              "value": "no-cache"
            }
          ]
        },
        {
          "source": "**/*.@(js|css|png|jpg|svg|gif|woff|woff2|ttf)",
          "headers": [
            {
              "key": "Cache-Control",
              "value": "max-age=31536000, immutable"
            }
          ]
        }
      ]
    }
  }
  

  配置修改后重新执行部署命令，部署完成后用硬刷新（Ctrl+Shift+R/Command+Shift+R）清空浏览器旧缓存再访问。
• 统一Firebase依赖版本
  执行flutter pub deps检查所有Firebase系列插件的版本，禁止跨大版本混用（比如firebase_core用2.x稳定版、其他Firebase插件停留在1.x版本），将所有Firebase相关插件升级到适配当前Flutter SDK版本的空安全稳定版，升级后执行flutter clean清除旧构建缓存再重新构建部署。
• 排查构建混淆误删问题
  如果构建时加了--obfuscate代码混淆参数，先移除该参数重新构建测试，部分场景下Flutter Web的tree-shaking机制会误删Firebase JS SDK的关联方法，导致运行时读取属性时空指针。

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