Nightwatch.js始终返回退出码1，Jenkins集成测试结果判定异常求解决

我之前也踩过这个版本组合（nightwatch@0.9.19 + nightwatch-cucumber@9.0.0）的坑，这个版本的nightwatch-cucumber确实存在一个已知的兼容性问题：它不会正确传递Nightwatch的测试结果退出码，导致不管测试通过与否，最终都返回1。下面是几个亲测有效的解决方案：

方案1：修改Cucumber配置启用严格模式 #

在你的Nightwatch配置文件（比如nightwatch.conf.js）里，给cucumberOpts添加strict: true配置项，这会让Cucumber在任何测试步骤失败时返回非0退出码，全部通过时则返回0：

module.exports = {
  // 你的其他Nightwatch配置
  cucumberOpts: {
    // 已有的配置...
    strict: true, // 关键配置：启用严格模式，让Cucumber正确返回对应退出码
    format: 'json:reports/cucumber.json' // 可选：生成报告文件用于后续结果验证
  }
};

方案2：自定义脚本手动处理退出码 #

如果方案1不生效，可以写一个简单的Node.js脚本，手动执行测试并根据结果返回正确的退出码：

1. 创建run-nightwatch-tests.js文件：

const { exec } = require('child_process');
const fs = require('fs');

// 执行Nightwatch测试
exec('nightwatch', (error, stdout, stderr) => {
  // 输出测试日志到控制台，方便Jenkins查看
  console.log(stdout);
  if (stderr) console.error(stderr);

  // 读取Cucumber生成的JSON报告（需先在配置里开启format生成该文件）
  try {
    const report = JSON.parse(fs.readFileSync('./reports/cucumber.json', 'utf8'));
    // 检查是否存在失败的测试步骤
    const hasFailures = report.some(feature => 
      feature.elements.some(scenario => 
        scenario.steps.some(step => step.result.status === 'failed')
      )
    );
    // 根据测试结果返回对应退出码
    process.exit(hasFailures ? 1 : 0);
  } catch (readError) {
    // 若读取报告失败，默认返回失败状态
    process.exit(1);
  }
});

2. 在Jenkins的构建步骤里，把原来直接调用nightwatch的命令改成：

node run-nightwatch-tests.js

方案3：检查Nightwatch调用命令的参数 #

确保你的Nightwatch调用命令没有添加会强制返回非0的参数，比如--fail-fast或者错误的reporter配置。如果使用了自定义reporter，要确认它不会覆盖默认的退出码逻辑。

另外，这个版本的nightwatch-cucumber和Nightwatch兼容性确实有限，如果项目允许，升级到更高版本的nightwatch-cucumber（比如v11+）和Nightwatch（v1.x+）会从根本上解决这类退出码问题，但如果因为依赖限制不能升级，上面的两个方案应该能解决你的问题。

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