美洽App收不到推送

美洽App收不到推送通常由手机通知权限被关闭、系统省电或后台限制、网络不稳定、厂商推送通道异常或应用/服务端配置问题引起。先从手机端检查通知、应用消息开关、网络与省电设置，再看应用是否被系统锁定、是否使用了第三方推送或厂商推送、推送证书/SDK是否过期或配置错误。排查时按用户→设备厂商→开发者三层次走，收集日志和出现时间、机型、系统版本后联系美洽技术支持会更快定位。请

先把事情讲清楚：推送是怎么工作的（简短易懂）

想象一下推送就是邮局送信。美洽那边把消息交给推送服务（像苹果的APNs、谷歌的FCM或手机厂商的推送平台），这些平台负责把消息从服务器送到手机。手机再由系统通知管理，把信展示给用户。如果任何一环断了，信就收不到。

关键角色一览

• 美洽服务端：产生消息并发起推送请求，负责格式、目标设备token、消息内容。
• 推送通道：APNs/FCM/厂商推送（华为、小米、OPPO、Vivo等），负责实际投递。
• 手机系统：控制通知权限、渠道、后台行为、休眠与省电策略。
• 美洽客户端（App）：接收并展示通知，或在收到透传消息后触发本地通知或更新界面。

常见原因（从最常见到少见）

• 手机通知被关闭：用户在系统或应用内把通知、横幅或声音关掉。
• 应用内消息或会话开关关掉：美洽App内某些类型消息可以单独关闭。
• 网络问题：无网络或网络不稳定，尤其是移动网络切换或被运营商限制。
• 系统省电/后台限制：安卓厂商会在后台深度清理应用，阻止接收推送或唤醒。
• 厂商推送配置问题：如小米/Huawei/OPPO等需要在各自平台配置AppID/Key，若配置错或证书失效会投递失败。
• 证书/密钥或SDK问题：APNs证书、FCM密钥或美洽集成的SDK版本过旧或配置错误。
• 设备token失效或未上报：客户端没有正确上报最新token/registration id到美洽服务器。
• 通知渠道重要性设置：Android 8+的Notification Channel被设置为低优先级或静默。
• Do Not Disturb或免打扰：系统免打扰、勿扰模式会屏蔽声音与横幅。
• 服务端消息队列堆积或失败：消息在美洽服务端异常、第三方推送返回错误。

用户端快速排查（最先做的五步）

这是普通用户能做且能快速验证的步骤，按顺序做可以先排除大多数问题。

• 确认系统通知权限：进入手机“设置 → 应用 → 美洽 → 通知”，确保允许全部或至少重要通知。
• 检查美洽App内消息设置：打开美洽，找“设置/消息/通知”相关开关，确认未被关闭。
• 关闭省电与后台限制：关闭省电模式、设置允许美洽自启动、后台保活或白名单（厂商会把这些选项放在不同位置）。
• 测试网络与重启：切换Wi‑Fi/移动数据，或重启手机并打开App一次，观察是否恢复。
• 检查勿扰模式与通知声音：确认系统不在勿扰、并且通知通道设置有声音或横幅。

不同平台与厂商的特殊注意事项

Android（通用要点）

• 确认Android版本及通知渠道（Channel）设置：长按通知或在应用信息里检查Channel的重要性。
• 允许「后台运行」和「自启动」：很多机型默认禁止，导致应用无法接收通过某些机制唤醒的消息。
• 检查应用是否被系统“冻结”或被第三方安全软件优化导致唤醒被阻止。

华为（EMUI）

• 在“电池 → 启动管理”里手动允许应用的自动管理或手动开启自启。
• 使用华为推送服务（HMS）时，确保在华为开发者控制台配置正确的包名、证书和应用ID。

小米（MIUI）

• 在“权限 → 自启动”允许美洽自启动，并在“电池与性能 → 应用耗电管理”里选为“无限制”。
• MIUI系统有“通知管理”与“通知显示优先级”可分别控制。

OPPO / Vivo / Realme 等

• 同样关注“后台管理/自启动/省电模式”，有些机型在锁屏后会强制冻结应用。

开发者 / 运维的深入排查（需要日志与后台检查）

如果你是开发者或能配合开发人员，这里是有价值的排查步骤，按顺序执行。

1) 确认设备token/registration id

• 在客户端打印并上传token到美洽服务器后，验证服务端拿到的token是否为最新。
• 若token频繁变化或为空，排查SDK初始化流程、网络权限以及token回调是否被捕获。

2) 检查服务端推送请求返回结果

推送平台通常会返回错误码：例如APNs的403/400/410，FCM的InvalidRegistration、NotRegistered，厂商推送也有对应返回。把返回日志导出，按错误码处理。

3) 验证证书/密钥与环境

• iOS：确认APNs证书或Key未过期，区分生产/测试环境，使用正确证书推生产Token。
• Android：确认FCM Server Key、Sender ID正确；若使用厂商推送，检查对应平台控制台配置。

4) SDK版本与兼容性

确认美洽SDK是否为最新稳定版，老版SDK可能对新系统做法支持不完整或遗漏厂商推送的兼容接入。

5) 消息格式与通知类型

• 区分“通知（system notification）”与“透传（data/quiet message）”——透传需App在后台能运行并处理才能触发本地通知。
• 对于透传消息，若被系统杀死或限制，可能无法触发。

6) 模拟与测试

• 使用设备调试日志（Android用logcat，iOS用Console/设备日志）查看SDK注册、token获取和接收日志。
• 在美洽后台或测试脚本直接向推送平台发送单条消息，观察返回与投递情况。

排查时需要收集哪些信息（联系支持前准备）

把下面这些信息准备齐，会大幅缩短问题定位时间：

• 出现问题的时间点（精确到分钟）和持续时段
• 设备品牌、型号、系统版本（比如 Android 11 / EMUI 10）
• 美洽App版本与SDK版本
• 是否使用厂商推送（华为/小米等），以及对应平台配置截图或ID
• 服务端发送时的返回日志与错误码
• 客户端日志（获取token、推送到来或丢失时的logcat/iOS Console）

工作流式的详细排查步骤（建议给技术同学）

1. 确认美洽服务端曾尝试推送到该设备，并导出该请求与推送平台返回值。
2. 核对设备端token是否与服务端记录一致；若不同，查找客户端上报token失败原因。
3. 检查推送平台返回错误：按错误码采取修复措施（证书更新、token失效处理、重试策略）。
4. 复现：在开发环境用相同token直接调用对应推送平台发送测试消息，观察结果。
5. 在设备上启用详细日志，监听SDK初始化、token生成、消息接收流程。
6. 对比不同网络、不同系统状态（屏幕锁/解锁、后台/前台）下的行为差异。

一个实用的检查表（给运维/客服用）

一些容易忽视的小细节

• Android上的“通知重要性/Channel”静默会让用户以为没收到消息，实际是被静默显示。
• 同一账号在多台设备同时登录时，可能因为token覆盖或路由规则导致某台设备不再接收。
• App在安装后第一次启动没有及时进行权限请求或注册推送，导致未上传token。
• 厂商系统升级后，原有的白名单或自启动授权可能会被重置。

如果一切都检查过还没解决，怎么和美洽技术支持对接

把上面“需要收集的信息”打包发给支持，并描述你已经做过的排查步骤和初步结果。优秀的工单内容示例包括：

• 问题概述：xxx机型，Android 11，App 1.2.3，自6月1日起不稳定
• 复现步骤：打开App→锁屏→等待消息到达（无）
• 日志与返回：附上服务端推送请求ID、推送平台返回码、客户端log截取
• 测试账号与设备信息：便于支持方重现和定位

常见误区（别走这些弯路）

• 认为“通知权限开了就一定能收到”——权限是必要但不充分条件。
• 把所有问题归咎于美洽服务端——很多是设备或厂商策略导致。
• 频繁清缓存或重新安装App不一定能解决token/配置层面的问题。

最后一点经验（比较实用的建议）

遇到推送问题，优先做三件事：收集证据（日志、时间、机型）、区分是否普遍性问题（是否只有某型号/系统）和按用户→系统→服务端三个层面系统化排查。很多时候只是某个省电策略或通知渠道被误设置，稍微调整就能恢复。

如果你愿意，我可以按你的设备品牌和系统版本给出更精确的操作路径，或者帮你把要发给美洽支持的工单内容草拟好，省得来回折腾。