Protractor如何调试未处理的Promise Rejection，能否使用--unhandled-rejections参数

解决方案 #

1. 在Protractor中使用--unhandled-rejections=strict flag的方法 #

因为Protractor是基于Node.js运行的，你可以通过两种方式传入该Node CLI参数：

• 方式一：通过环境变量传入，执行测试命令时加上前缀即可：
  类Unix系统（Linux/macOS）：

  NODE_OPTIONS="--unhandled-rejections=strict" protractor 你的配置文件路径.js
  

  Windows CMD：

  set NODE_OPTIONS=--unhandled-rejections=strict && protractor 你的配置文件路径.js
  

  Windows PowerShell：

  $env:NODE_OPTIONS="--unhandled-rejections=strict"; protractor 你的配置文件路径.js
  

• 方式二：直接在Protractor配置文件中开启严格模式，在配置的onPrepare钩子中添加全局监听逻辑，效果和传入flag一致。

2. 调试定位未处理Promise异常的方法 #

• 首先在Protractor配置文件的onPrepare钩子中添加全局异常捕获代码，输出完整的错误堆栈和上下文：

process.on('unhandledRejection', (reason, promise) => {
  console.error('=== 未捕获的Promise拒绝信息 ===');
  console.error('关联Promise对象:', promise);
  console.error('拒绝原因堆栈:', reason?.stack || reason);
  // 直接抛出错误终止进程，避免错误扩散影响后续测试
  throw reason;
});

• 修改配置文件开启调试级别的日志，添加配置项logLevel: 'DEBUG'，可以看到报错前最后执行的测试用例、页面操作步骤，快速缩小范围。
• 由于问题是合并大量PR后出现的，优先排查近期新增的异步逻辑：检查所有async函数是否都正确添加了await调用、是否存在返回Promise的方法没有挂载catch处理的情况，尤其是新增的页面对象方法、工具类异步函数。
• 采用二分法隔离测试套件：每次仅运行一半的测试用例，确认问题所属的模块范围，不需要每次全量运行4小时的完整测试，大幅提升定位效率。

内容的提问来源于stack exchange，提问作者Gabriel Santos Carvalho