Flutter iOS Release模式下Unrecognized Selector异常致应用崩溃

这个崩溃的核心原因是NSNull实例被调用了属于Firestore对象（如DocumentReference/CollectionReference）的addSnapshotListenerWithIncludeMetadataChanges:listener:方法，仅在Release模式触发，通常和编译优化、空值处理疏漏、SDK兼容性有关。以下是针对性修复建议：

1. 严格检查Firestore对象的空值处理 #

• 排查所有调用addSnapshotListener的代码，杜绝空对象调用：
  • 避免使用Dart空安全的!强制解包，改用空判断确保对象有效：

    final DocumentReference? docRef = FirebaseFirestore.instance.collection('users').doc(userId);
    if (docRef != null) {
      docRef.addSnapshotListener((snapshot, error) {
        // 业务逻辑处理
      });
    }
    

  • 检查通过路径参数构建的Firestore引用，确保路径参数（如文档ID、集合名）不为空，避免生成无效的null引用。

2. 调整Release模式的编译优化配置 #

• 针对Firestore禁用可能导致方法丢失的编译优化：
  在ios/Podfile的post_install块中添加配置：

  post_install do |installer|
    installer.pods_project.targets.each do |target|
      flutter_additional_ios_build_settings(target)
      if target.name == 'FirebaseFirestore'
        target.build_configurations.each do |config|
          # 关闭死代码消除，防止Firestore方法被误删
          config.build_settings['DEAD_CODE_STRIPPING'] = 'NO'
          # 确保Objective-C方法不被混淆
          config.build_settings['OTHER_CFLAGS'] ||= ['$(inherited)', '-fobjc-arc']
        end
      end
    end
  end
  

• 执行cd ios && pod install更新配置后重新打包测试。

3. 验证Firebase SDK版本兼容性 #

• 确保Flutter端插件与iOS原生SDK版本匹配：
  1. 更新pubspec.yaml中的Firebase依赖到最新稳定版：

     dependencies:
       firebase_core: ^2.24.2
       cloud_firestore: ^4.13.1
     

  2. 执行flutter pub upgrade同步Dart依赖，再运行cd ios && pod install --repo-update同步原生SDK。

4. 开启Release模式调试定位问题 #

• 在Xcode中切换到Release配置，精准定位崩溃代码：
  1. 打开Xcode → 顶部菜单栏Product → Scheme → Edit Scheme
  2. 在Run选项卡的Build Configuration选择Release
  3. 连接真机运行APP，触发崩溃后查看Xcode调用栈，找到对应的Dart或原生代码位置，锁定问题源头。

5. 检查Firestore离线缓存配置 #

• 显式配置Firestore持久化，避免Release模式下默认行为差异：

  void initFirestore() async {
    await Firebase.initializeApp();
    FirebaseFirestore.instance.settings = const Settings(
      persistenceEnabled: true,
      cacheSizeBytes: Settings.CACHE_SIZE_UNLIMITED,
    );
  }
  

• 测试前清除APP缓存数据，排除缓存损坏导致的异常。

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