推流SDK异常自助排查_视频直播(LIVE)-阿里云帮助中心

本文介绍推流 SDK 出现异常时的自助排查思路和操作步骤，帮助用户高效定位和解决常见问题。

控制台操作指引

您可以通过控制台自助问题排查功能发现并解决直播流相关的问题。

视频直播控制台提供了直播管理、应用管理、数据中心和工具箱功能模块的配置与使用。有关详细信息，请参考以下：

常见问题

若配置License时遇到问题，请参见License相关常见问题。
若推流产生问题，您可以使用自助问题排查功能对推流地址进行检测，检测推流地址是否有效。

技术支持

如果按照上述流程依然无法解决您的问题，您可以提交工单以获取技术支持。有关详细信息，请参考联系我们文档。

在获取技术支持时，请务必提供以下信息，以便提升技术支持效率：

项目	详细说明	备注
问题简述	请用一句话简要描述你遇到的问题	-
问题描述	业务场景（如基础直播、互动直播等）。 SDK类型及版本号。问题发生阶段（如集成、上线等）。详细现象与类型（如断流、无画面、无声音等）。复现步骤（如必现/偶现，具体操作步骤）。问题分布情况（平台、系统版本、机型、地区等）。	如果您使用AUI Kits解决方案，请注明。 License问题请备注应用包名和License Key。建议您使用最新的SDK版本，以获得更好的支持。
问题上下文	发生问题时的具体环境说明。推/拉流地址（请脱敏）。问题发生时间点。日志（logcat/文件日志等，建议打包上传）。配置信息（如App名、包名、连麦配置等）。其他资料（如录屏/截图等）。	抓日志前请先通过日志接口（AlivcLiveBase类）开启文件日志功能，可参考 Demo 中相关设置方法。建议关闭直播后再抓取日志。日志获取路径： Android：/sdcard/Android/data/${app_id}/files/ iOS：沙盒目录下在直播连麦场景中，请提供以下信息：主播推流地址（包括应用 ID、房间号、用户 ID）普通观众拉流地址（包括旁路转推中配置的播放域名）
补充信息	是否有相关错误提示（如有请注明错误码/错误信息）。异常发生时是否可自动恢复（如自动重连）。其它可协助定位问题的信息。

问题描述填写规范

标准问题模板

问题标题：（一句话概述问题现象）
业务场景：（如 基础直播 / 互动直播 / 低延迟直播 等）
SDK 及版本号：（如 AlivcLivePusher: x.y.z 或 AlivcLivePusher_Interactive: x.y.z）
应用名称/包名：（如 LiveExample / com.example.liveapp）

问题类型及表现：（如 偶尔断流 / 无法拉流 / 无画面等，请简要描述具体现象）
复现概率：（如 偶发 / 必现）
详细复现步骤：
1. 
2. 
3. 
影响用户/设备分布：（如 Android 9 及以下 / iOS / 特定地区等）

推流地址：（请粘贴完整推流 URL）
拉流地址：（如有，请填写）
发生时间：（请注明具体时间，或多次发生时请举例）
网络环境：（如 Wi-Fi/4G/5G/有线网络）
问题日志：（如 logcat 日志、推流/拉流日志等，建议打包压缩上传）
录屏/截图：（如有异常现象录屏或关键截图请上传）
推流参数配置：（如分辨率、帧率、码率等）

是否有相关错误提示：（如有报错，请提供错误码或提示信息）
异常发生时是否自动恢复：（如自动重连，需描述重连结果）
其它备注：（任何你认为有帮助的信息）

基础直播问题示例

问题标题：基础直播推流过程中偶尔断流
业务场景：基础直播
SDK 及版本号：AlivcLivePusher: x.y.z
应用名称/包名：LiveExample / com.example.liveapp

问题类型及表现：推流过程中，每隔约 30 分钟偶发断流，需手动重新推流
复现概率：偶发
详细复现步骤：
1. 启动推流
2. 30 分钟左右发生断流
3. 需重启推流恢复
影响用户/设备分布：Android 9 及以下，多个机型，东南亚地区较多

推流地址：rtmp://test.alivecdn.com/live/streamId?auth_key=XXX
发生时间：2024-05-18 12:34
网络环境：4G
问题日志：见附件 logcat_20240518.zip
录屏/截图：见附件
推流参数配置：分辨率 720p，码率 1500kbps，帧率 30fps

是否有相关错误提示：无报错提示
异常发生时是否自动恢复：无，需手动重推
其它备注：无

互动直播问题示例

问题标题：直播连麦 CDN 观众无法接收到主播画面
业务场景：直播连麦，AUI Kits 互动直播
SDK 及版本号：AlivcLivePusher_Interactive: x.y.z
应用名称/包名：LiveExample / com.example.liveapp

问题类型及表现：主播端正常推流，连麦观众端可以正常拉流，CDN 观众端始终无法看到主播画面，无任何错误提示
复现概率：必现
详细复现步骤：
1. 主播端启动互动直播并推流
2. 连麦观众端正常收到主播画面
3. CDN 观众端（Android/iOS 端）进入直播间，始终无法看到主播画面
影响用户/设备分布：Android 和 iOS 端均必现

推流地址：artc://live.aliyun.com/push/633?timestamp=1685094092&token=fe4e674ade****6686&userId=718&sdkAppId=xxx
拉流地址：rtmp://test.alivecdn.com/live/xxx_633_718_camera?auth_key=XXX
配置信息：房间号 633，应用ID xxx，用户ID 718，播放域名 test.alivecdn.com
发生时间：2024-05-18 12:34
网络环境：Wi-Fi
问题日志：见附件 logcat_20240518.zip
录屏/截图：见附件
推流参数配置：分辨率 720p，码率 1200kbps，帧率 20fps

是否有相关错误提示：无
异常发生时是否自动恢复：否，需关闭推流重新启动
其它备注：观众端未见任何提示，切换不同网络/设备均无效

相关文档参考