使用FCM调用FirebaseInstanceId.getToken()偶现返回null问题求助

我来帮你梳理下FCM Token偶尔为null的常见原因和解决方案，这些都是实际开发中踩过的坑，应该能帮到你：

1. 换掉旧的同步API，改用异步获取方式 #

你现在用的FirebaseInstanceId.getInstance().getToken()是旧版的同步方法，最大的问题是如果Firebase还没完成初始化就调用，直接会返回null。Firebase官方早就推荐使用异步的新API了，代码示例如下：

FirebaseMessaging.getInstance().getToken()
    .addOnCompleteListener(new OnCompleteListener<String>() {
        @Override
        public void onComplete(@NonNull Task<String> task) {
            if (!task.isSuccessful()) {
                Log.w("FCM_TOKEN", "获取Token失败", task.getException());
                return;
            }
            // 成功获取到Token
            String token = task.getResult();
            // 在这里把Token上传到你的服务器或者做其他处理
        }
    });

这个异步方法会等Firebase初始化完成后再返回结果，能避免大部分时机不对导致的null问题。

2. 确保Firebase初始化时机正确 #

不要在Activity的onCreate()里过早调用获取Token的方法（比如启动页刚打开时），最好在自定义的Application类的onCreate()中初始化Firebase，再触发Token获取：

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化Firebase
        FirebaseApp.initializeApp(this);
        // 在这里启动Token获取的异步任务，或者在需要的业务时机调用
    }
}

记得在AndroidManifest.xml里配置这个Application类：

<application
    android:name=".MyApplication"
    ...>
    ...
</application>

3. 检查Google Play服务状态 #

FCM完全依赖Google Play服务，如果设备上的Google Play服务版本过低、未安装或者异常，肯定拿不到Token。你可以在代码里加个检查：

int resultCode = GoogleApiAvailability.getInstance().isGooglePlayServicesAvailable(context);
if (resultCode != ConnectionResult.SUCCESS) {
    // 提示用户更新或安装Google Play服务
    if (GoogleApiAvailability.getInstance().isUserResolvableError(resultCode)) {
        GoogleApiAvailability.getInstance().getErrorDialog(activity, resultCode, 9000).show();
    }
}

测试时尽量用带Google服务的真机，或者用Google APIs的模拟器镜像，不要用纯Android的模拟器。

4. 核对Firebase项目配置 #

• 确认google-services.json文件已经正确放在app模块的根目录，文件里的包名和你应用的包名完全一致。
• 检查build.gradle的依赖配置：
  项目级build.gradle：

  dependencies {
      classpath 'com.google.gms:google-services:4.3.15' // 用最新版本
      ...
  }
  

  app级build.gradle：

  implementation 'com.google.firebase:firebase-messaging:23.0.0' // 最新版本
  ...
  apply plugin: 'com.google.gms.google-services' // 放在文件末尾
  

5. 监听Token刷新事件 #

FCM Token会在很多场景下自动刷新（比如应用卸载重装、设备恢复出厂、Google账号变更等），所以不能只在启动时获取一次。你需要自定义一个FirebaseMessagingService来监听刷新：

public class MyFirebaseMessagingService extends FirebaseMessagingService {
    private static final String TAG = "FCM_SERVICE";

    @Override
    public void onNewToken(String token) {
        super.onNewToken(token);
        Log.d(TAG, "刷新后的Token: " + token);
        // 这里把新Token上传到服务器，覆盖旧的记录
    }
}

然后在AndroidManifest.xml里注册这个服务：

<service
    android:name=".MyFirebaseMessagingService"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

6. 检查网络和权限 #

• 确保应用有网络权限：<uses-permission android:name="android.permission.INTERNET" />，获取Token需要联网请求Google服务器。
• 如果设备处于离线状态，获取Token的请求会失败返回null，所以要保证设备网络正常。

总的来说，换成异步API是解决大部分Token为null问题的关键，再结合上面的其他排查点，应该就能解决你的问题了。

内容的提问来源于stack exchange，提问作者Charmi Manthan Desai