Janus-Gateway SIP会话异常问题分析与解决方案

Janus-Gateway作为一个开源的WebRTC网关，在多媒体通信领域有着广泛应用。近期在其1.2.2版本中发现了一个与SIP会话处理相关的重要问题，该问题会导致会话状态异常，影响系统稳定性。本文将深入分析问题成因，并详细介绍解决方案。

问题现象

在特定场景下，Janus-Gateway的SIP会话会出现"卡死"状态，具体表现为：

1. 当处理无SDP offer的INVITE请求时
2. 连续拒绝两个此类请求后
3. 会话状态会永久停留在establishing=1状态
4. 导致后续所有来电被自动拒绝

技术背景

Janus-Gateway使用JANUS_ICE_WEBRTC_ALERT标志位来管理WebRTC连接状态。正常情况下：

• 挂断时设置该标志位
• 新呼叫建立时清除该标志位
• 通过hangup_media回调通知插件状态变化

问题根源分析

经过深入排查，发现问题源于状态机管理逻辑的缺陷：

1. 对于无SDP offer的INVITE请求，不会触发PeerConnection建立流程
2. 拒绝此类呼叫时仍会调用close_pc()函数
3. 首次调用会设置ALERT标志并触发hangup_media
4. 但由于没有实际WebRTC资源需要清理，ALERT标志保持设置状态
5. 第二次拒绝时，ALERT标志已设置，导致hangup_media不被调用
6. 插件状态无法正确重置，establishing标志保持设置状态

解决方案演进

开发团队提出了多个解决方案思路：

1. 初始方案：在janus_ice_setup_local中强制清除ALERT标志

   • 问题：可能干扰正常的状态管理流程

2. 改进方案：在资源释放时清除ALERT标志

   • 优点：更符合逻辑流程
   • 问题：仍无法完全解决所有场景

3. 最终方案：修正SIP插件状态管理逻辑

   • 确保ALERT标志初始状态正确
   • 优化拒绝呼叫时的状态处理
   • 修正默认的错误响应代码(从486改为603)

技术实现细节

核心修改包括：

1. 在janus_ice_webrtc_free函数中添加ALERT标志清除逻辑
2. 确保无论是否有实际WebRTC资源需要清理，状态都能正确重置
3. 优化SIP插件的状态机转换逻辑
4. 修正错误响应代码，符合SIP规范

影响评估

该修复：

• 解决了SIP会话卡死问题
• 保持与其他插件的兼容性
• 不影响正常呼叫流程
• 提高了系统稳定性

最佳实践建议

对于使用Janus-Gateway SIP功能的开发者：

1. 及时升级到包含此修复的版本
2. 测试各种呼叫拒绝场景
3. 监控establishing状态指标
4. 考虑实现会话状态健康检查机制

总结

Janus-Gateway的这个SIP会话问题展示了多媒体通信系统中状态管理的重要性。通过深入分析问题根源，开发团队找到了既解决问题又保持系统稳定性的最佳方案。这为处理类似WebRTC状态管理问题提供了有价值的参考案例。