Puppeteer屏幕录制功能在非无头模式下的EOF错误分析与解决方案

问题现象

在使用Puppeteer进行浏览器自动化测试时，开发者尝试在非无头模式(headless: false)下使用page.screencast()方法进行屏幕录制，但在执行过程中遇到了"Error: write EOF"错误。该错误会导致Chrome浏览器进程意外终止，命令行界面退出。

技术背景

Puppeteer是一个Node.js库，提供高级API来控制Chromium或Chrome浏览器。page.screencast()是Puppeteer提供的一个实用方法，用于录制浏览器页面的屏幕活动并保存为视频文件。该方法底层依赖于FFmpeg进行视频编码和写入。

错误原因分析

1. 进程生命周期管理不当：原代码在process.exit事件中停止录制器和关闭浏览器，此时Node.js进程可能已经开始退出，导致写入流被意外终止。

2. FFmpeg依赖问题：屏幕录制功能需要系统安装FFmpeg，如果未正确安装或版本不兼容，可能导致写入异常。

3. 资源竞争：非无头模式下，浏览器GUI线程与录制线程可能存在资源竞争，特别是在进程退出时。

解决方案

1. 显式控制录制流程：避免在进程退出事件中执行关键操作，改为主动控制录制时长和关闭顺序。

const recorder = await page.screencast({path: "recorder.webm"});

// 显式等待一段时间
await new Promise(resolve => setTimeout(resolve, 10000));

// 先停止录制器
await recorder.stop();
// 再关闭浏览器
await browser.close();

2. 确保FFmpeg正确安装：

   • 检查系统是否安装FFmpeg
   • 确保FFmpeg在系统PATH中可用
   • 考虑使用较新的稳定版本

3. 错误处理增强：

try {
    const recorder = await page.screencast({path: "recorder.webm"});
    // ...其他操作
} catch (error) {
    console.error('录制过程中发生错误:', error);
} finally {
    if (recorder) await recorder.stop().catch(e => console.error('停止录制器失败:', e));
    if (browser) await browser.close().catch(e => console.error('关闭浏览器失败:', e));
}

最佳实践建议

1. 资源释放顺序：始终按照"先停止录制，再关闭浏览器"的顺序释放资源。

2. 录制参数优化：根据实际需求调整录制参数，如帧率、质量等，以平衡性能和输出质量。

3. 环境隔离：考虑在Docker容器中运行此类自动化任务，确保环境一致性。

4. 日志记录：增加详细的日志记录，便于问题排查。

总结

Puppeteer的屏幕录制功能在非无头模式下工作时，需要特别注意资源管理和进程生命周期控制。通过显式控制操作顺序、确保环境依赖正确安装以及增强错误处理，可以有效避免EOF写入错误的发生。对于需要长时间运行的录制任务，建议采用更健壮的任务管理机制，如使用PM2等进程管理工具来维护Node.js应用的稳定性。