Ubuntu 22.04下Python多进程播放VideoFileClip视频故障排查修复

在Ubuntu 22.04系统中，使用以下代码播放视频片段：

import sys
import multiprocessing
from moviepy.editor import VideoFileClip

video_path = sys.argv[1]

def process_play_video(clip: VideoFileClip, video_fps: int):
    clip.preview(fps=video_fps)

clip = VideoFileClip(str(video_path))
video_fps = 15
play_directly = True

if play_directly:
    process_play_video(clip, video_fps)
else:
    process1 = multiprocessing.Process(target=process_play_video,
                                       args=(clip, video_fps))
    process1.start()
    process1.join()

clip.close()

待播放的视频信息如下：

Input #0, mov,mp4,m4a,3gp,3g2,mj2, from 'output_video.mp4':
 Metadata:
   major_brand     : isom
   minor_version   : 512
   compatible_brands: isomiso2avc1mp41
   encoder         : Lavf58.76.100
 Duration: 00:10:00.03, start: 0.000000, bitrate: 2155 kb/s
 Stream #0:0(und): Video: h264 (High) (avc1 / 0x31637661), yuv420p(tv, bt709), 1280x720 [SAR 1:1 DAR 16:9], 1954 kb/s, 29.97 fps, 29.97 tbr, 30k tbn, 59.94 tbc (default)
   Metadata:
     handler_name    : VideoHandler
     vendor_id       : [0][0][0][0]
 Stream #0:1(eng): Audio: aac (LC) (mp4a / 0x6134706D), 48000 Hz, stereo, fltp, 192 kb/s (default)
   Metadata:
     handler_name    : SoundHandler
     vendor_id       : [0][0][0][0]

现象：设置play_directly = True直接播放时视频正常；设置play_directly = False用独立进程播放时，仅显示第一帧无法正常播放。另有其他视频两种播放方式都正常。

要求：必须使用moviepy.editor.VideoFileClip，且通过multiprocessing实现播放。

原因分析 #

问题核心是跨进程传递VideoFileClip对象的错误操作：

• VideoFileClip内部包含文件句柄、FFmpeg上下文等底层资源，这些资源无法被安全序列化后传递给子进程
• 子进程拿到的clip是原对象的无效副本，内部播放状态、资源引用已失效，仅能读取第一帧后无法继续加载后续内容
• 部分视频能正常播放是偶然情况，和其编码格式、文件结构有关，不具备通用性

修复方案 #

不要直接传递VideoFileClip对象，改为在子进程内部重新初始化VideoFileClip实例：

修改后的代码 #

import sys
import multiprocessing
from moviepy.editor import VideoFileClip

video_path = sys.argv[1]

def process_play_video(video_path: str, video_fps: int):
    # 子进程内单独创建VideoFileClip，避免跨进程传递资源
    clip = VideoFileClip(video_path)
    clip.preview(fps=video_fps)
    clip.close()

video_fps = 15
play_directly = False

if play_directly:
    clip = VideoFileClip(video_path)
    clip.preview(fps=video_fps)
    clip.close()
else:
    process1 = multiprocessing.Process(target=process_play_video,
                                       args=(video_path, video_fps))
    process1.start()
    process1.join()

额外优化建议 #

• 若需复用视频处理逻辑，可将VideoFileClip初始化封装为单独函数，减少重复代码
• 子进程内必须调用clip.close()释放资源，避免内存泄漏
• 若出现音频同步问题，可尝试将preview的fps参数设置为原视频实际帧率（如示例中的29.97）

内容的提问来源于stack exchange，提问作者Alex