Flutter应用集成Firebase动态链接遇日志报错：需添加Firebase Analytics依赖以启用动态链接事件日志

你遇到的这个报错本质是Firebase动态链接的事件日志功能依赖于Firebase Analytics——哪怕你的应用没有集成认证功能，只要动态链接需要记录事件（比如链接被打开的统计），就必须引入Analytics依赖。别担心，添加Analytics非常简单，而且它和认证功能完全独立，不会影响你现有代码的逻辑。

解决方案步骤： #

1. 添加Firebase Analytics依赖到pubspec.yaml #

在项目根目录的pubspec.yaml文件中，找到dependencies区块，新增Analytics的依赖：

dependencies:
  flutter:
    sdk: flutter
  firebase_dynamic_links: ^你的当前版本号
  firebase_analytics: ^最新版本号 # 新增这一行

你可以直接运行flutter pub add firebase_analytics命令，让系统自动添加最新版本的依赖，避免手动填写版本号的麻烦。

2. 安装依赖并完成基础配置 #

运行flutter pub get安装依赖。因为你已经能正常创建动态链接，说明Firebase的基础配置（Android的google-services.json、iOS的GoogleService-Info.plist）已经完成，不需要额外修改配置文件。

如果想主动初始化Analytics，可以在应用入口添加如下代码（不主动初始化也能解决报错，Firebase会自动完成基础初始化）：

import 'package:firebase_analytics/firebase_analytics.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  // 初始化Analytics实例
  FirebaseAnalytics analytics = FirebaseAnalytics.instance;
  runApp(const MyApp());
}

3. 验证效果 #

重新运行应用后，之前的FDL logging failed报错就会消失。你写的initDynamicLink监听逻辑完全不需要修改，依然可以正常处理动态链接的页面跳转。

额外说明： #

目前Firebase动态链接的日志模块和Analytics是绑定的，没有单独关闭日志的开关。所以添加Analytics是解决这个报错最直接有效的方式——而且它的体积很小，不会给应用带来额外负担，也不需要你集成任何认证相关的功能。

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