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. 资源锁定问题：当Puppeteer尝试清理临时用户配置文件时，某些文件仍被系统或Chrome进程锁定，导致无法删除。

2. 不当的浏览器关闭顺序：开发者错误地先调用browser.disconnect()再调用browser.close()，这会中断CDP连接，导致浏览器进程无法被正常关闭。

3. 残留进程：即使主浏览器窗口关闭，Chrome后台进程可能仍在运行，锁定相关资源文件。

4. 并发操作冲突：在多页面或并行测试场景中，不同页面可能同时访问同一资源文件。

解决方案

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

避免使用disconnect()和close()的组合调用。正确的做法是：

// 正确方式
await browser.close();

browser.close()方法会优雅地关闭浏览器及其所有相关进程，确保资源被正确释放。

2. 确保所有页面已关闭

在关闭浏览器前，确保所有打开的页面已被正确关闭：

const pages = await browser.pages();
for (const page of pages) {
    await page.close();
}
await browser.close();

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

为每个测试实例指定独立的用户数据目录，避免冲突：

const browser = await puppeteer.launch({
    userDataDir: './my_custom_profile'
});

4. 进程清理

在Windows系统上，可以通过任务管理器检查并终止所有Chrome相关进程：

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

5. 临时文件清理

手动删除Puppeteer的临时配置文件目录：

C:\Users\[用户名]\AppData\Local\Temp\puppeteer_dev_chrome_profile-*

最佳实践建议

1. 错误处理：在代码中添加适当的错误处理逻辑，捕获并处理可能的资源锁定异常。

2. 资源释放：使用try-finally块确保资源被正确释放：

let browser;
try {
    browser = await puppeteer.launch();
    // 测试代码
} finally {
    if (browser) {
        await browser.close();
    }
}

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

4. 环境隔离：考虑使用容器化技术(如Docker)为每个测试运行提供隔离的环境。

总结

Puppeteer中的EBUSY错误通常源于资源管理不当。通过遵循正确的浏览器关闭流程、确保资源释放、以及采用适当的错误处理策略，开发者可以有效避免这类问题。理解Puppeteer的工作原理和资源管理机制，有助于编写更健壮的自动化测试脚本。