指南 04 / 播放排查

开不了播、切歌卡住、锁屏断开,怎么排查?

先找出哪一步失败,再只更换一个条件。保留一条可以复现的记录。

按照出现问题的时间点分流

从现象出发,缩小排查范围
现象下一次复现怎么做
网页打不开先打开另一可访问网页,再重新尝试 MHub。记下是 DNS、浏览器连接错误还是站点页面报错。
能搜,某首一直处理中在同一来源、同一档位试另一首。如果只有原曲失败,保留它的曲目公开链接;再测试原曲的另一档位。
开播后卡顿记录发生在首次播放还是重播;用同一首在同一网络重试,检查「本地缓存」中是否有音频体积。
锁屏时播完一首就停准备两首,等待下一首缓存;同一队列先在前台自然结束一次,再锁屏自然结束一次。手动点下一首不能替代这步。

一次只换一个条件

例如首次播放会卡,但同一首从本地播放正常:这个对照先把音频输出和部分解码问题放到次要位置,再查网络、音源准备和下载。它只是范围判断,不能仅凭一次尝试断定是哪一个 CDN 节点有故障。

另一个例子:只有锁屏等到歌曲自然结束时才停止。如果前台正常,记录锁屏时系统媒体通知是否消失、解锁后播放位置是否变化、下一首在本地是否已有音频。浏览器打开和主屏幕安装的版本也要分开记录。

如何反馈一条可复现的问题

提供设备型号、系统和浏览器版本、发生时间及所在时区、曲目来源与音质,以及上面哪组对照成功或失败。给出最短操作顺序,例如「前台可自然切歌;同一队列锁屏后自然结束就停」。

可到 MHub Issues 反馈公开问题。链接含账号参数时先删去参数,不要贴 Cookie、恢复码、登录信息或私有歌单链接。

打开 MHub 播放器