CentOS 7系统中Cypress无法检测已安装的Chromium浏览器

1. 直接指定Chromium路径运行 #

Cypress可能无法自动识别chromium-browser的位置，尝试用完整路径启动：

yarn cypress run --browser /usr/bin/chromium-browser

2. 验证Cypress与Chromium版本兼容性 #

你的Chromium版本为114.0.5735.133，需确保Cypress版本支持该版本（Cypress 12.x及以上支持Chromium 106+）。若版本过低，升级Cypress：

yarn upgrade cypress --latest

3. 手动在插件中注册Chromium并添加启动参数 #

如果自动检测失效，在cypress/plugins/index.js中手动配置浏览器并注入--disable-gpu参数：

module.exports = (on, config) => {
  // 手动将Chromium加入浏览器列表
  config.browsers.push({
    name: 'chromium',
    channel: 'stable',
    family: 'chromium',
    displayName: 'Chromium',
    version: '114.0.5735.133',
    path: '/usr/bin/chromium-browser',
    majorVersion: '114'
  })

  // 为Chromium添加--disable-gpu启动参数
  on('before:browser:launch', (browser = {}, launchOptions) => {
    if (browser.name === 'chromium') {
      launchOptions.args.push('--disable-gpu')
    }
    return launchOptions
  })

  return config
}

修改后重新执行命令：

yarn cypress run --browser chromium

4. 安装Chromium所需系统依赖 #

CentOS 7上的Chromium可能缺少必要依赖导致Cypress无法检测，执行以下命令补全依赖：

yum install -y libXScrnSaver libXrandr libXcursor libXcomposite libXdamage libXtst cups-libs libXss alsa-lib

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