为何Resolve Hook在CommonJS的require调用中未执行？

问题分析 #

你的自定义resolve钩子能正常拦截ESM的import fs，但无法拦截CommonJS的require('fs')，核心原因有两个：

1. Node.js默认对核心模块（如fs）的require调用会绕过自定义加载钩子，直接加载内置模块
2. 原钩子未明确处理CommonJS模块的解析流程，且路径处理存在错误

修正后的Resolve钩子实现 #

先修正原钩子的路径处理逻辑，同时添加CommonJS拦截逻辑，确保覆盖所有模块加载场景：

import { dirname, join } from 'node:path';
import { fileURLToPath } from 'node:url';

export async function resolve(specifier, context, nextResolve) {
  // 精准拦截核心模块fs的请求（包含ESM import和CommonJS require）
  if (/^fs$/.test(specifier)) {
    // 将父模块的URL转换为本地文件路径
    const parentPath = fileURLToPath(context.parentURL);
    const parentDir = dirname(parentPath);
    // 拼接fake.js的绝对路径并转为URL格式
    const fakeFsPath = join(parentDir, 'fake.js');
    const fakeFsURL = new URL(`file://${fakeFsPath}`);
    
    // 返回自定义解析结果，设置shortCircuit绕过默认核心模块加载逻辑
    return {
      url: fakeFsURL.href,
      shortCircuit: true
    };
  }

  // 其他模块请求沿用默认解析流程
  return nextResolve(specifier, context);
}

关键配置调整 #

1. 强制钩子前置执行
   使用node:module#register时，传入{ enforce: 'pre' }参数，确保钩子优先于Node.js默认的模块解析逻辑运行：

   // 注册钩子的ESM脚本（示例：register-hooks.js）
   import { register } from 'node:module';
   import { fileURLToPath } from 'node:url';
   import { dirname, join } from 'node:path';
   
   const hookFilePath = join(dirname(fileURLToPath(import.meta.url)), 'your-hook-file.js');
   register(hookFilePath, { enforce: 'pre' });
   

2. 启动命令配置
   保持使用--import选项加载注册脚本，确保钩子在应用启动时生效：

   node --import ./register-hooks.js your-entry-file.js
   

额外注意事项 #

• 确保fake.js兼容CommonJS规范（适配第三方依赖的require调用），示例：

  // fake.js
  module.exports = {
    readFileSync: () => 'Mocked content from fake fs module'
  };
  

• Node.js v20及以上版本无需额外启用实验性标志，低版本可添加--experimental-modules确保钩子功能正常
• 该方案会拦截所有模块（包括第三方依赖）中的require('fs')调用，无需修改依赖源码

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