WebdriverIO v9 在 Firefox 浏览器运行器中的连接问题分析与解决

问题现象

WebdriverIO v9.0.7 版本在使用浏览器运行器（browser runner）测试 Firefox 时出现连接超时问题。具体表现为：

1. 浏览器能够正常启动并加载 Mocha 测试框架界面
2. 测试用例始终处于加载状态（显示加载动画）
3. 命令行界面最终因超时而报错
4. 控制台显示 WebSocket 握手失败的错误信息

根本原因

通过分析错误日志，发现问题核心在于 Firefox 的安全限制导致双向通信（Bidi）连接无法建立：

1. Firefox 无法正确处理 WebSocket 连接的 Origin 头验证
2. 浏览器尝试从 127.0.0.1 连接，而服务端期望的是 localhost
3. 端口号不匹配导致连接被拒绝
4. 安全策略阻止了跨域 WebSocket 连接的建立

技术背景

WebdriverIO v9 引入了对 WebDriver BiDi 协议的支持，这是一种新的双向通信协议，相比传统的 WebDriver 协议提供了更强大的功能。然而：

1. Firefox 对 WebSocket 连接有严格的同源策略限制
2. 浏览器运行器模式下需要建立从浏览器到测试运行器的反向通信通道
3. 本地开发服务器（Vite）和浏览器之间的端口映射导致 Origin 验证失败

解决方案

开发团队已经快速响应并修复了此问题，主要采取以下措施：

1. 将所有 BiDi 命令执行转移到 Node.js 进程处理
2. 绕过了浏览器端的直接 BiDi 通信需求
3. 保持了核心测试功能的正常运行

影响与局限

当前解决方案的优缺点：

优点：

• 快速解决了 Firefox 下的测试执行问题
• 不需要用户进行额外配置
• 保持了测试功能的完整性

局限：

• 暂时无法在 Firefox 中充分利用 BiDi 协议的全部功能
• 未来需要找到绕过 Firefox 安全限制的更好方法

最佳实践建议

对于使用 WebdriverIO v9 进行跨浏览器测试的用户：

1. 及时更新到最新修复版本
2. 对于关键测试场景，可考虑暂时使用 Chrome 进行验证
3. 关注项目更新以获取完整的 BiDi 功能支持
4. 在测试配置中适当增加超时时间作为临时解决方案

总结

WebdriverIO 团队对浏览器兼容性问题响应迅速，虽然当前解决方案有一定的功能折衷，但保证了核心测试能力的可用性。这体现了该框架对跨浏览器测试场景的重视，以及解决复杂技术问题的能力。