如何在Flutter应用中使用Cloud Logging并关联Firebase

Google Cloud Logging与Firebase同属Google生态，只要你的Firebase项目绑定了对应Google Cloud项目，两者的日志服务天然打通，不需要复杂的跨服务关联配置，接入流程如下：

1. 前置准备 #

• 你的Flutter项目已完成Firebase核心服务接入，firebase_core依赖已添加且完成初始化
• 进入Firebase控制台对应项目的「项目设置」页，确认项目已绑定Google Cloud项目（默认Firebase创建的项目会自动绑定同名GCP项目，Cloud Logging默认启用）

2. 依赖安装 #

在项目pubspec.yaml中添加如下依赖：

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^2.24.0
  firebase_crashlytics: ^3.4.0
  logging: ^1.2.0 # 可选，用来统一管理Dart侧日志等级、输出格式

执行flutter pub get完成依赖安装。

3. 日志上传配置 #

通过Firebase Crashlytics上传的日志会自动同步到绑定GCP项目的Cloud Logging中，不需要单独配置Cloud Logging的鉴权信息，鉴权逻辑由Firebase SDK自动处理。

3.1 基础日志上传实现 #

import 'package:firebase_crashlytics/firebase_crashlytics.dart';
import 'package:logging/logging.dart';
import 'package:flutter/foundation.dart';

// 初始化全局日志配置
void initLogger() {
  // 配置全局日志输出等级
  Logger.root.level = kDebugMode ? Level.ALL : Level.INFO;
  // 监听日志事件
  Logger.root.onRecord.listen((logRecord) {
    // 调试阶段本地打印日志
    if (kDebugMode) {
      print('[${logRecord.level.name}] ${logRecord.time} ${logRecord.loggerName}: ${logRecord.message}');
    }
    // 上传日志到Firebase，自动同步到Cloud Logging
    FirebaseCrashlytics.instance.log('[${logRecord.level.name}] ${logRecord.message}');
    // 错误级日志额外上报栈信息
    if (logRecord.level >= Level.SEVERE && logRecord.error != null) {
      FirebaseCrashlytics.instance.recordError(
        logRecord.error,
        logRecord.stackTrace,
        reason: logRecord.message,
      );
    }
  });
}

// 业务代码中使用日志示例
final logger = Logger('UserModule');
void login() {
  logger.info('用户发起登录请求');
  try {
    // 登录逻辑
  } catch(e, s) {
    logger.severe('登录失败', e, s);
  }
}

3.2 自定义日志元数据 #

如果需要给日志添加额外的业务维度信息，可以通过Crashlytics的自定义属性接口配置，元数据会随日志同步到Cloud Logging：

// 绑定用户ID
FirebaseCrashlytics.instance.setUserIdentifier('user_001');
// 绑定自定义业务属性
FirebaseCrashlytics.instance.setCustomKey('app_version', '2.1.0');
FirebaseCrashlytics.instance.setCustomKey('channel', 'huawei_store');

4. Cloud Logging日志查询 #

进入Google Cloud控制台的Cloud Logging页面，选择对应Firebase绑定的项目，过滤条件选择resource.type="firebase_project"即可查看所有同步过来的日志，也可根据日志级别、时间范围、自定义关键字做筛选。

注意事项 #

• 生产环境建议关闭DEBUG级日志上传，避免占用Cloud Logging配额产生额外费用
• 大体积的二进制日志、敏感信息不要直接上传到日志服务
• 若需要脱离Firebase单独上传日志到Cloud Logging，可通过googleapis包配合服务账号鉴权实现，该方案需要自行管理密钥安全，不推荐移动端使用。

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