执行flutterfire configure时遭遇Null转String类型转换错误

问题场景 #

在Flutter项目中执行firebase login登录后，通过flutterfire configure命令生成firebase_options.dart以连接Firebase环境，完成平台选择、包名配置后触发类型转换错误；同时执行flutter clean后运行flutter pub get时出现权限拒绝错误，需用sudo执行。

当前环境 #

• Firebase包版本：13.31.1
• Flutterfire包版本：1.0.1

已尝试操作 #

• 将Flutterfire降级至1.0.0、2.6版本，问题未解决但获取到详细错误栈
• 重新安装Firebase和Flutterfire CLI
• 重建项目
• 使用sudo执行命令

命令执行输出 #

i Found 5 Firebase projects.
✔ Select a Firebase project to configure your Flutter application with · bilgi-quiz (Bilgi)
✔ Which platforms should your configuration support (use arrow keys & space to select)? · android, ios, macos, web, windows
✔ Which Android application id (or package name) do you want to use for this configuration, e.g. 'com.example.app'? · com.bilgi.app
i Firebase android app com.bilgi.app registered.
i Firebase ios app com.example.bilgi registered.
i Firebase macos app com.example.bilgi registered.
i Firebase web app bilgi (web) registered.
type 'Null' is not a subtype of type 'String' in type cast

详细错误栈 #

type 'Null' is not a subtype of type 'String' in type cast
#0      new FirebaseOptions.fromMap (package:flutterfire_cli/src/firebase/firebase_options.dart:54:32)
#1      FirebaseWebOptions.forFlutterApp (package:flutterfire_cli/src/firebase/firebase_web_options.dart:57:28)
<asynchronous suspension>
#2      ConfigCommand.run (package:flutterfire_cli/src/commands/config.dart:433:20)
<asynchronous suspension>
#3      CommandRunner.runCommand (package:args/command_runner.dart:212:13)
<asynchronous suspension>
#4      main (file:///Users/marcelhofmann/.pub-cache/hosted/pub.dev/flutterfire_cli-0.2.7/bin/flutterfire.dart:57:5)
<asynchronous suspension>

解决思路 #

1. 优先修复项目权限问题 #

权限错误是核心隐患，会引发后续一系列异常，先处理：

• 更改项目目录及文件所有权：

  sudo chown -R $USER:$GROUP /path/to/your/flutter/project
  

• 修复文件权限：

  chmod -R 755 /path/to/your/flutter/project
  

• 禁止使用sudo执行Flutter相关命令，避免文件所有权变更导致的循环权限问题。

2. 解决Flutterfire Configure类型转换错误 #

从错误栈看，问题出在Web应用配置的空值转换，可尝试以下方案：

• 升级Flutterfire CLI到最新稳定版：
  当前使用的flutterfire_cli-0.2.7版本较旧，存在已知bug，执行升级：

  dart pub global activate flutterfire_cli
  

• 检查并补充Firebase Web应用配置：
  1. 登录Firebase控制台进入对应项目
  2. 找到Web应用bilgi (web)的设置页面
  3. 核对"SDK设置和配置"中的所有字段，确保apiKey、authDomain、projectId等核心配置项无空值
• 手动生成firebase_options.dart：
  若CLI问题仍未解决，可手动创建文件：
  参考官方格式，从Firebase控制台获取各平台配置参数，示例代码：

  import 'package:firebase_core/firebase_core.dart';
  import 'package:flutter/foundation.dart';
  
  class DefaultFirebaseOptions {
    static FirebaseOptions get currentPlatform {
      if (kIsWeb) {
        return web;
      }
      // 补充Android、iOS等其他平台配置
      throw UnsupportedError('Unsupported platform');
    }
  
    static const FirebaseOptions web = FirebaseOptions(
      apiKey: '你的Web应用API Key',
      authDomain: '你的Auth Domain',
      projectId: '你的项目ID',
      storageBucket: '你的存储桶地址',
      messagingSenderId: '你的消息发送者ID',
      appId: '你的Web应用ID',
    );
  }
  

3. 版本兼容性核对 #

确保firebase_core包与Flutterfire CLI版本匹配，避免版本差异引发的兼容性bug。

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