本文旨在解决在使用 Firebase Cloud Messaging (FCM) 推送通知时，如何有效验证和清理失效的 FCM Token。通过批量验证 Token 的有效性，并结合数据库管理，确保推送消息能够准确送达目标用户，避免资源浪费，提高推送效率。
在使用 FCM 推送通知时，一个常见的挑战是设备上的应用可能被卸载，或者用户手动取消了通知权限，导致存储在数据库中的 FCM Token 失效。然而，服务端无法直接感知这些变化，继续向这些失效 Token 发送消息会导致资源浪费，并可能影响应用的声誉。本文将介绍如何通过 FCM 提供的 API 验证 Token 的有效性，并清理数据库中失效的 Token，确保推送消息的有效性和准确性。
批量验证 FCM Token
FCM 提供了批量验证 Token 的功能，允许开发者一次性验证多个 Token 的有效性。这对于定期清理数据库中的失效 Token 非常有用。以下是一个使用 PHP Firebase Admin SDK 验证 Token 的示例代码：
use Kreait\Firebase\Factory;
use Kreait\Firebase\Contract\Messaging;
use Kreait\Firebase\Exception\MessagingException;
use Kreait\Firebase\Exception\FirebaseException;
class SomeController {
/** Constructor */
public function __construct() {
$factory = (new Factory)->withServiceAccount(getenv('GOOGLE_APPLICATION_CREDENTIALS'));
$this->messaging = $factory->createMessaging();
}
/**
* It validates device registration ID.
*
* @param string|string[] $token
* @return array|bool|Exception|MessagingException|FirebaseException the validation results.
*/
public function validate_fcm_token( string|array $token=[] ): bool|Exception|MessagingException|array|FirebaseException {
if ($token == null|| is_array($token) && (sizeof($token) === 0 || sizeof($token) > 500)) {return false;}
else if (is_string($token)) {$token = [ $token ];}
try {
return $this->messaging->validateRegistrationTokens($token);
} catch ( MessagingException | FirebaseException $e ) {
return $e;
}
}
}上述代码片段展示了如何使用 validateRegistrationTokens 方法来验证 FCM Token。该方法接受一个包含 Token 的数组作为参数，并返回一个包含验证结果的数组。
代码解析：
- 引入必要的命名空间： 首先，需要引入 Firebase Admin SDK 相关的命名空间，包括 Factory、Messaging、MessagingException 和 FirebaseException。
- 创建 Messaging 实例： 在构造函数中，使用 Factory 创建一个 Messaging 实例。需要配置 Firebase Service Account Credentials，可以通过环境变量 GOOGLE_APPLICATION_CREDENTIALS 来设置。
-
validate_fcm_token 方法： 该方法接收一个字符串或字符串数组作为参数，表示要验证的 FCM Token。
- 参数校验： 首先对输入参数进行校验，如果 Token 为空或者 Token 数组为空或超过 500 个，则返回 false。因为 FCM 限制每次批量验证的 Token 数量不能超过 500 个。
- 调用 validateRegistrationTokens 方法： 调用 $this->messaging->validateRegistrationTokens($token) 方法来验证 Token 的有效性。
- 异常处理： 使用 try-catch 块捕获可能抛出的 MessagingException 或 FirebaseException 异常，并返回异常对象。
- 返回结果： 如果验证成功，则返回验证结果数组；如果验证失败，则返回异常对象。
处理验证结果
validateRegistrationTokens 方法的返回值通常包含三个数组：valid、invalid 和 unknown。invalid 数组包含失效的 Token，可以根据这些 Token 从数据库中删除相应的记录。
注意事项：
- 批量大小限制： FCM 限制每次批量验证的 Token 数量，通常为 500 个。因此，需要将 Token 列表分割成多个批次进行验证。
- 定期执行： 建议定期执行 Token 验证和清理操作，例如每天或每周一次，以确保数据库中的 Token 保持最新状态。
- 错误处理： 在验证过程中，可能会遇到网络问题或其他异常。需要妥善处理这些异常，避免影响应用的正常运行。
总结
通过使用 FCM 提供的 Token 验证功能，可以有效地清理数据库中失效的 Token，提高推送消息的有效性和准确性。结合合理的数据库管理策略，可以确保推送服务的高效稳定运行。定期执行 Token 验证和清理操作，并妥善处理可能出现的异常，是保障 FCM 推送服务质量的关键。 建议参考 Firebase 文档 获取更多信息。
