iOS14 WebRTC setRemoteDescription始终报SessionDescription为NULL错误
SDP异常定位与解决方案
1. 开启WebRTC原生日志获取具体报错
iOS端WebRTC SDK的OC封装层不会把native层SDP解析的具体错误向上透传,只要解析流程中任何一步校验失败,就会直接返回空的SessionDescription对象,触发笼统的“SessionDescription is NULL”报错。
要拿到具体错误原因,需要先打开内部日志:
- 注册日志输出回调,设置最低日志级别为
RTCLoggingLevel.info,对应代码调用:RTCSetMinimumLoggingLevel(RTCLoggingLevel.info) - 解析失败的具体原因(如哪一行格式不合法、哪个字段校验不通过)会直接输出在native日志流中,不会只返回笼统的空对象错误。
2. 针对当前提供的SDP直接定位已知无效点
构造的SDP存在多处不符合WebRTC unifiedPlan规范的问题,直接触发解析失败、返回空SessionDescription:
- 重复Payload Type:
m=video 7 96 97 98 99 100 101 127 123 125 122 124 100行的媒体格式列表末尾重复出现了100,WebRTC要求同一个媒体行内的payload type不能重复,重复值会直接判定SDP无效。 - 非法媒体端口:媒体行使用端口
7,属于系统保留的特权端口,WebRTC解析器会拒绝所有低于1024的媒体端口配置,且如果启用rtcp-mux的场景下,端口必须为1024以上的有效端口。 - DTLS角色不匹配:传入的是
.answer类型的SDP,却配置了a=setup:active。按照DTLS协商规则,answer侧的setup属性必须为passive或actpass,只有offer侧才能使用active,角色不匹配会直接拦截SDP校验。 - 媒体配置与PeerConnection不匹配:unifiedPlan语义下,每个媒体段必须和PeerConnection中已添加的transceiver一一对应,当前SDP使用了
a=msid-semantic: WMS *通配符,且没有携带和本地transceiver匹配的mid属性对应关系,会被判定为无效的远端描述。
3. 快速排查验证流程
- 找一份原生WebRTC生成的、可正常被
setRemoteDescription接受的answer SDP作为基准,逐行替换自定义的SDP内容,触发报错的替换行即为异常行。 - 临时将PeerConnection的
sdpSemantics改为.planB测试调用,如果能正常执行,说明是unifiedPlan下的媒体段规则未对齐。 - 检查构造的SDP字符串是否存在行尾不可见字符、多余换行,WebRTC的SDP解析器对特殊字符非常敏感。
关键注意事项
- 自定义SDP生成逻辑必须严格对齐RFC 8829规范,重点校验payload type唯一性、媒体端口范围、DTLS角色匹配规则,这三处是触发“SessionDescription is NULL”无明确报错的最高频原因。
- 不要跳过原生SDP解析的前置校验环节,即便格式上看起来符合SDP语法,只要不符合WebRTC的协商规则,就会被置空返回。
内容的提问来源于stack exchange,提问作者Ross Stepaniak
相关产品推荐
相关产品推荐

