WVP-GB28181-Pro项目点播错误排查指南

WVP-GB28181-Pro项目点播错误排查指南

wvp-GB28181-pro 项目地址: https://gitcode.com/gh_mirrors/wv/wvp-GB28181-pro

点播流程概述

在WVP-GB28181-Pro项目中，点播功能是核心功能之一。完整的点播流程涉及多个环节的交互：

1. 用户通过WEB界面发起点播请求
2. WVP-PRO向设备发送Invite消息(携带SDP消息体)
3. 设备回复200OK(携带SDP消息体)
4. WVP-PRO发送Ack确认
5. 设备向ZLMediaKit发送实时流
6. ZLMediaKit通知WVP-PRO流改变事件
7. WVP-PRO向用户返回流播放地址
8. ZLMediaKit检测到无人观看时通知WVP-PRO
9. WVP-PRO向设备发送Bye消息
10. 设备回复200OK

常见错误类型及解决方案

一、点播收到错误码

1. 400错误码

现象：点击"播放"按钮后很快收到400错误。

原因分析：

• 设备认为WVP发送的消息格式不正确或不完整
• 可能是设备实现不规范导致的兼容性问题

解决方案：

• 使用抓包工具分析信令交互过程
• 检查SDP消息体是否完整
• 联系设备厂商确认其实现规范
• 如确认是兼容性问题，可联系WVP-PRO开发者协助解决

2. 500系列错误码

现象：收到500或5xx范围内的错误码。

原因分析：

• 设备内部处理错误
• 设备资源不足
• 设备功能不支持

解决方案：

• 直接联系设备厂商技术支持
• 提供对接其他平台时的抓包数据作为参考
• 检查设备状态和资源使用情况

二、点播超时问题

1. 信令超时

现象：长时间未收到设备响应。

可能原因：

• 设备内部处理异常
• 网络连接问题
• NAT穿透失败(公网部署场景)

解决方案：

• 检查网络连通性
• 确认设备状态正常
• 调整心跳周期(公网部署时)
• 检查NAT配置

2. 收流超时

现象：信令交互完成但未收到媒体流。

可能原因及解决方案：

1. IP/端口配置错误

   • 检查WVP-PRO配置中的IP地址
   • 确认设备能访问指定的IP和端口
   • 公网部署时避免使用内网IP

2. 设备未发送流

   • 检查设备状态
   • 确认设备配置正确

3. 流格式问题

   • 检查ZLMediaKit日志
   • 抓包分析流格式
   • 关闭SSRC校验(临时解决方案)

4. Hook通知失败

   • 检查ZLMediaKit的Hook配置
   • 确认WVP-PRO能收到Hook通知

5. SSRC校验失败

   • 检查设备SSRC设置
   • 临时关闭SSRC校验进行测试

系统排查建议

1. 日志分析：

   • 检查WVP-PRO日志中的错误信息
   • 查看ZLMediaKit的流注册日志

2. 抓包分析：

   • 使用专业抓包工具捕获信令和媒体流
   • 分析SDP协商过程
   • 检查RTP/RTCP流

3. 流验证：

   • 导出原始流数据
   • 使用VLC等工具验证流可播放性

4. 配置检查：

   • 确认网络配置正确
   • 验证IP地址和端口可达性
   • 检查安全策略(防火墙等)

最佳实践建议

1. 测试环境建议从简单场景开始，逐步增加复杂度
2. 公网部署时注意NAT和防火墙配置
3. 保持WVP-PRO和ZLMediaKit版本匹配
4. 复杂场景建议分步测试各组件功能
5. 遇到问题时收集完整的日志和抓包数据

通过以上系统化的排查方法，可以高效定位和解决WVP-GB28181-Pro项目中的点播相关问题。

wvp-GB28181-pro 项目地址: https://gitcode.com/gh_mirrors/wv/wvp-GB28181-pro