安卓监听环境搭建指南
安卓监听端负责把微信、支付宝产生的到账通知上报到支付服务。稳定性主要取决于通知读取权限、后台保活、网络质量和支付应用本身的登录状态。
一、选择真机还是模拟器
安卓真机通常在通知兼容性和长期运行方面更直观，但要处理充电、休眠和厂商省电策略。安卓模拟器便于远程维护和服务器集中运行，但需要确认通知服务、网络、时间同步与支付应用兼容性。
| 环境 | 优势 | 重点检查 |
|---|---|---|
| 安卓真机 | 接近真实日常使用 | 电池优化、锁屏断网、自动启动 |
| 安卓模拟器 | 便于远程与集中维护 | 通知服务、资源占用、异常重启 |
二、安装并登录必要应用
- 安装受支持版本的微信、支付宝和蓝鲸监听端。
- 登录用于收款的本人账户，并完成必要安全验证。
- 确认微信、支付宝可以正常弹出到账通知。
- 在监听端填写或绑定支付后台提供的连接信息。
不要在来源不明的设备镜像或应用安装包中登录收款账户。设备应设置锁屏保护，并限制无关人员访问。
三、开启通知读取权限
进入安卓系统设置，为监听端开启“通知使用权”或“读取通知”权限；同时允许微信、支付宝显示通知内容。若通知被隐藏为“你收到一条消息”，监听端可能无法获得金额。
完成授权后先进行本机验证：让另一账户支付小额金额，确认系统通知栏出现包含金额的到账消息。
四、配置后台保活
- 把监听端加入自启动白名单。
- 关闭监听端、微信和支付宝的电池优化。
- 允许后台活动和后台联网。
- 锁定最近任务，避免一键清理结束进程。
- 设置设备不因长时间静置而断网。
- 模拟器应配置异常退出自动拉起。
五、网络和时间设置
使用稳定网络，避免频繁切换 Wi-Fi 与移动网络。设备时间应开启自动同步；服务器与安卓端时间偏差过大，会增加订单有效期判断和日志排查难度。若私有化服务位于内网，需要确保监听端能够访问其上报地址。
六、完成端到端联调
- 在业务端创建一笔微信小额订单并按实际金额支付。
- 检查安卓端是否读取通知并显示上报成功。
- 检查支付后台订单是否从等待支付变为完成。
- 检查业务回调日志和订单发货状态。
- 支付宝再重复一遍，并测试锁屏、重启和断网恢复。
七、长期运行建议
为监听在线状态、最后上报时间和连续失败建立告警。每天抽查一笔小额订单，定期清理系统缓存但不要随意升级支付应用；升级前先在备用环境验证。真机长期供电应注意电池健康和散热。
八、常见问题
- 有到账通知但订单不变：检查监听端通知权限、连接状态和金额是否与待支付订单一致。
- 锁屏后不监听：检查省电策略、后台联网和应用自启动。
- 偶发延迟：对比通知产生、监听上报、服务端匹配三个时间点。
- 重复上报：服务端需对到账事件去重，业务回调也要幂等。