使用PyAV按指定帧率生成视频时长偏短的问题排查

AI 小北

2026-7-23

PyAV生成视频丢帧问题解决方法

你的代码遗漏了编码器收尾操作，这是导致帧丢失、时长缩短的核心原因，另外推荐显式设置时间基来避免潜在的时间戳偏差。

问题分析

H.264这类基于帧间预测的编码器会缓存部分帧以优化压缩效果，循环结束后这些缓存帧不会自动输出，直接关闭容器会导致这部分帧丢失。同时，未显式设置时间基可能让编码器对帧的时间戳计算出现偏差（虽然元数据帧率显示正确，但实际帧时序可能出错）。

修正后的代码

def save_video(video_name, imlist, framerate, bitrate):
    container = av.open(video_name, mode='w')
    stream = container.add_stream('h264', framerate)
    stream.codec_context.bit_rate = bitrate * 1e3  # Bitrate in kbps
    stream.width = image_width
    stream.height = image_height    
    stream.pix_fmt = 'yuv420p'
    # 显式设置时间基，确保帧率与帧时序对应
    stream.time_base = av.time_base.AV_TIME_BASE_Q

    for image in imlist:
        image = av.VideoFrame.from_ndarray(image)
        # 为帧设置正确的时间戳，基于帧率和时间基计算
        image.pts = stream.next_pts()
        packet = stream.encode(image)
        if packet:
            container.mux(packet)
    
    # 关键：获取编码器缓存的剩余帧
    while True:
        packet = stream.encode(None)
        if not packet:
            break
        container.mux(packet)
    
    container.close()

关键修改点

添加stream.time_base = av.time_base.AV_TIME_BASE_Q：显式设置时间基为FFmpeg的默认时间基，让帧的时间戳计算更准确。
为每个帧设置image.pts = stream.next_pts()：确保每帧的时间戳按序列递增，避免编码器丢弃时序异常的帧。
循环结束后添加stream.encode(None)的循环：强制编码器输出所有缓存的帧，这是解决丢帧的核心步骤。