WVP-GB28181-Pro项目推流功能问题分析与解决方案

问题背景

在WVP-GB28181-Pro项目中，用户反馈推流成功后，推流列表不显示，其他功能列表也不显示的问题。这是一个典型的流媒体服务配置问题，涉及到WVP(Web Video Platform)与ZLM(ZLMediaKit)媒体服务器的交互机制。

问题现象

1. 使用ffmpeg-python推流到RTMP地址成功
2. 通过RTMP地址可以正常播放视频流
3. WVP管理界面中推流列表为空
4. 其他功能列表也不显示内容

技术分析

1. 推流流程机制

在WVP-GB28181-Pro项目中，完整的推流流程应该包含以下几个关键环节：

1. 推流客户端：使用ffmpeg等工具向ZLM服务器推送RTMP流
2. ZLM服务器：接收流并进行转码、分发
3. WVP平台：通过Hook机制获取ZLM的流状态信息
4. 数据库存储：WVP将流信息存入数据库
5. 前端展示：从数据库读取并展示流列表

2. 问题根源定位

从日志分析可以看出：

1. ZLM服务器确实接收到了推流请求并成功建立了连接
2. WVP也接收到了ZLM的Hook通知（如on_publish事件）
3. 但流信息没有正确显示在前端界面

这表明问题可能出在以下几个环节：

1. Hook配置不完整：虽然on_publish事件被触发，但其他关键Hook可能未配置
2. 数据库存储失败：WVP接收到Hook后未能正确存储流信息
3. 前端数据获取失败：数据已存储但前端未能正确获取

3. 配置检查

通过检查ZLM的配置发现：

1. Hook功能已启用（hook.enable=1）
2. 基本Hook地址已配置（如on_publish、on_play等）
3. 但部分关键Hook如on_stream_changed未正确配置

解决方案

1. 完整Hook配置

确保ZLM服务器配置中包含所有必要的Hook地址：

hook.enable=1
hook.on_play=http://[WVP_IP]:18080/index/hook/on_play
hook.on_publish=http://[WVP_IP]:18080/index/hook/on_publish
hook.on_stream_changed=http://[WVP_IP]:18080/index/hook/on_stream_changed
hook.on_stream_none_reader=http://[WVP_IP]:18080/index/hook/on_stream_none_reader
hook.on_stream_not_found=http://[WVP_IP]:18080/index/hook/on_stream_not_found
hook.on_server_started=http://[WVP_IP]:18080/index/hook/on_server_started
hook.on_server_keepalive=http://[WVP_IP]:18080/index/hook/on_server_keepalive

2. WVP与ZLM连接验证

1. 检查WVP配置文件中ZLM相关配置是否正确
2. 确认WVP能够访问ZLM的API接口
3. 验证WVP的Hook接口能够正常接收ZLM的通知

3. 数据库检查

1. 检查WVP使用的数据库连接是否正常
2. 确认数据库表结构完整
3. 检查是否有数据写入失败的情况

4. 日志分析

通过分析WVP和ZLM的日志，可以：

1. 确认Hook事件是否被正确接收和处理
2. 检查是否有错误或异常信息
3. 跟踪流信息的存储过程

实施步骤

1. 备份当前配置：首先备份现有的WVP和ZLM配置
2. 更新Hook配置：按照上述方案完善ZLM的Hook配置
3. 重启服务：重启ZLM和WVP服务使配置生效
4. 测试验证：
   • 使用ffmpeg推流测试
   • 检查WVP日志确认接收到Hook事件
   • 检查数据库确认流信息已存储
   • 刷新前端界面确认流列表显示正常

预防措施

1. 配置检查工具：开发简单的脚本定期检查Hook配置状态
2. 监控告警：设置对关键Hook事件的监控和告警
3. 文档记录：详细记录配置要求和检查步骤
4. 自动化测试：建立自动化测试流程验证推流功能

总结

WVP-GB28181-Pro项目中推流列表不显示的问题通常是由于ZLM媒体服务器与WVP平台之间的Hook配置不完整或通信异常导致的。通过全面检查Hook配置、验证服务间通信、分析日志信息，可以有效地定位和解决此类问题。正确的配置和持续的监控是保证流媒体服务稳定运行的关键。