React Native Firebase Analytics：调试打印与日志级别设置方法咨询

1. 核心思路 #

通过封装Firebase Analytics的logEvent方法，同时实现调试日志打印和日志级别附加的需求——既不改动原生Analytics的上报逻辑，又能扩展出日志工具的特性。

2. 具体实现代码 #

创建一个自定义的Analytics工具文件（比如utils/analytics.js）：

import analytics from '@react-native-firebase/analytics';

// 封装带日志级别的事件上报方法
export const logAnalyticsEvent = async (eventName, params = {}, level = 'log') => {
  // 校验日志级别合法性
  const validLevels = ['log', 'debug', 'warning', 'error'];
  const finalLevel = validLevels.includes(level) ? level : 'log';

  // 合并日志级别到事件参数（符合Firebase参数命名规范）
  const eventParams = {
    ...params,
    log_level: finalLevel,
  };

  // 调用Firebase Analytics原生上报方法
  try {
    await analytics().logEvent(eventName, eventParams);
  } catch (err) {
    console.error('Analytics上报失败:', err);
  }

  // 开发环境下打印日志到终端
  if (__DEV__) {
    const logMessage = `[Analytics ${finalLevel.toUpperCase()}] ${eventName}: ${JSON.stringify(eventParams)}`;
    // 根据级别调用对应console方法
    switch (finalLevel) {
      case 'debug':
        console.debug(logMessage);
        break;
      case 'warning':
        console.warn(logMessage);
        break;
      case 'error':
        console.error(logMessage);
        break;
      default:
        console.log(logMessage);
    }
  }
};

3. 使用方式 #

在项目任意组件/工具中导入并调用：

import { logAnalyticsEvent } from '../utils/analytics';

// 示例1：普通日志级别事件
logAnalyticsEvent('user_view_profile', { user_id: '12345' });

// 示例2：调试级别事件
logAnalyticsEvent('api_request', { endpoint: '/user/data', duration: 200 }, 'debug');

// 示例3：错误级别事件
logAnalyticsEvent('payment_failed', { order_id: '67890', error_msg: '超时' }, 'error');

4. 注意事项 #

• 生产环境自动屏蔽打印：通过__DEV__变量判断，只有开发模式下才会在终端输出日志，避免生产环境性能损耗。
• 参数命名规范：Firebase Analytics对事件参数名有要求（只能包含字母、数字、下划线，不能以数字开头），所以用log_level作为级别字段是合规的。
• 异常处理：封装时加入了try-catch，避免上报失败导致业务代码报错。

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