Python3.6+FFmpeg合并长录屏音视频报错：moov atom not found

这个问题我之前帮不少开发者排查过，核心原因是你录制生成的MP4文件缺少了关键的元数据块——moov atom，它是MP4格式里记录视频轨道、时长、编码信息等核心数据的部分。短时长视频能正常工作，是因为录制工具在结束后很快就把moov atom写入了文件；但长时长录制时，如果你的Python脚本没有正确关闭录制流/文件句柄，或者缓存没及时刷新，就会导致moov atom没被写入，FFmpeg自然识别不了这个“不完整”的MP4文件。

下面是具体的解决步骤：

1. 检查并修复Python录制代码的资源释放逻辑 #

不管你用的是OpenCV、PyAV还是直接调用FFmpeg命令行录屏，必须确保录制结束后所有资源都被正确关闭，这是最常见的问题根源：

• 如果用cv2.VideoWriter录屏：

  # 录制结束后一定要调用release()
  video_writer.release()
  cv2.destroyAllWindows()
  

• 如果用PyAudio录制音频：

  # 停止流、关闭设备、关闭文件句柄
  stream.stop_stream()
  stream.close()
  pyaudio_instance.terminate()
  audio_file.close()
  

• 如果是Python调用FFmpeg命令行录屏，要确保子进程正常终止，比如用subprocess.run()而不是Popen后直接不管，或者给Popen加wait()：

  import subprocess
  # 用run()会等待进程结束
  subprocess.run([
      "ffmpeg", "-f", "x11grab", "-r", "30", "-s", "1920x1080",
      "-i", ":0.0", "-f", "alsa", "-i", "default",
      "-c:v", "libx264", "-c:a", "aac", "tmp/tmp_0.mp4"
  ])
  

2. 修复已损坏的MP4文件 #

如果已经有了损坏的MP4文件，可以用FFmpeg尝试重建moov atom：

ffmpeg -i tmp/tmp_0.mp4 -c copy -movflags faststart fixed_tmp_0.mp4

-movflags faststart参数会把moov atom移到文件开头，同时FFmpeg会自动尝试修复可恢复的元数据缺失问题，大多数情况下能救回你的视频。

3. 调整录制时的FFmpeg参数（针对直接调用FFmpeg的场景） #

如果是用FFmpeg直接录屏，建议在录制命令里加上-movflags faststart，让FFmpeg在录制过程中就处理元数据，避免结束后因异常导致元数据丢失：

ffmpeg -f x11grab -r 30 -s 1920x1080 -i :0.0 -f alsa -i default \
  -c:v libx264 -c:a aac -movflags faststart tmp/tmp_0.mp4

4. 增加录制后的文件完整性检查 #

可以在Python脚本里加一个小逻辑，录制完成后先检查文件是否正常，再进行合并操作：

import subprocess

def is_video_valid(file_path):
    # 用FFmpeg检查文件，无报错则返回True
    result = subprocess.run(
        ["ffmpeg", "-v", "error", "-i", file_path, "-f", "null", "-"],
        capture_output=True,
        text=True
    )
    return result.returncode == 0

# 录制完成后检查
video_path = "tmp/tmp_0.mp4"
if not is_video_valid(video_path):
    print("检测到视频文件损坏，尝试自动修复...")
    subprocess.run([
        "ffmpeg", "-i", video_path, "-c", "copy", "-movflags", "faststart",
        f"{video_path.replace('.mp4', '_fixed.mp4')}"
    ])
    # 后续用修复后的文件进行合并
    video_path = video_path.replace('.mp4', '_fixed.mp4')

按照上面的步骤处理后，长时长录制的视频应该就能正常被FFmpeg识别并合并了。

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