如何解决开启视频滤镜时VLC播放/停止操作引发的内存泄漏问题

云原生阿岚

2026-9-25

问题根因

该内存泄漏属于LibVLC 3.0.16版本的已知原生bug，仅在开启视频滤镜+D3D11视频输出时触发：滤镜分配的GPU纹理、渲染中间缓冲等非托管内存，没有在播放停止时被正确回收，而C#侧的GC无法管理LibVLC分配的非托管内存，因此调用GC.Collect()没有任何效果。

解决方案（按优先级排序）

1. 升级LibVLC版本

这是最彻底的修复方案：

LibVLC 3.0稳定分支的3.0.18及以上版本已经修复了该D3D11链路下的滤镜资源泄漏问题
直接更新你的LibVLCSharp Nuget包，同时配套更新对应的LibVLC.Windows依赖包到3.0.18+版本，升级后泄漏问题会直接消失

2. 无法升级版本的规避方案

如果业务要求必须使用3.0.16版本，可通过以下方式规避泄漏：

2.1 替换视频输出模块

将视频输出模块从d3d11替换为d3d9或gdi，这两个输出模块在3.0.16版本下不存在滤镜泄漏问题，初始化代码示例：

// 初始化LibVLC时指定输出模块
var libVLC = new LibVLC("--vout=d3d9"); 
// 性能要求极低的场景可以用 --vout=gdi

注意：d3d9相比d3d11仅在4K/高帧率视频场景下有可感知的性能下降，普通1080P及以下视频播放几乎无差异

2.2 调整资源释放逻辑

修改播放停止的流程，手动清理滤镜资源后再释放实例，不要复用MediaPlayer实例：

// 停止播放前先清空滤镜配置
mediaPlayer.AddOption("--video-filter=");
// 销毁当前加载的媒体资源
mediaPlayer.Media?.Dispose();
mediaPlayer.Media = null;
// 执行停止操作
mediaPlayer.Stop();
// 直接销毁当前MediaPlayer实例，下次播放新建实例而不是复用
mediaPlayer.Dispose();

针对你需要同时展示10个VideoView的场景，每次播放新建MediaPlayer实例、停止后立即销毁，虽然有少量初始化开销，但可以完全规避旧实例残留的滤镜资源泄漏问题。