Cypress 9.7.0在Firefox运行测试报连接失败问题咨询

问题根因说明 #

该报错出现在Cypress和Firefox建立调试连接的浏览器启动阶段，此时测试用例还未开始执行，和用例中配置的failOnStatusCode没有关联。Cypress 9.7.0版本下触发该错误的常见诱因如下：

• 版本适配冲突
  Cypress 9.x分支未完整合入高版本Firefox的适配补丁，对Firefox 100.0及以上版本的远程调试协议对接存在逻辑缺陷，无法正常识别调试目标。早期社区反馈的同类Firefox连接问题虽然标记为已修复，但相关补丁仅合入10.x及以上的正式版本线，没有反向移植到9.x版本。
• 安装路径与权限异常
  如果本地Firefox安装路径包含中文、特殊符号等非ASCII字符，或者Cypress运行进程没有Firefox安装目录、临时配置目录的读写权限，会导致Firefox启动后无法正常绑定调试端口，触发连接失败。
• 进程残留与配置损坏
  之前测试异常退出后，残留的Firefox进程会锁死临时配置目录，或是Cypress缓存的浏览器启动配置损坏，都会导致新启动的Firefox无法开启远程调试模式。
• 启动参数缺失
  部分系统环境下，默认的--browser firefox参数不会自动触发Firefox的开发者调试模式，导致Cypress找不到CDP调试目标。

分步解决方法 #

按优先级依次尝试以下操作即可：

1. 处理版本适配问题
   二选一即可：
   • 保留Cypress 9.7.0版本的话，将本地Firefox降级到98.x及以下的稳定版本，避开高版本协议不兼容问题
   • 升级Cypress到10.3.0及以上版本，该版本线已经完整适配Firefox 100+版本的调试逻辑
2. 修复路径与权限问题
   卸载Firefox后重新安装到纯英文无特殊字符的默认路径；Windows环境下用管理员身份启动终端执行测试命令，macOS/Linux环境下确保执行测试的用户对Firefox安装目录、Cypress缓存目录有完整读写权限。
3. 清理残留进程与缓存
   • 结束系统中所有残留的Firefox进程：Windows在任务管理器中结束所有firefox.exe进程，macOS/Linux直接执行命令pkill firefox
   • 执行cypress cache clear清空Cypress缓存，再执行cypress install重新补全浏览器运行依赖
4. 补全启动参数
   调整package.json中的测试脚本，手动指定开启Firefox调试模式，修改后配置如下：

   "scripts": {
     "firefoxTest": "cypress run --browser firefox:devtools"
   }
   

内容的提问来源于stack exchange，提问作者user9847788