Ubuntu 20.04 Docker容器中MoviePy拼接MKV视频失败求助

问题重现 #

在Ubuntu 20.04的Docker容器中使用MoviePy拼接从MKV文件提取的视频片段，代码在Windows 11本地正常运行，但容器内报错：

MoviePy couldn't find the codec associated with the filename. Provide the 'codec' parameter in write_videofile.

相关代码：

combinated_video = concatenate_videoclips(clips)

video_name, extension = os.path.splitext(self.video_path)
combinated_video_path = video_name + "_combinated" + extension

combinated_video.write_videofile(combinated_video_path, codec="libx264", audio_codec="mp3")

Dockerfile已安装ffmpeg、Python3.8及MoviePy相关依赖。

解决方案 #

1. 明确指定输出文件格式 #

问题核心是容器环境中MoviePy无法通过文件扩展名自动推断正确的容器格式，需手动指定format参数：

修改write_videofile调用，添加MKV对应的格式参数：

combinated_video.write_videofile(
    combinated_video_path,
    codec="libx264",
    audio_codec="mp3",
    format="matroska"  # 或直接写format="mkv"
)

2. 调整音频编解码器（可选） #

如果仍存在兼容性问题，可将音频编解码器切换为MKV容器更通用的aac：

combinated_video.write_videofile(
    combinated_video_path,
    codec="libx264",
    audio_codec="aac",
    format="matroska"
)

3. 验证FFmpeg编解码器支持 #

进入容器检查FFmpeg是否支持所需编解码器：

docker exec -it <容器ID> bash
ffmpeg -codecs | grep libx264
ffmpeg -codecs | grep mp3

若缺少对应编解码器，可在Dockerfile的apt-get install部分添加编解码器扩展包：

libavcodec-extra

原理说明 #

Windows环境下的FFmpeg对文件扩展名兼容性更好，可自动适配MKV容器与指定编解码器；而Ubuntu 20.04容器中的FFmpeg默认配置需明确指定容器格式，避免MoviePy误判格式与编解码器的匹配关系。

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