Node ESM模块报错时如何获取导入来源的栈追踪信息？

针对Node.js 16/18版本中ESM模块错误栈缺失导入来源的问题，可以通过以下几种方式获取完整的导入链信息：

1. 使用--trace-uncaught命令行参数 #

这是最快捷的方式，无需修改代码。执行时添加该参数：

node --trace-uncaught foo.mjs

该参数会强制输出未捕获错误的完整调用链，包括触发导入的上游模块（比如foo.mjs），能直接看到bar.mjs是被哪个模块导入的。

2. 自定义ESM加载器追踪导入关系 #

如果需要更灵活的追踪，可以编写一个实验性ESM加载器，在模块加载时记录导入链路，并在错误发生时附加相关信息：

创建trace-loader.mjs文件：

import { readFile } from 'fs/promises';
import { fileURLToPath } from 'url';

const importChainMap = new Map();

export async function load(url, context, nextLoad) {
  const result = await nextLoad(url, context);
  
  // 记录当前模块的导入来源
  if (context.parentURL) {
    const currentPath = fileURLToPath(url);
    const parentPath = fileURLToPath(context.parentURL);
    if (!importChainMap.has(currentPath)) {
      importChainMap.set(currentPath, []);
    }
    importChainMap.get(currentPath).push(parentPath);
  }

  // 包装模块代码，错误时附加导入链
  if (result.format === 'module') {
    const source = await readFile(fileURLToPath(url), 'utf8');
    const wrappedSource = `
      try {
        ${source}
      } catch (err) {
        err.importedBy = ${JSON.stringify(importChainMap.get(fileURLToPath(url)) || [])};
        throw err;
      }
    `;
    return { ...result, source: wrappedSource };
  }

  return result;
}

执行时启用该加载器：

node --experimental-loader ./trace-loader.mjs foo.mjs

此时抛出的错误会携带importedBy属性，显示当前模块的所有导入来源。

3. 升级到Node.js 20+版本 #

Node.js 20及后续版本对ESM错误栈做了优化，默认会在栈追踪中包含导入来源模块。例如执行node foo.mjs后，栈信息会明确显示foo.mjs是导入bar.mjs的上游模块，无需额外配置。

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