Puppeteer项目中的EBUSY资源占用问题分析与解决

问题现象

在使用Puppeteer进行浏览器自动化测试时，开发者可能会遇到一个常见的错误："EBUSY: resource busy or locked"。这个错误通常会在尝试删除或修改临时用户配置文件时出现，具体表现为无法删除lockfile或first_party_sets.db等文件。

错误信息通常如下所示：

[Error: EBUSY: resource busy or locked, unlink 'C:\Users\admin\AppData\Local\Temp\puppeteer_dev_chrome_profile-SdOHTX\lockfile'] {
  errno: -4082,
  code: 'EBUSY',
  syscall: 'unlink',
  path: 'C:\\Users\\admin\\AppData\\Local\\Temp\\puppeteer_dev_chrome_profile-SdOHTX\\lockfile'
}

问题根源

经过深入分析，这个问题通常由以下几个原因导致：

1. 浏览器进程未完全关闭：即使开发者调用了browser.close()，Chrome进程可能仍在后台运行，导致相关资源被锁定。

2. 错误的关闭顺序：有些开发者会先调用browser.disconnect()再调用browser.close()，这会中断与浏览器的通信，导致无法正确关闭浏览器进程。

3. 异步操作未正确处理：在关闭页面或浏览器时，如果没有正确使用await，可能导致资源释放不完全。

4. 临时文件权限问题：Windows系统下，临时文件夹中的文件可能被系统或其他进程锁定。

解决方案

1. 正确的浏览器关闭方式

确保使用正确的关闭顺序和方法：

// 正确做法
await browser.close();

// 错误做法（会导致问题）
browser.disconnect();
browser.close();

2. 确保异步操作完成

在关闭浏览器前，确保所有异步操作都已完成：

// 确保页面操作完成
await page.waitForSelector('video');
await page.close();

// 然后再关闭浏览器
await browser.close();

3. 使用自定义用户数据目录

可以尝试指定一个固定的用户数据目录，而不是使用临时目录：

const browser = await puppeteer.launch({
  userDataDir: './my_profile',
  channel: 'chrome',
  headless: false
});

4. 清理残留进程

在Windows系统下，可以手动检查并终止残留的Chrome进程：

1. 打开任务管理器
2. 查找所有chrome.exe进程
3. 结束这些进程

5. 异常处理

添加适当的异常处理逻辑，确保即使出现错误也能正确释放资源：

try {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  // 执行操作...
} catch (error) {
  console.error('发生错误:', error);
} finally {
  if (browser) {
    await browser.close().catch(() => {});
  }
}

最佳实践建议

1. 单一关闭点：尽量在一个地方关闭浏览器，而不是分散在代码各处。

2. 资源监控：在开发过程中，可以使用任务管理器监控Chrome进程，确保它们被正确关闭。

3. 超时设置：为关键操作设置合理的超时时间，避免长时间等待导致资源占用。

4. 环境隔离：考虑使用Docker等容器技术来隔离测试环境，避免系统级资源冲突。

5. 日志记录：添加详细的日志记录，帮助追踪资源释放的完整生命周期。

总结

Puppeteer中的EBUSY错误通常源于资源释放不完全或浏览器关闭不当。通过遵循正确的关闭顺序、确保异步操作完成、使用自定义用户目录以及添加适当的异常处理，可以有效解决这类问题。对于复杂的自动化测试场景，建议建立完善的资源管理机制，确保每次测试后都能彻底清理环境。