Cypress 10.6.0配置Cucumber后运行特性文件时报错求助

常见排查方向及修复步骤 #

1. 确认Cucumber依赖版本适配性 #

Cypress 10.x不再兼容旧版cypress-cucumber-preprocessor，必须使用适配Cypress 10的分支：

• 卸载旧依赖：

  npm uninstall cypress-cucumber-preprocessor
  

• 安装适配的新版依赖：

  npm install @badeball/cypress-cucumber-preprocessor @bahmutov/cypress-esbuild-preprocessor --save-dev
  

2. 校验cypress.config.js配置正确性 #

以下是适配Cypress 10.6.0的标准Cucumber配置模板，对比你的文件排查语法或配置缺失：

const { defineConfig } = require("cypress");
const createBundler = require("@bahmutov/cypress-esbuild-preprocessor");
const { addCucumberPreprocessorPlugin } = require("@badeball/cypress-cucumber-preprocessor");
const createEsbuildPlugin = require("@badeball/cypress-cucumber-preprocessor/esbuild");

module.exports = defineConfig({
  e2e: {
    specPattern: "cypress/e2e/**/*.feature", // 匹配你的feature文件路径
    async setupNodeEvents(on, config) {
      const bundler = createBundler({
        plugins: [createEsbuildPlugin(config)],
      });

      on("file:preprocessor", bundler);
      await addCucumberPreprocessorPlugin(on, config);

      return config;
    },
  },
});

• 重点检查：是否遗漏了async/await处理、模块引入是否正确、specPattern路径是否与实际文件位置匹配。

3. 清理并重新安装依赖 #

依赖冲突是常见的配置崩溃原因，执行以下步骤重置依赖：

rm -rf node_modules package-lock.json
npm install

4. 获取详细报错日志 #

运行Cypress时添加--verbose参数，打印完整错误栈，定位具体崩溃点：

npx cypress run --verbose

常见问题包括：配置文件语法错误、未安装必要依赖、Node.js版本过低（Cypress 10.6.0要求Node.js 14.x及以上）。

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