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

问题现象

在使用Puppeteer进行网页自动化测试时，开发者尝试在非无头模式(headless: false)下调用page.screencast()方法进行屏幕录制，却遇到了"Error: write EOF"错误，导致Chrome浏览器进程异常终止。

技术背景

Puppeteer是Google Chrome团队维护的一个Node.js库，提供对Chromium/Chrome浏览器的高级API控制。其屏幕录制功能依赖于底层的FFmpeg多媒体框架，通过捕获浏览器页面内容并编码为视频文件。

错误原因分析

根据问题描述和协作者的验证，可以得出以下关键点：

1. FFmpeg依赖问题：屏幕录制功能需要系统已安装FFmpeg，且版本需要兼容当前Puppeteer版本

2. 进程生命周期管理：原代码在process.exit事件中停止录制，此时Node.js进程可能已经开始关闭I/O通道，导致写入操作失败

3. 资源释放顺序：未正确处理录制器、页面和浏览器实例的关闭顺序，可能造成资源竞争

解决方案

1. 确保FFmpeg正确安装：

   • 在Windows系统上，需要将FFmpeg添加到系统PATH环境变量
   • 可通过命令行执行ffmpeg -version验证安装是否成功

2. 优化资源管理代码：

async function safeShutdown(recorder, browser) {
    try {
        if (recorder) await recorder.stop();
    } catch (e) {
        console.error('停止录制时出错:', e);
    }
    try {
        if (browser) await browser.close();
    } catch (e) {
        console.error('关闭浏览器时出错:', e);
    }
}

3. 使用显式控制流：

   • 避免依赖process.exit事件
   • 设置明确的录制时长或通过用户交互触发停止

4. 错误处理增强：

page.on('error', err => console.error('页面错误:', err));
page.on('pageerror', err => console.error('页面脚本错误:', err));
browser.on('disconnected', () => console.log('浏览器断开连接'));

最佳实践建议

1. 录制参数优化：

   • 根据实际需求调整帧率和视频质量
   • 考虑添加options参数控制录制行为

2. 内存管理：

   • 长时间录制时监控内存使用情况
   • 考虑分段录制大文件

3. 跨平台兼容性：

   • 不同操作系统可能需要不同的FFmpeg配置
   • 测试时覆盖主要目标平台

总结

Puppeteer的屏幕录制功能在非无头模式下出现EOF错误，通常与资源管理不当或FFmpeg配置问题有关。通过确保正确安装依赖、优化关闭流程以及增强错误处理，可以稳定地实现页面录制功能。开发者应当特别注意Node.js进程生命周期与浏览器实例管理的协调，避免在进程退出阶段执行关键操作。