TestCafe 项目在 macOS 上运行 Chrome 130 时出现启动失败问题的分析与解决方案

问题背景

TestCafe 是一个流行的 Node.js 端到端测试框架，它允许开发者在多种浏览器中运行自动化测试。近期，在 macOS 系统上使用 Chrome 130 版本（130.0.6723.59）运行 TestCafe 测试时，用户报告了一个严重的启动问题。

问题现象

当用户尝试在 macOS 14.4.1 系统上使用 Chrome 130 运行 TestCafe 测试时，浏览器会短暂打开几毫秒后立即关闭。测试框架无法正常初始化，最终导致测试执行失败。

从调试日志中可以观察到几个关键错误信息：

1. WebSocket 连接意外关闭
2. 无法正确处理 Chrome 配置文件锁文件
3. 浏览器初始化过程中出现异常终止

根本原因分析

经过技术团队深入调查，发现问题主要源于以下几个方面：

1. Chrome 130 版本兼容性问题：新版本的 Chrome 浏览器对远程调试协议做了某些调整，导致 TestCafe 原有的连接机制失效。

2. 锁文件处理异常：在浏览器进程异常终止时，TestCafe 无法正确清理临时目录中的锁文件（.testcafe-lockfile），这会导致后续测试运行尝试时出现资源冲突。

3. WebSocket 连接稳定性：浏览器启动后，TestCafe 通过 WebSocket 与 Chrome 的远程调试端口建立连接，但在 Chrome 130 中这个连接会意外中断。

解决方案

TestCafe 开发团队已经在新版本 3.7.0-rc.1 中修复了这个问题。升级到该版本后，用户可以正常在 Chrome 130 上运行测试。

对于暂时无法升级的用户，可以考虑以下临时解决方案：

1. 使用其他浏览器：如 Microsoft Edge，它基于 Chromium 但可能不受此特定问题影响。

2. 降级 Chrome 版本：回退到 Chrome 129 或更早版本可以避免此问题。

3. 手动清理临时文件：在测试失败后，手动删除 /var/folders/ 下的 TestCafe 临时目录可以防止锁文件残留问题。

技术细节

这个问题的修复涉及 TestCafe 核心的多个组件：

1. 浏览器连接模块：改进了 WebSocket 连接的重试机制和错误处理。

2. 锁文件管理：增强了临时目录和锁文件的清理逻辑，确保在异常情况下也能正确释放资源。

3. Chrome 启动参数：优化了浏览器启动时的命令行参数，提高了与新版本 Chrome 的兼容性。

最佳实践建议

为了避免类似问题，建议用户：

1. 保持 TestCafe 和浏览器版本同步更新
2. 在升级浏览器前，先检查 TestCafe 的兼容性说明
3. 定期清理系统临时目录中的 TestCafe 残留文件
4. 对于关键测试环境，考虑使用固定版本的浏览器以避免意外兼容性问题

结论

浏览器自动化测试框架与浏览器本身的兼容性是一个持续演进的挑战。TestCafe 团队通过快速响应和发布修复版本，展示了他们对用户体验的重视。开发者应当关注框架更新，并及时应用重要修复，以确保测试环境的稳定性。