如何处理Node.js中调用npm outdated命令出现执行报错的问题

根因说明 #

这并非npm违反退出码约定，而是npm outdated的预设设计行为：

• 退出码0：所有依赖均为最新版本，无可用更新
• 退出码1：命令执行成功，且检测到存在可更新的依赖
• 退出码≥2：命令实际执行失败（如参数错误、网络异常等）

Node.js内置的child_process.exec默认会将所有非0退出码判定为执行失败并抛出错误，才会出现你遇到的报错现象，但实际命令已经运行成功，报错对象的stdout字段已经返回了完整的可更新包列表。

正确处理方案 #

方案1：捕获异常后区分退出码处理 #

在catch分支中判断错误码，分别处理正常检测到更新的场景和真实错误场景：

const util = require('util');
const execPromisified = util.promisify(require('child_process').exec);

async function main() {
  try {
    const result = await execPromisified('npm outdated -g --depth=0');
    console.log('所有全局包均为最新版本');
  } catch (err) {
    // 退出码1为检测到更新的正常场景
    if (err.code === 1) {
      console.log('检测到可更新的全局包：');
      console.log(err.stdout);
    } else {
      // 其他退出码为真实执行错误
      console.error('npm outdated执行出错：', err.stderr || err.message);
    }
  }
}

main();

方案2：配置exec忽略非0退出码自动抛错逻辑 #

Node.js v15.11.0、v14.18.0及以上版本支持ignoreReturnCode配置项，开启后所有退出码都不会抛出错误，可自行判断返回结果：

const util = require('util');
const execPromisified = util.promisify(require('child_process').exec);

async function main() {
  // 开启ignoreReturnCode，禁用非0退出码自动抛错
  const result = await execPromisified('npm outdated -g --depth=0', {
    ignoreReturnCode: true
  });
  if (result.code === 0) {
    console.log('所有全局包均为最新版本');
  } else if (result.code === 1) {
    console.log('检测到可更新的全局包：');
    console.log(result.stdout);
  } else {
    console.error('命令执行出错：', result.stderr);
  }
}

main();

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