排查工具
移动推送文档中心入门中心API 中心SDK 中心文档活动我的反馈文档反馈官招募中，报名立赚积分兑换代金券！> HOT文档中心>移动推送>操作指南>推送管理>排查工具排查工具最近更新时间：2025-03-19 10:14:52
微信扫一扫QQ新浪微博复制链接链接复制成功我的收藏本页目录：简介常见场景操作步骤通过用户账号查询通过 Token 直接查询推送查询常见问题设备查询常见问题推送常见问题简介当您在推送消息时出现异常情况（例如推送消息收不到或推送失败）时，可通过排查工具进行自助排查以及通过账号或者 Token 查询设备详情、设备绑定的账号以及设备绑定的标签。常见场景1. 开发人员在控制台推送一条消息给测试设备，控制台推送状态显示成功，但在手机通知栏未看到这条消息，通过 Token 查询设备详情发现通知栏权限关闭，在手机上开启通知栏权限后，再次触发注册，此时往这台设备发送消息，手机通知栏成功展示。
2. 运营人员通过用户账号推送消息，推送状态显示“推送失败”，在排查工具中输入用户账号及绑定的账号类型查询 Token，发现该应用下，此账号没有关联的设备 Token，可联系开发人员排查是否调用了 账号绑定（Android）或 账号绑定（iOS）接口。
3. 开发人员完成了移动推送的接入工作后，对某一批设备 Token 推送消息，线上用户反馈没有收到该推送信息，获取该用户 Token 和 pushID 后，在推送排查得知，推送列表中并无该 Token。
操作步骤通过用户账号查询1. 登录 移动推送控制台。2. 在左侧导航栏选择App推送管理>排查工具。3. 单击下拉框选择您需要查询产品及应用，选择通过账号查询。
4. 输入用户账号，单击查询。5. 选择账号下关联的设备 Token 查看设备注册详情。说明账号：与 Token 绑定的用户唯一 ID，一般为 OpenID、UID 等。Token 列表展示规则：Token 按与账号绑定时间的倒序展示，本页面最多展示10个 Token，推送目标设置为账号推送时，系统默认推送给最近一次绑定该账号的设备 ，例如需要更改为推送给所有绑定该账号的设备，请在 控制台 或 API 推送时更改设置。通过 Token 直接查询1. 在排查工具页面，选择通过 Token 直接查询。2. 输入设备 Token，单击查询，页面右侧会显示当前设备注册详情。说明Token：移动推送分配给每一个设备的唯一ID，长度36位。若您不知道如何获取设备 Token，可参考 SDK 集成文档中的 获取 Token 交互建议（Android）或 获取 Token 交互建议（iOS）。推送查询1. 在排查工具页面，单击推送查询。
2. 输入 pushid（必选）、待查询的设备 Token（必选），单击查询，查看排查结果。说明pushid 获取方式：1. 可在左侧导航栏选择 App 推送管理 > 推送任务，获取需要查询的 PushID。2. 在推送接口的应答参数中获取。3. 在 App 推送管理 > 推送任务，更换 管理台创建>API创建 及可查看到API推送数据
4. 若查询结果与实际情况不符或仍无法解决问题，可查看 推送常见问题 或联系 在线客服，并补充 pushID 和 Token 信息。常见问题设备查询常见问题1. 设备 Token 什么情况下会失效？Token 有效期为90天，若设备连续90天未连接移动推送服务器，则会被标记为无效设备。若设备卸载了 App，当前 Token 会被标记为无效。2. 通知栏权限已经开启，为什么设备查询显示关闭状态？
若手机通知栏设置从关闭到开启权限，需要在客户端重新触发一次注册请求，才可以把开启状态同步到移动推送服务器。推送常见问题1. 通过账号或者标签推送无法收到，但通过 Token 推送可以收到，是什么原因？
在设备注册详情页中查看该 Token 是否关联了推送的目标账号或者标签，若未关联则无法通过账号或标签推送。2. 推送状态显示已完成，设备状态正常，为什么手机没有收到推送？iOS 平台推送环境是否与 Token 注册环境一致，不一致则无法收到推送，推送环境选择说明详情可参考文档 推送环境选择。检查 App 包名是否和移动推送控制台 > App推送管理 > 基础配置中填写的包名一致，如果包名不一致检查是否开启 多包名推送功能。若前台收不到，检查 show_type 字段传的值是否为1，如果是前台接受通知时不展示。安卓 P 及以上系统需要添加使用 Apache HTTP client 库，检查在 AndroidManifest 的 application 节点内是否有添加以下配置：