Python Selenium结合FFmpeg录制测试用例视频输出始终损坏的问题排查

当前实现下录制的视频损坏，本质是两个未覆盖的流程疏漏，和FFmpeg能否正常启动无关：

• 强制终止进程跳过文件收尾流程：现有实现通过taskkill硬杀指定PID的FFmpeg进程，这种操作会直接切断进程的文件写入链路，不会触发FFmpeg的资源清理逻辑。dshow屏幕捕获模式下，FFmpeg默认会将捕获的帧暂存在内存缓冲区，只有接收到标准的退出信号时，才会将视频轨索引、时长标记、容器格式元数据写入磁盘文件。被强杀的文件仅留存零散帧数据，没有可被播放器识别的完整结构，自然无法正常播放。
• 录屏参数配置缺少容错设计：当前FFmpeg命令没有针对实时屏幕捕获场景匹配对应的缓冲、元数据参数，哪怕正常终止进程，也可能出现帧时间戳错位、文件结构不完整的问题。

替换硬杀的停止逻辑 #

摒弃直接用taskkill强杀的实现，采用“先发正常退出信号、等待进程自主退出、超时再兜底强杀”的流程：

• 启动FFmpeg子进程时，增加creationflags=subprocess.CREATE_NEW_PROCESS_GROUP参数，让FFmpeg进程独立于Python主进程的信号组，避免Python退出时连带终止录屏进程。
• 停止录制时，优先调用process.send_signal(signal.CTRL_BREAK_EVENT)给FFmpeg发送标准退出信号，预留3-5秒等待时间让FFmpeg写完所有内存缓冲区的帧、完成文件收尾操作。
• 如果等待超时后FFmpeg进程仍未自主退出，再调用taskkill命令做兜底强杀，强杀完成后要轮询确认进程完全释放目标视频文件的句柄，避免文件被进程占用导致写入截断。

调整FFmpeg启动参数 #

对现有录屏命令做三个关键参数调整，从根源降低文件损坏概率：

• 输出mp4格式时，增加-movflags +faststart参数，在文件写入初期就预留元数据存储位置，即使出现异常强杀，文件仍保留基础可播放的索引结构。
• 明确指定dshow输入源的固定帧率，比如-framerate 15，不要让FFmpeg自动适配可变帧率，避免出现时间戳错位导致的解码失败。
• 移除命令中可能降低缓冲能力的参数（比如-fflags nobuffer），给FFmpeg预留足够的写盘缓冲空间，减少高频抓屏下的写盘超时问题。

增加录制结果校验 #

每次停止录制后，调用FFmpeg的快速校验命令ffmpeg -i 输出视频路径 -f null -扫描文件完整性，如果返回非0退出码，说明文件结构损坏，直接标记本次录制失败，不要将损坏文件作为正常结果留存。

• 不要为了规避损坏问题直接选用AVI作为输出格式，AVI对强杀场景的容忍度更高，但文件体积是同内容MP4的5-10倍，不适合批量自动化测试用例的录屏存储。
• 不要将录屏输出路径设置在系统临时目录，系统自带的临时文件清理策略可能会在录制过程中删除正在写入的视频文件，导致文件截断损坏。
• 录制帧率不要设置超过24fps，Selenium的自动化操作是分步执行的，15fps的帧率足够完整记录所有操作流程，过高的帧率会增加FFmpeg的写盘压力，提升缓冲区溢出导致的写入截断概率。

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