ZLMediaKit中FFmpegSource录制功能线程安全问题分析与修复

问题背景

在ZLMediaKit流媒体服务器项目中，FFmpegSource模块负责将外部媒体源通过FFmpeg转封装后推送到服务器内部。该模块支持同时开启HLS和MP4录制功能，但在实际使用中发现当同时启用这两种录制格式时，会出现线程安全问题导致程序崩溃。

问题现象

开发者在调用addFFmpegSource API接口并同时开启HLS和MP4录制时，服务器出现异常崩溃。通过分析崩溃日志发现，问题发生在媒体源对象的多线程访问冲突上。

技术分析

根本原因

1. 线程模型问题：FFmpegSource模块的回调函数onGetMediaSource在FFmpeg的工作线程中被调用，而setupRecord操作需要在媒体源所属的EventPoller线程中执行。

2. 竞态条件：当同时设置HLS和MP4录制时，两个setupRecord操作可能在不同线程中并发执行，导致对媒体源对象的非线程安全访问。

3. 对象生命周期管理：在多线程环境下，媒体源对象的生命周期管理存在隐患，可能导致访问已释放的对象。

解决方案

修复方案采用了ZLMediaKit项目中常见的线程切换模式：

1. 通过getOwnerPoller()获取媒体源对象所属的EventPoller
2. 使用async方法将录制设置操作投递到正确的线程中执行
3. 对HLS和MP4录制分别进行线程安全的异步设置

src->getOwnerPoller()->async([=]() mutable {
    src->setupRecord(Recorder::type_hls, true, "", 0);
});

技术要点

1. ZLMediaKit的线程模型：项目采用基于EventPoller的事件驱动模型，每个媒体源对象都关联特定的EventPoller线程，所有操作都应在所属线程中执行。

2. 录制功能实现：HLS和MP4录制是通过MediaSource的setupRecord方法实现的，该方法会创建对应的录制器并开始录制。

3. 线程安全编程：在多媒体服务器开发中，跨线程操作是常见需求，必须谨慎处理线程切换和对象生命周期。

修复效果

该修复方案确保了：

• 录制设置操作在正确的线程中执行
• 避免了多线程并发访问媒体源对象
• 保持了原有功能的同时提高了系统稳定性

总结

这个案例展示了在流媒体服务器开发中常见的线程安全问题。ZLMediaKit作为高性能流媒体服务器，对线程安全有着严格要求。开发者在扩展功能时，必须充分考虑ZLMediaKit的线程模型，确保所有操作都在正确的线程中执行。此次修复不仅解决了具体问题，也为类似场景提供了参考解决方案。