使用MoviePy+FFmpeg NVENC硬件加速生成损坏MP4的问题

核心原因分析 #

出现全黑视频但元数据正常，大概率是像素格式不兼容导致的：MoviePy默认输出的RGB帧格式和NVENC编码器要求的YUV格式不匹配，或者最终输出的像素格式不被播放器支持（比如非yuv420p）。另外，MoviePy传递给FFmpeg的参数可能和你手动执行的命令存在差异。

分步解决方案 #

1. 强制指定像素格式与匹配编码参数 #

在write_videofile调用中，明确添加像素格式参数和与手动命令一致的编码选项，确保FFmpeg接收到的参数和你测试通过的命令对齐：

from moviepy.editor import *

# 假设你的CompositeVideoClip已经创建完成
final_clip = CompositeVideoClip([video_clip, subtitle_clip])

final_clip.write_videofile(
    "output.mp4",
    codec='h264_nvenc',
    ffmpeg_params=[
        '-pix_fmt', 'yuv420p',  # 强制输出兼容播放器的像素格式
        '-preset', 'fast',       # 和你手动命令一致的预设
        '-b:v', '1M',            # 视频比特率
        '-c:a', 'aac'            # 音频编码
    ],
    audio_codec='aac'
)

2. 确认FFmpeg路径配置正确 #

确保代码中指定的FFmpeg路径是Gyan版的可执行文件绝对路径，避免调用系统默认的无NVENC支持的FFmpeg：

import moviepy.config as mp_config

# 设置为你的Gyan版FFmpeg绝对路径
mp_config.change_settings({"FFMPEG_BINARY": r"C:\ffmpeg\bin\ffmpeg.exe"})

注意路径要用原始字符串（加r前缀），避免转义字符问题。

3. 验证单视频编码是否正常 #

先跳过CompositeVideoClip，用单个VideoFileClip测试NVENC编码是否正常：

test_clip = VideoFileClip("input.mp4")
test_clip.write_videofile(
    "test_output.mp4",
    codec='h264_nvenc',
    ffmpeg_params=['-pix_fmt', 'yuv420p'],
    audio_codec='aac'
)

如果测试视频正常，说明问题出在CompositeVideoClip的帧处理上，此时可以先将CompositeVideoClip渲染为临时未压缩视频，再用NVENC编码：

# 先渲染未压缩临时文件
final_clip.write_videofile(
    "temp_raw.mp4",
    codec='rawvideo',
    pix_fmt='rgb24'
)

# 再用NVENC编码临时文件
temp_clip = VideoFileClip("temp_raw.mp4")
temp_clip.write_videofile(
    "final_output.mp4",
    codec='h264_nvenc',
    ffmpeg_params=['-pix_fmt', 'yuv420p', '-preset', 'fast'],
    audio_codec='aac'
)

4. 检查MoviePy版本兼容性 #

确保你使用的是最新版MoviePy，旧版本可能对NVENC参数的传递存在bug：

pip install --upgrade moviepy

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