Node.js 10+版本await未触发自定义Promise.then钩子问题排查

你遇到的跨版本行为差异，本质是两个层面的共同作用，不是你代码写的逻辑有绝对错误，而是和V8引擎的实现变更、原生对象的优化逻辑强相关：

• 版本差异的核心原因：V8从Node12对应的版本开始，对await处理原生Promise的流程做了对齐ES规范的性能优化。Node10及更早版本中，await对所有值都会统一走thenable检查流程，会沿对象属性链查找自定义的then方法，因此你在实例上覆盖的then钩子可以被触发；Node12及之后的V8版本中，一旦检测到await接收的是原生构造函数生成的Promise实例，引擎会直接读取Promise内部的状态数据，完全跳过JS层的属性查找、then方法调用流程，直接返回最终值。这个行为是规范要求的正确实现，老版本的触发行为反而属于早期实现的合规性疏漏。
• 你现有代码的冗余问题：代码段里的const clone = Object.create(aPromise)和无返回值的_then.bind(aPromise)都是无效逻辑，既没有参与钩子的调用流程，也没有实际改变原型链结构，只是因为碰巧覆盖了原生Promise实例的自有then属性，才在老版本环境下触发了钩子。

V8对原生Promise的await快速优化路径，会直接跳过对象的自有属性查找环节：只要确认当前await的目标是Promise构造函数生成的实例，引擎就不会检查实例上是否有自定义的then自有属性，直接复用内部的异步状态。这也是你在Node12、14中没有看到then called打印的直接原因。

快速验证：把测试代码里的await aPromise改成await clone，在Node12、14环境下依然可以正常触发then钩子。因为clone不是原生Promise构造函数生成的实例，V8不会对它应用快速优化路径，还是会按通用thenable的处理逻辑查找then方法执行。

如果要让then方法的拦截在显式调用、await隐式调用两种场景下全版本生效，不能把钩子加在单个Promise实例的自有属性上，需要直接修改Promise.prototype上的原生then方法：

// 保存原生then方法的引用
const originalThen = Promise.prototype.then;

// 挂载全局钩子
Promise.prototype.then = function (onFulfilled, onRejected) {
  console.log('then called');
  return originalThen.apply(this, arguments);
};

async function func() {
  const aPromise = new Promise((resolve) => {
    setTimeout(() => { resolve(123); }, 100);
  });

  const result = await aPromise;
  console.log('Log:', result);
}

func();

这种实现方式的兼容性：

• 对所有Node10、12、14+版本生效，因为V8的快速优化路径最终也是调用原型链上的then方法，修改原型上的原生方法后，引擎查找时会直接拿到你的自定义钩子
• 同时覆盖显式链式调用aPromise.then(...)和await隐式触发两种场景

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