Jest与Node.js模块路径解析顺序差异引发依赖加载问题求助

这问题我之前踩过坑！本质是Jest和Node.js的模块解析逻辑不一样导致的，我给你拆解下原因和解决办法：

Node.js原生的NODE_PATH是兜底查找路径：只有当在当前文件目录、项目根目录的node_modules都找不到模块时，才会去NODE_PATH指定的路径里找。但Jest的modulePaths是优先查找路径——Jest会先遍历你设置的modulePaths目录，只有在这些目录里找不到目标模块时，才会去node_modules里找。

所以当你把config加入modulePaths，而config目录下正好有passport.js时，Jest就会直接加载这个自定义文件，而跳过了node_modules里的官方passport包，自然就崩溃了。

我整理了几种可行的解决办法，按推荐程度排序：

方法1：用moduleNameMapper强制映射passport包 #

在你的Jest配置文件（比如jest.config.js）里添加映射规则，明确告诉Jest，当你require('passport')时，直接去node_modules里加载官方包：

module.exports = {
  // 保留你原有的其他配置
  modulePaths: ['app', 'config'],
  moduleNameMapper: {
    '^passport$': '<rootDir>/node_modules/passport'
  }
};

这种方法不用修改现有业务代码，纯配置就能解决冲突，非常省心。

方法2：用moduleDirectories替代modulePaths #

Jest的moduleDirectories默认就包含node_modules，它的查找逻辑是先找node_modules，再找你指定的自定义目录，和Node.js原生的NODE_PATH行为完全一致。你可以把原来的modulePaths配置换成moduleDirectories：

module.exports = {
  // 其他配置...
  moduleDirectories: ['node_modules', 'app', 'config']
};

这样Jest会先在node_modules里找passport包，找不到才会去app和config目录，完美匹配你在生产环境的模块解析逻辑，从根源上避免了优先级问题。

方法3：重命名自定义的passport文件 #

最直接的“治本”方法：把config/passport.js改成更明确的名字，比如config/passport-strategy.js或者config/passport-config.js，然后在代码里把加载自定义配置的require('passport')改成require('passport-strategy')。这种方式彻底消除了命名冲突，后续不会再出现类似的解析问题。

你之前尝试把node_modules加入modulePaths导致更多问题，是因为modulePaths的优先级太高，加入后Jest会优先从node_modules查找所有模块，打乱了你自定义模块的查找逻辑。而moduleDirectories是Jest专门用来控制模块查找顺序的配置，默认就包含node_modules，更适合你的场景。

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