RTSP视频流没有接入进分布式系统的排查方法

引言

最近接到一个技术支持工单：某项目现场在坤通可视化分布式管理平台添加了RTSP网络流，但等了半天，大屏上就是没画面，预览窗口也是黑的。主码流、子码流都试了，全都没反应。我带上电脑，开始了一次标准的远程排查。

第一步：先确认RTSP流本身通不通

这是最基础也最重要的一步。很多问题其实出在源头——摄像头、监控等设备生成的RTSP地址本身可能就不通。

我让现场同事发来添加失败的RTSP地址，在自己电脑上打开VLC播放器。点击“媒体” -> “打开网络串流”，把地址粘贴进去，点播放。

几秒钟后，VLC里画面出来了，流畅播放。这说明RTSP源没问题，摄像机、录播主机都在正常工作。问题可以锁定在分布式系统这边了。

第二步：检查分布式管理平台的通信网卡设置

登录分布式管理平台，我第一眼看向右上角。这是一个容易被忽略的地方——通信网卡选择。

分布式系统的管理电脑通常有多个网卡：一个连外网、一个连设备网。如果当前选中的网卡和分布式节点、RTSP流所在的网络不在同一个网段，那平台就“听不见”也“看不见”任何信号。

我让同事把网卡切换到连接设备内网的那块，点应用。再看信号列表，还是没画面。看来不是这个原因。

第三步：查看信号列表，确认添加流程完整

在坤通平台左侧菜单找到“摄像头管理”或类似入口，进入“RTSP/RTMP添加”页面。

现场同事说已经添加过了。我让他点进去编辑，发现地址填对了，但有个细节：添加完RTSP地址后，还需要手动把这条网络流添加到“信号列表”中。

这就像一个通讯录：你存了号码（添加RTSP），还得把它加入“常用联系人”（添加到信号列表），才能快速调用。

同事按我说的，选中那条网络流，点击“添加”，信号列表里终于出现了这条流。但预览窗口依然漆黑。

第四步：重新添加，并注意“一键获取”功能

坤通平台有个实用功能叫“一键获取”。在添加RTSP流时，填好地址后点击这个按钮，平台会自动尝试解析流信息。

同事重新添加了一次，输入RTSP地址后，果断点击“一键获取”。这次平台成功解析出了流名称和参数。保存后，再次添加到信号列表——预览窗口亮了，画面终于出来了。

复盘总结

这次问题其实是两个小问题叠加：

添加RTSP流后忘了添加到信号列表，导致平台“有号码但没存联系人”

最初添加时可能地址格式有小问题，平台没能正确解析，重新添加并用了“一键获取”后解决了

现场同事松了口气。我告诉他：下次遇到RTSP流不显示，记住三步——VLC验证源、检查网卡、重新添加并一键获取，90%的问题都能自己搞定。