RTSP-Simple-Server中WebRTC runOnDemand的MTX_QUERY参数传递问题解析

在RTSP-Simple-Server（现更名为MediaMTX）1.10.0版本中，开发者发现了一个关于WebRTC协议下runOnDemand脚本环境变量传递的问题。这个问题主要影响使用WebRTC协议连接时查询参数的传递机制。

问题现象

当用户通过WebRTC协议（如浏览器访问）连接服务器时，例如使用URL格式https://localhost:8889/mystream?q=hello，服务器虽然正确执行了runOnDemand脚本，但脚本中无法获取到MTX_QUERY环境变量的值。相比之下，如果使用RTSP协议（如rtsp://localhost:8554/mystream?q=hello）连接，则能正常获取查询参数。

技术背景

runOnDemand是RTSP-Simple-Server提供的一个强大功能，它允许在客户端首次请求某个流路径时触发外部脚本执行。服务器会向脚本传递几个关键环境变量：

• MTX_PATH：表示请求的流路径
• MTX_QUERY：包含URL中的查询参数部分

这种机制常用于实现动态流生成、访问控制等高级功能。

问题根源

经过分析，这个问题源于WebRTC协议处理层与RTSP协议处理层在查询参数传递逻辑上的不一致。WebRTC协议栈在处理客户端请求时，虽然正确解析了URL中的查询参数，但没有将这些参数正确注入到runOnDemand的执行环境中。

解决方案

项目维护者迅速响应并修复了这个问题。修复方案主要涉及：

1. 统一WebRTC和RTSP协议栈的查询参数处理逻辑
2. 确保所有协议类型都能正确将查询参数传递给runOnDemand脚本
3. 保持向后兼容性，不影响现有部署

最佳实践

对于使用runOnDemand功能的开发者，建议：

1. 始终检查环境变量的存在性，编写健壮的脚本
2. 考虑参数编码问题，查询参数可能包含需要解码的特殊字符
3. 对于关键业务逻辑，应在脚本中加入参数验证机制

该修复已包含在v1.11.1版本中，遇到类似问题的用户升级到该版本即可解决。这个案例也展示了开源社区如何快速响应和解决技术问题，为开发者提供更稳定的基础设施。