ZLMediaKit中OBS推流失败问题分析与解决方案

问题背景

在使用ZLMediaKit最新master分支代码进行本地运行时，用户尝试通过OBS Studio 30.2.3版本进行推流操作时遇到了连接失败的问题。OBS日志显示"Connect failed: HTTP endpoint returned response code 200"的错误信息，同时PeerConnection状态变为Closed。

错误现象分析

从日志中可以清晰地看到问题的发生过程：

1. OBS尝试通过WHIP协议向ZLMediaKit推送流媒体数据
2. 服务器返回了HTTP 200状态码（通常表示成功），但OBS却报告连接失败
3. 最终PeerConnection状态变为Closed，推流中断

根本原因

经过技术分析，发现问题的根本原因在于用户错误地使用了WebRTC的API接口。具体表现为：

• 错误接口：用户使用了/index/api/webrtc接口
• 正确接口：OBS WHIP推流应该使用/index/api/whip接口

这两个接口虽然都涉及WebRTC技术，但设计用途不同：

1. /index/api/webrtc接口是为浏览器端WebRTC应用设计的
2. /index/api/whip接口是专门为OBS等流媒体软件设计的WHIP协议端点

解决方案

要解决这个问题，用户需要：

1. 在OBS中配置正确的推流地址：

   http://{服务器IP:端口}/index/api/whip?app=live&stream=流名称
   

2. 确保ZLMediaKit配置文件中启用了WHIP协议支持

技术细节

WHIP(WebRTC-HTTP Ingestion Protocol)是专门为简化WebRTC推流而设计的协议，相比完整的WebRTC协议栈，它具有以下特点：

• 简化了信令流程
• 更适合专业流媒体软件使用
• 减少了不必要的协商过程

而WebRTC API则提供了更完整的WebRTC功能，适合浏览器端复杂场景使用。

预防措施

为避免类似问题，建议：

1. 仔细阅读ZLMediaKit文档中关于不同协议接口的说明
2. 在配置OBS时确认使用的是WHIP协议而非WebRTC
3. 测试时先使用简单的流名称，排除其他干扰因素

总结

通过正确理解和使用ZLMediaKit提供的不同接口，可以避免这类推流失败的问题。WHIP协议作为专门为流媒体推送设计的协议，在稳定性和性能上都有优势，是OBS推流的首选方案。