Node.js assert模块未抛出传入的自定义错误实例问题

两种环境下的行为差异，本质是测试时调用的根本不是同一个函数，叠加Node.js核心模块的API行为变更导致，具体逻辑如下：

1. REPL环境的认知误区 #

Node.js交互式REPL中，如果没有手动执行const assert = require('assert')导入核心模块，直接调用assert()时，触发的并不是Node.js内置assert模块的实现，而是V8调试器注入的全局断言函数。这个函数的行为是：断言失败时直接抛出第二个参数传入的内容，不会做任何包装，这也是你在REPL里看到抛出自定义Error的原因。
在独立脚本中通过require('assert')导入模块后调用的才是Node.js核心的assert实现，和REPL里无导入调用的assert完全是两套独立逻辑。

2. 核心assert模块的行为变更 #

Node.js从v9.9.0版本开始，就废弃了“断言失败直接抛出第二参数传入的Error实例”的设计，当前版本的处理逻辑为：

• 第二参数传入字符串时，会作为默认生成的AssertionError实例的消息内容
• 第二参数传入Error实例时，不会直接抛出这个实例，而是会提取该Error的消息、堆栈信息，合并到新生成的AssertionError实例中最终抛出

你使用的Node.js v15.8.0属于已经完成上述行为调整的版本，这也是容器脚本运行时，最终捕获到的错误构造函数为AssertionError的直接原因。
这种设计调整的目的是保留AssertionError自带的调试上下文——比如实际断言值、期望值、代码定位信息等，避免直接抛出自定义Error丢失这些关键调试信息。目前大量早期教程还保留着旧版API的描述，也是造成认知偏差的常见原因。

3. 自定义错误抛出的实现方案 #

如果确实需要在断言失败时抛出传入的自定义Error实例，不能依赖核心assert模块的内置行为，可以通过两种常用方式实现：

• 极简自定义封装：绕开AssertionError的包装逻辑，直接实现判断

  const assert = (value, customError) => {
    if (!Boolean(value)) throw customError;
  }
  

• 复用核心assert的校验能力，捕获后替换抛出：

  const assert = require('assert');
  const { AssertionError } = require('assert');
  
  const assertWithCustomError = (value, opts, customError) => {
    try {
      assert(value, opts);
    } catch (err) {
      if (err instanceof AssertionError) throw customError;
      throw err;
    }
  }
  

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