如何为Flutter Web应用禁用Firebase Crashlytics，同时保留安卓、iOS端启用？

认知偏差澄清 #

困惑的核心来源：dart:io 中的 Platform 类没有内置isWeb静态属性，且dart:io本身不被Web平台支持，直接导入调用会直接触发Web端编译/运行错误。Flutter官方提供的跨Web平台判断常量为kIsWeb，来自package:flutter/foundation.dart，是全平台兼容的编译期常量。

核心适配逻辑 #

• 所有Crashlytics相关初始化、错误监听逻辑，全部用非Web判断包裹，确保Web端完全不加载相关代码
• 由于kIsWeb是编译期常量，Web端构建过程会通过Tree Shaking自动剔除判断分支内的不兼容代码，不会打包进Web产物，也不会触发兼容报错
• 搭配defaultTargetPlatform进一步筛选安卓、iOS平台，避免其他桌面端场景误启用Crashlytics

改造后完整可运行代码 #

// 顶部导入需要的依赖包
import 'package:flutter/foundation.dart';
// 其余原有导入保持不变

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  Widget build(BuildContext context) {
    return FutureBuilder(
      // 初始化FlutterFire
      future: Firebase.initializeApp(),
      builder: (context, snapshot) {
        // 仅在非Web平台执行Crashlytics初始化
        if (!kIsWeb) {
          // 进一步匹配安卓、iOS目标平台
          if (defaultTargetPlatform == TargetPlatform.android ||
              defaultTargetPlatform == TargetPlatform.iOS) {
            // 注册Flutter异常上报监听
            FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterError;
            // 开启Crashlytics崩溃收集能力
            FirebaseCrashlytics.instance.setCrashlyticsCollectionEnabled(true);
          }
        }

        // 初始化异常分支
        if (snapshot.hasError) {
          return SomethingWentWrong();
        }

        // 初始化完成后展示主应用
        if (snapshot.connectionState == ConnectionState.done) {
          return StreamProvider<User>.value(
            initialData: null,
            value: AuthService().user,
            child: MaterialApp(
              debugShowCheckedModeBanner: false,
              home: Wrapper(),
            ),
          );
        }

        // 初始化加载态展示
        return PouringHourGlassPageLoad();
      },
    );
  }
}

关键注意事项 #

• 禁止使用Platform.isWeb做判断，该属性不存在，会直接触发编译错误
• 不要直接导入dart:io调用Platform类判断平台，哪怕写了分支判断，也可能因为导入关系触发Web端兼容问题；使用defaultTargetPlatform（来自foundation包）做平台判断可实现全平台兼容
• kIsWeb的编译期特性会保证判断分支内的不兼容代码在Web构建时被完全裁剪，不会额外增加Web端包体积

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