无法在企业管控的Chrome和Edge浏览器中运行Cypress测试如何解决

问题说明 #

你遇到的报错是Cypress无法识别当前启动的浏览器为自身可控实例，报错信息如下：

This browser was not launched through Cypress. Tests cannot run.

该问题的核心原因是企业管控的Chrome/Edge会强制注入企业级扩展、覆盖默认启动参数，导致Cypress启动时添加的调试控制标识被篡改，无法完成实例校验。

可落地解决方案（无需修改企业浏览器管控规则/flags） #

方案1：连接已手动启动的浏览器实例 #

该方案绕过Cypress自动启动浏览器的逻辑，直接连接你手动启动的带调试权限的浏览器，不会触发管控拦截：

• 找到浏览器本地安装路径，命令行执行启动命令开启调试端口：
  • Chrome启动命令：
    "C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222
  • Edge启动命令：
    "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --remote-debugging-port=9222
• 在cypress.config.js中添加配置指定调试端口：

const { defineConfig } = require('cypress')
module.exports = defineConfig({
  e2e: {
    // 连接本地已启动的浏览器调试端口
    chromeWebSecurity: false,
    remoteDebuggingPort: 9222
  }
})

• 正常启动Cypress运行测试即可。

方案2：跳过Cypress的浏览器启动校验 #

直接添加环境变量关闭Cypress的「浏览器是否为自身启动」的校验逻辑，无需修改其他配置：

• Windows cmd运行命令：
  set CYPRESS_SKIP_BROWSER_LAUNCH_CHECK=1 && cypress open
• PowerShell运行命令：
  $env:CYPRESS_SKIP_BROWSER_LAUNCH_CHECK=1; cypress open
• Mac/Linux运行命令：
  CYPRESS_SKIP_BROWSER_LAUNCH_CHECK=1 cypress open

方案3：移除Cypress默认的禁用扩展参数 #

企业管控的浏览器通常会强制安装管控扩展，Cypress默认启动时会加--disable-extensions参数禁用所有扩展，和管控规则冲突导致启动失效，添加以下配置适配即可：

const { defineConfig } = require('cypress')
module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      on('before:browser:launch', (browser, launchOptions) => {
        // 过滤掉Cypress默认添加的禁用扩展相关参数
        launchOptions.args = launchOptions.args.filter(arg => 
          !['--disable-extensions', '--disable-extensions-except'].includes(arg)
        )
        return launchOptions
      })
    }
  }
})

备选方案 #

如果以上方案都无法适配管控规则，可以直接使用Cypress自带的Electron浏览器运行测试，Electron不受企业Chrome/Edge的管控规则限制，默认即可正常运行，启动时选择Electron浏览器即可。

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