MediaMTX API接口/v3/recordings/list崩溃问题分析与修复

在MediaMTX 1.10.0至1.11.3版本中，用户报告了一个严重的API接口问题：当访问/v3/recordings/list接口时，会导致整个服务器崩溃重启。这个问题尤其影响那些将MediaMTX作为服务运行在Windows系统上的用户。

问题现象

当用户尝试通过浏览器或API客户端访问记录列表接口时，会立即遇到连接重置错误(ERR_CONNECTION_RESET)。与此同时，所有正在运行的流媒体连接都会中断，需要重新建立连接。从日志中可以观察到，服务器在处理该API请求后会立即重新加载配置，表现得像是服务刚刚启动一样。

在Windows Server 2016环境下，由于MediaMTX被配置为系统服务并启用了自动重启功能，这个问题表现得尤为明显——服务崩溃后会立即自动重启，但已经建立的连接都会被中断。

问题根源

经过开发团队分析，这个问题源于API接口在处理记录列表请求时的内存访问异常。当系统尝试枚举和返回录制文件列表时，某些特殊条件未被正确处理，导致程序出现不可恢复的错误而崩溃。

解决方案

开发团队在后续版本中修复了这个问题，主要改进包括：

1. 增加了对录制文件列表访问的安全检查
2. 改进了API接口的异常处理机制
3. 确保在枚举文件时不会引发不可恢复的错误

该修复已被包含在MediaMTX 1.12.0及后续版本中。用户升级到最新版本后，访问/v3/recordings/list接口将不再导致服务崩溃。

最佳实践建议

对于使用MediaMTX的管理员和开发者，建议：

1. 定期检查并升级到最新稳定版本
2. 在生产环境部署前，充分测试所有API接口
3. 对于关键业务系统，考虑实现监控机制来检测服务异常
4. 在Windows服务配置中，合理设置服务失败后的恢复策略

通过这次问题的修复，MediaMTX的API稳定性得到了进一步提升，为开发者提供了更可靠的接口服务。