NodeJS Jest测试：require.main.require路径问题求解

问题原因 #

当Jest运行__test__目录下的测试文件时，require.main指向的是Jest自身的执行入口，而非项目根目录的主文件。这导致require.main.require('./models/UserModel')会从Jest的执行路径去解析相对路径，自然找不到项目里的模块。而测试文件放在根目录时，Jest的工作目录是项目根，所以路径解析正常。

解决方案 #

方案1：替换require.main.require为可靠路径导入 #

直接放弃require.main.require，改用普通相对路径或基于__dirname的绝对路径，确保模块路径解析不受执行环境影响：

// index.js
const path = require('path');
// 用__dirname拼接绝对路径，无论在哪执行都能定位到模块
const { getUserById } = require(path.resolve(__dirname, './models/UserModel'));

function checkUser(id) {
  const user = getUserById(id);
  return user ? 'Found' : 'Not Found';
}

module.exports.checkUser = checkUser;

这个方法简单直接，无需修改测试配置，彻底避免require.main带来的环境依赖问题。

方案2：配置Jest的根目录与模块路径 #

在项目根目录创建jest.config.js，指定Jest的工作根目录，并添加模块路径别名，让相对路径解析始终基于项目根：

// jest.config.js
module.exports = {
  rootDir: './',
  modulePaths: ['<rootDir>']
};

之后业务代码中可以使用基于根目录的绝对路径导入：

// index.js
const { getUserById } = require('<rootDir>/models/UserModel');

这个方案适合大型项目，能统一模块导入的路径规则。

方案3：在测试中修改require.main指向 #

在测试文件开头手动将require.main指向项目主文件，强制路径解析基于项目根：

// __test__/sample.fail.test.js
// 先修改require.main指向项目根目录的index.js
require.main = require('../index');
// 再导入业务模块
const { checkUser } = require('../index');

console.log(checkUser);

describe('Testing...', () => {
  it('Should pass', () => {
    expect(0).toBe(0);
  });
});

注意：该方法可能影响其他依赖require.main的逻辑，仅适合临时兼容或无法修改业务代码的场景。

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