Android Azure Chat SDK推送通知无法获取有效数据及解析异常问题

一、解决payload乱码&无法提取消息内容的问题 #

Azure Chat发送的推送payload为加密格式，不能直接读取remoteMessage.data字段，必须通过SDK提供的解密流程处理：

1. 确保已正确初始化Chat SDK推送组件，持有当前聊天用户的有效访问令牌
2. 修改onMessageReceived处理逻辑，先解密再解析内容：

override fun onMessageReceived(remoteMessage: RemoteMessage) {
    super.onMessageReceived(remoteMessage)
    if (remoteMessage.data.isNotEmpty()) {
        try {
            // 用SDK解密工具处理加密payload
            val decryptedPayload = ChatPushNotificationDecryptor.decrypt(
                remoteMessage.data,
                userAccessToken // 当前用户的Chat访问令牌
            )
            // 从解密后的payload中提取所需字段
            val messageContent = decryptedPayload["message"]
            val senderDisplayName = decryptedPayload["senderDisplayName"]
            val senderId = decryptedPayload["senderId"]
            
            val chatPushNotification = ChatPushNotification().setPayload(decryptedPayload)
            notificationManager.azureChatNotificationReceived(
                "来自${senderDisplayName}的新消息",
                messageContent ?: "你收到了一条新消息",
                chatPushNotification
            )
        } catch (e: Exception) {
            Log.e("PushError", "解密推送负载失败: ${e.message}")
        }
    }
}

3. 确认项目依赖的Azure Chat SDK为最新版本，避免版本兼容问题

二、配置Azure Chat新消息的推送格式 #

登录Azure门户，按以下步骤配置：

• 进入你的Communication Services资源
• 左侧导航栏选择聊天 > 推送通知
• 选择Android平台，配置模板格式，自定义message、senderDisplayName等字段的映射规则
• 保存配置后，新聊天消息的推送将遵循你设置的格式

三、解析异常的中文翻译及解决 #

异常原文翻译：

java.lang.RuntimeException: 解析推送通知负载失败：java.lang.RuntimeException: 无效的加密推送通知负载。已丢弃请求！

常见解决方法：

• 检查传入解密方法的用户访问令牌是否有效，且属于接收推送的聊天用户
• 过滤非Azure Chat服务发送的推送消息，避免处理篡改后的payload
• 升级Azure Chat SDK至官方最新版本，适配最新加密规则
• 确认应用启动时已正确初始化Chat SDK的推送模块，配置好通信服务端点信息

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