下游node_modules中无法通过require引入主项目导出的配置对象

你在依赖包中硬写多层相对路径引用主项目文件的写法本身不符合Node.js依赖的设计规范，实际运行时极易出现路径不匹配的问题：

• Node.js中require的相对路径是相对于当前执行文件的真实存放路径计算的，npm/yarn/pnpm等包管理工具的依赖安装结构并不固定（比如pnpm使用软链接结构、生产环境会做依赖提升、monorepo场景下依赖存放位置也会变化），你写的../../../../../config路径大概率实际运行时找不到目标文件，require找不到对应模块时返回undefined，后续取globalConfig属性自然会抛出类型错误。

方案1（最推荐）：将依赖包路由改为工厂函数导出，由主项目传入配置 #

这是Node.js生态下依赖包接收主项目配置的标准实现，完全无路径耦合，适配所有安装场景：

1. 调整你的路由依赖包导出逻辑，改为导出一个接收配置参数的函数，函数内部返回路由实例：

// node_modules/packagefolder/packagename/routes/index.js
const express = require('express')
const router = express.Router()

module.exports = function initPackageRoute(config) {
  // 内部所有需要使用配置的逻辑直接用传入的config参数即可
  const port = config.globalConfig.port
  router.get('/test', (req, res) => {
    res.send(`当前服务端口为${port}`)
  })

  return router
}

2. 主项目挂载路由时，先引入本地配置再传入依赖包完成初始化：

// 主项目 routes/index.js
const express = require('express')
const mainRouter = express.Router()
// 引入主项目本地配置
const { globalConfig } = require('../config')
// 引入路由依赖的初始化函数
const initPackageRoute = require('@packagefolder/packagename')
// 传入配置完成路由初始化
const packageRoute = initPackageRoute({ globalConfig })
// 挂载路由
mainRouter.use('/api', packageRoute)

module.exports = mainRouter

方案2：使用require.main.require加载主项目模块 #

如果不想调整依赖包的导出结构，可以使用require.main.require从主项目根目录加载模块，不需要写多层相对路径：

// node_modules/packagefolder/packagename/routes/index.js
// require.main指向主项目入口文件（app.js）的模块，require路径相对于主项目根目录计算
const config = require.main.require('./config')
const port = config.globalConfig.port

注意该方案存在限制：主项目必须以app.js为启动入口，测试场景下如果用jest等测试工具启动，require.main指向会变化，可能加载失败。

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