React Native Firebase 中 Android 设备获取 FCM 令牌的解决方案

问题背景

在使用 React Native Firebase 的 messaging 模块时，开发者经常遇到 Android 设备无法获取 FCM (Firebase Cloud Messaging) 令牌的问题，而 iOS 设备却能正常获取。这个问题主要出现在 Android 13 及以上版本中，因为从 Android 13 开始，Google 引入了运行时通知权限机制。

核心问题分析

在 Android 13+ 设备上，应用需要明确请求 POST_NOTIFICATIONS 权限才能获取 FCM 令牌。传统的权限请求方式可能无法正确处理授权状态，导致即使用户授予了通知权限，应用仍然无法获取 FCM 令牌。

解决方案

以下是经过验证的有效解决方案代码：

export async function requestUserPermission() {
  let authStatus;
  if (Platform.OS === 'android') {
    try {
      const granted = await PermissionsAndroid.request(
        PermissionsAndroid.PERMISSIONS.POST_NOTIFICATIONS,
      );
      if (granted === PermissionsAndroid.RESULTS.GRANTED) {
        authStatus = messaging.AuthorizationStatus.AUTHORIZED;
      } else {
        authStatus = messaging.AuthorizationStatus.DENIED;
      }
    } catch (error) {
      console.warn('Error requesting notification permission:', error);
      authStatus = messaging.AuthorizationStatus.DENIED;
    }
  } else {
    authStatus = await messaging().requestPermission();
  }

  const enabled =
    authStatus === messaging.AuthorizationStatus.AUTHORIZED ||
    authStatus === messaging.AuthorizationStatus.PROVISIONAL;

  if (enabled) {
    GetFcmToken();
  }
}

关键改进点

1. 正确处理 Android 权限请求结果：明确检查 PermissionsAndroid.RESULTS.GRANTED 状态，而不是简单地依赖返回的授权状态。

2. 错误处理机制：添加了 try-catch 块来捕获可能出现的权限请求异常。

3. 状态映射：将 Android 的权限结果映射到与 iOS 一致的 messaging.AuthorizationStatus 枚举值，保持跨平台一致性。

4. 清晰的授权状态判断：使用明确的 AUTHORIZED 和 PROVISIONAL 状态来判断是否获取 FCM 令牌。

实现细节

1. 权限请求：对于 Android 设备，使用 PermissionsAndroid.request 方法请求 POST_NOTIFICATIONS 权限。

2. 结果处理：将 Android 的权限授予结果 (GRANTED/DENIED) 转换为 messaging 模块的授权状态枚举值。

3. 跨平台一致性：iOS 仍使用 messaging().requestPermission() 方法，保持原有逻辑不变。

4. 令牌获取：只有在确认授权状态为 AUTHORIZED 或 PROVISIONAL 时，才会调用 GetFcmToken() 函数获取 FCM 令牌。

最佳实践建议

1. 权限请求时机：应在应用启动时尽早请求通知权限，但也要考虑用户体验，可以在用户首次使用通知相关功能时再请求。

2. 权限拒绝处理：当用户拒绝权限时，应提供解释并引导用户到设置中手动开启权限。

3. 令牌缓存：获取到的 FCM 令牌应缓存在本地存储中，避免重复获取。

4. 令牌更新监听：注册 onTokenRefresh 监听器，以处理令牌更新的情况。

通过以上改进，开发者可以确保在 Android 设备上也能可靠地获取 FCM 令牌，从而实现完整的推送通知功能。