Cypress-Cucumber框架标签测试用例执行异常，求助解决方案

核心问题原因 #

1. 依赖冲突：同时安装了废弃的旧版cypress-cucumber-preprocessor（v4）和官方维护的新版@badeball/cypress-cucumber-preprocessor（v21），两者标签过滤逻辑不兼容，导致配置失效。
2. 配置键名错误：package.json中的配置使用了旧插件的键名cypress-cucumber-preprocessor，新版插件需要使用@badeball/cypress-cucumber-preprocessor作为配置键。
3. 标签参数格式错误：新版插件不支持直接使用tags命令行参数，需通过cucumberTags环境变量传递过滤条件。

分步解决方案 #

1. 清理冲突依赖 #

删除旧版插件，保留官方维护的新版：

npm uninstall cypress-cucumber-preprocessor

2. 修正配置文件 #

方式一：更新package.json配置

将原配置的键名替换为新版插件的命名空间：

{
  "@badeball/cypress-cucumber-preprocessor": {
    "filterSpecs": true,
    "omitFiltered": true,
    "nonGlobalStepdefinitions": false,
    "stepDefinitions": ["cypress/e2e/Stepdefinitions/**/*.{js,ts}"]
  }
}

方式二：推荐在cypress.config.js中配置（更直观）

修改cypress.config.js，集成预处理器并配置过滤逻辑：

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: {
    async setupNodeEvents(on, config) {
      // 配置ESBuild预处理器
      const bundler = createBundler({
        plugins: [createEsbuildPlugin(config)],
      });
      on("file:preprocessor", bundler);

      // 集成Cucumber预处理器
      await addCucumberPreprocessorPlugin(on, config);

      return config;
    },
    // 指定feature文件路径
    specPattern: "cypress/e2e/features/**/*.feature",
  },
});

3. 修正执行命令 #

将tags="@smoke"替换为cucumberTags="@smoke"并合并到环境变量中：

npx cypress run --record --key <你的录制密钥> --browser chrome --spec cypress/e2e/features/regression --env JIRA_USERNAME=<jira_username>,JIRA_API_TOKEN=<jira_apitoken>,XRAY_CLIENT_ID=<xray_clientid>,XRAY_CLIENT_SECRET=<xray_clientsecret>,cucumberTags="@smoke"

4. 验证过滤效果 #

运行简化命令测试过滤逻辑（可先关闭录制功能）：

npx cypress run --browser chrome --spec cypress/e2e/features/regression --env cucumberTags="@smoke" --verbose

查看日志输出，确认仅加载带@smoke标签的2个Scenario。

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