ZLMediaKit云端录像文件删除机制深度解析与优化实践

一、问题背景

在ZLMediaKit的实际应用场景中，用户发现通过deleteRecordDirectory接口删除云端录像文件时，虽然接口返回成功（code=0），但磁盘上的MP4文件仍然存在。该问题在WVP（Web Video Platform）与ZLMediaKit的集成环境中尤为突出，当云端录像文件量较大时（如单次操作涉及上万个文件），可能导致服务器磁盘空间异常占用。

二、技术原理分析

1. 删除接口工作机制：

   • deleteRecordDirectory接口支持两种删除模式：
     • 指定文件名删除单个录像文件
     • 删除整个录像目录（包含子目录）
   • 核心逻辑通过Recorder::getRecordPath获取文件路径，结合period参数定位具体文件

2. 现有实现缺陷：

   • 代码未区分文件删除与目录删除的逻辑判断顺序
   • 对正在录制的文件处理机制不完善：
     • 当删除指定文件时，未正确判断文件是否处于被占用状态
     • 返回码0仅表示接口调用成功，不保证实际文件删除结果

三、问题根因定位

通过源码分析发现以下关键问题点：

1. 文件占用检测逻辑位置不当，导致对单个文件删除的场景检测失效
2. 成功返回值定义过于宽泛，未能准确反映实际删除状态
3. 批量删除时缺乏错误处理机制，部分文件删除失败不影响整体返回结果

四、解决方案实现

项目组提供了核心修复方案：

bool recording = false;
auto name = allArgs["name"];
if (!name.empty()) {
    // 文件删除模式
    record_path += name;
} else {
    // 目录删除模式需检测录制状态
    auto src = MediaSource::find(allArgs["vhost"], allArgs["app"], allArgs["stream"]);
    if (src && src->isRecording(Recorder::type_mp4)) {
        recording = true;
    }
}

优化要点：

1. 明确区分文件删除与目录删除的逻辑分支
2. 前置状态检测，确保逻辑执行顺序正确
3. 完善录制状态判断机制

五、最佳实践建议

1. 云端录像管理策略：

   • 推荐使用on_publish hook动态控制录制开关
   • 对于定时删除场景，建议结合文件状态检测机制
   • 批量删除时增加结果校验逻辑

2. 性能优化方向：

   • 大文件量删除采用分批次处理
   • 实现异步删除机制避免阻塞主线程
   • 增加删除进度回调接口

3. 异常处理方案：

   • 建立文件删除失败的重试机制
   • 实现磁盘空间监控预警
   • 记录详细的删除操作日志

六、扩展应用思考

1. 录像生命周期管理：

   • 结合业务需求设计分级存储策略
   • 实现智能归档机制（热数据/冷数据分离）
   • 开发基于事件触发的自动清理功能

2. 与WVP的深度集成：

   • 优化webhook通知机制
   • 实现录制任务的状态同步
   • 开发统一的存储管理界面

该问题的解决不仅完善了ZLMediaKit的核心功能，也为流媒体服务器的存储管理提供了标准化实践方案。建议用户在升级到包含该修复的版本后，重新评估现有的录像管理策略，以获得最佳的系统稳定性和存储效率。