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

问题背景

在ZLMediaKit项目中，用户使用最新master分支代码进行本地运行时，遇到了OBS 30.2.3版本推流失败的问题。从日志分析来看，这是一个典型的WebRTC推流配置错误案例，涉及到API接口使用不当的问题。

错误现象

当用户尝试使用OBS进行推流时，OBS日志中显示以下关键错误信息：

[obs-webrtc] [whip_output: 'simple_stream'] Connect failed: HTTP endpoint returned response code 200
[obs-webrtc] [whip_output: 'simple_stream'] PeerConnection state is now: Closed

虽然服务器返回了200状态码（表示请求成功），但OBS客户端却无法建立正常的推流连接，最终导致PeerConnection状态变为Closed。

根本原因分析

通过分析请求和响应日志，可以确定问题的根本原因在于使用了错误的API接口：

1. 错误使用的API：用户配置的是/index/api/webrtc接口，这是为网页版WebRTC推流设计的接口
2. 应该使用的API：OBS推流应该使用WHIP协议专用的/index/api/whip接口

技术细节解析

WebRTC与WHIP协议的区别

1. WebRTC接口：

   • 设计用于浏览器环境
   • 使用SDP交换的完整流程
   • 需要处理ICE候选交换等复杂协商过程

2. WHIP接口：

   • 专为简化推流客户端设计
   • 采用更简单的信令流程
   • 更适合OBS等专业推流软件使用

错误配置的影响

使用错误的API接口会导致以下问题：

1. 虽然服务器能正确处理请求并返回200状态码
2. 但返回的SDP格式和内容不符合OBS WHIP客户端的预期
3. 最终导致ICE协商失败，连接被关闭

解决方案

要解决这个问题，需要将OBS中的推流地址修改为正确的WHIP协议地址：

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

配置步骤详解

1. 在OBS中设置推流时选择"WHIP"服务类型
2. 服务器URL格式应为上述正确的WHIP地址
3. 流名称参数可以根据实际需求自定义
4. app参数通常固定为"live"，表示直播应用

预防措施

为避免类似问题，建议：

1. 仔细阅读ZLMediaKit的文档，了解不同接口的用途
2. 区分WebRTC和WHIP协议的使用场景
3. 在测试新功能时，先使用官方推荐的配置示例
4. 关注日志中的警告和错误信息，及时发现问题

总结

在多媒体服务器项目中，正确理解和使用各种流媒体协议和接口至关重要。通过本案例的分析，我们不仅解决了OBS推流失败的具体问题，更重要的是理解了WebRTC和WHIP协议的区别及适用场景。这种理解对于构建稳定的流媒体系统具有普遍指导意义。