FirebaseInstanceId.getToken()返回null场景及令牌获取相关技术咨询

1. FirebaseInstanceId.getInstance().getToken() 何时会返回 null？ #

以下几种场景下这个方法会返回 null：

• 令牌尚未生成完成：应用首次启动时，FCM SDK 需要在后台异步向服务器请求令牌，如果在这个请求完成前调用该方法，就会拿到 null。
• 网络连接异常：设备没有可用网络时，FCM SDK 无法和服务器通信获取或刷新令牌，此时调用方法会返回 null。
• Firebase 配置错误：如果你的应用中 google-services.json 文件配置有误（比如项目 ID 不匹配、API 密钥错误），或者 FirebaseApp 没有正确初始化，SDK 无法正常获取令牌，返回 null。
• 令牌被失效/清除：当应用数据被清除、设备恢复出厂设置、应用卸载重装后，本地存储的令牌被清除，新令牌还未生成时调用方法会返回 null。
• 旧版本 SDK 兼容性问题：某些较旧版本的 Firebase SDK 存在已知 bug，可能导致该方法在特定场景下返回 null，建议保持 SDK 版本更新。

2. Firebase 推送令牌的获取来源、时机、可用性及调用特性 #

来源与生成逻辑 #

推送令牌是由Firebase Cloud Messaging (FCM) 服务器生成的：应用启动后，FCM SDK 会在后台向 FCM 服务器发送请求，服务器验证应用身份后生成唯一令牌，返回给设备并存储在本地。

获取时机 #

• 首次安装启动：应用第一次启动时，SDK 自动触发令牌请求流程，完成后将令牌存储到本地。
• 令牌失效/更新时：当令牌过期、设备信息变更（如恢复出厂设置）、应用数据被清除、FCM 服务器主动刷新令牌时，SDK 会自动重新请求新的令牌。

何时可用 #

令牌真正可用的标志是 onNewToken 回调（FirebaseMessagingService 中的方法）被触发，此时本地已经存储了有效的令牌。如果你在回调触发前调用 getToken()，很大概率会拿到 null。

调用是否为同步请求服务器？ #

旧版本的 getToken() 是同步方法，但它并不会主动向服务器请求令牌——它只是读取本地已经存储的令牌。如果本地没有令牌（还没生成或被清除），就直接返回 null，不会触发网络请求。现在 Firebase 官方更推荐使用异步方式获取令牌，比如：

FirebaseInstanceId.getInstance().getInstanceId()
    .addOnCompleteListener(new OnCompleteListener<InstanceIdResult>() {
        @Override
        public void onComplete(@NonNull Task<InstanceIdResult> task) {
            if (!task.isSuccessful()) {
                Log.w(TAG, "getInstanceId failed", task.getException());
                return;
            }
            // 获取新令牌
            String token = task.getResult().getToken();
            // 使用令牌
        }
    });

这种异步方式会在令牌未生成时等待请求完成，再返回结果。

生命周期过早调用的问题 #

是的，如果在应用生命周期过早调用（比如在 Application.onCreate() 的最开始、或者启动页的 onCreate() 初期），此时 FCM SDK 还没完成初始化，令牌请求也还在后台进行，调用 getToken() 很大概率会返回 null。建议在 onNewToken 回调中处理令牌逻辑，或者使用异步获取的方式确保拿到有效令牌。

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