MacOS下PyInstaller编译无控制台App时MoviePy WriteVideoFile失效

问题背景 #

• 预期：控制台运行脚本时，MoviePy可正常写入视频文件，无报错
• 实际：使用PyInstaller --noconsole编译后，MacOS环境下程序在音频写入环节崩溃，报错BrokenPipeError: [Errno 32] Broken pipe；Windows平台无此问题
• 触发条件：仅无控制台模式的打包程序会出现该异常

问题原因 #

无控制台模式下，Python的标准输入/输出/错误流（stdin/stdout/stderr）被关闭或重定向，而MoviePy调用的FFmpeg进程依赖这些流进行通信，导致管道连接断裂，最终在FFMPEG_AudioWriter的__del__方法触发异常。

解决方案 #

1. 避免直接重定向标准输出 #

代码中直接替换sys.stdout为文件的操作会破坏FFmpeg依赖的流环境，改用logging模块记录日志，保留原始标准流：

import logging

def save_video(self):
    clip = self.save_clip()
    directory = filedialog.asksaveasfilename(
        filetypes=(('MP4', '*.mp4'),('All Files', '*.*')),
        defaultextension='.mp4',
        initialdir=f'{os.path.expanduser}/Downloads',
        title="Video Clip",
        initialfile="clip"
    )
    if not directory:
        self.progress_bar_stop()
        return
    try:
        # 配置日志到文件
        logging.basicConfig(
            filename=f'{self.downloads}/logger.txt',
            level=logging.INFO,
            format='%(asctime)s - %(message)s'
        )
        # 写入视频时禁用MoviePy进度日志，避免流冲突
        clip.write_videofile(
            directory,
            audio_codec='aac',
            logger=None
        )
        self.progress_bar_stop()
        messagebox.showinfo(title="Success!", message=f'Clip Saved: {directory}')
    except Exception as e:
        logging.error(f"保存失败: {str(e)}")
        messagebox.showerror(message='视频剪辑保存失败，请重新上传视频后重试。')

2. 手动关闭音频写入器 #

在write_videofile执行完成后，手动获取并关闭音频写入器，避免__del__方法触发异常：

def save_video(self):
    # ... 前面的路径选择代码 ...
    try:
        clip.write_videofile(directory, audio_codec='aac', logger=None)
        # 手动关闭音频写入器（如果存在）
        if hasattr(clip, 'audio') and clip.audio is not None:
            if hasattr(clip.audio, 'writer'):
                clip.audio.writer.close()
        self.progress_bar_stop()
        messagebox.showinfo(title="Success!", message=f'Clip Saved: {directory}')
    except Exception as e:
        # ... 异常处理代码 ...

3. PyInstaller打包时指定FFmpeg路径 #

MacOS下打包时，确保PyInstaller能正确找到MoviePy依赖的FFmpeg可执行文件，使用以下打包命令：

PyInstaller --noconsole --add-data "$(python -c "import moviepy; print(moviepy.config.FFMPEG_BINARY)"):." your_script.py

也可以在代码中手动指定FFmpeg路径：

import moviepy.config as mp_config
mp_config.FFMPEG_BINARY = '/usr/local/bin/ffmpeg'  # 替换为你的FFmpeg实际路径

4. 捕获__del__方法中的异常 #

通过猴子补丁修改FFMPEG_AudioWriter的__del__方法，避免异常导致程序崩溃：

from moviepy.audio.io.ffmpeg_audiowriter import FFMPEG_AudioWriter

original_del = FFMPEG_AudioWriter.__del__

def safe_del(self):
    try:
        original_del(self)
    except BrokenPipeError:
        pass

FFMPEG_AudioWriter.__del__ = safe_del

将这段代码放在程序入口处（比如if __name__ == '__main__':之前）。

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