Node.js子目录A引入pg模块失败，其他子目录正常问题求助

我们的Node.js应用拆分为6个独立服务子目录，每个子目录都配有独立的package.json、lock文件及Dockerfile。其中子目录A安装了^8.7.3版本的pg模块，编写了postgres.js配置文件，但在从该文件引入函数时，出现Error: Cannot find module 'pg'，调用栈指向-/app/src/utils/postgres.js、-/app/src/index.js等文件。其他两个子目录使用pg模块正常，子目录A的运行环境为Node v20.9.0 + npm v10.1.0，主应用环境为Node v10.1.0 + npm v20.9.0。已尝试卸载重装pg模块、重写import语句，问题仍未解决。

以下是针对性的排查方案和解决思路：

1. 排查Node版本差异导致的模块解析逻辑问题 #

Node v10与v20在ES模块/CommonJS的处理上有显著差异：

• 检查子目录A的package.json是否设置了"type": "module"：
  • 若设置了该字段，确保postgres.js中使用import pg from 'pg'的ES模块导入语法；
  • 若未设置（默认CommonJS），则使用const pg = require('pg')的导入方式；
• 对比正常工作的子目录B的package.json的type字段，确保语法风格与Node版本匹配。

2. 清理npm依赖安装缓存与路径 #

npm v10的缓存或权限问题可能导致依赖未正确安装：

• 进入子目录A，执行以下命令彻底重置依赖：

  rm -rf node_modules package-lock.json
  npm cache clean --force
  npm install
  

• 检查node_modules目录下是否存在pg文件夹，确认依赖安装成功。

3. 检查Docker容器内的依赖与路径配置 #

Docker的路径或挂载配置可能导致依赖无法被加载：

• 查看子目录A的Dockerfile：
  • 确保先复制package.json和package-lock.json到容器内，再执行npm install（避免先复制整个代码目录覆盖容器内的node_modules）；
  • 确认WORKDIR指令设置的容器工作目录与代码中的路径（如-/app/src）一致；
  • 检查是否存在挂载卷覆盖了容器内的node_modules，导致本地依赖未被正确加载。

4. 排查Mocha相关依赖的冲突 #

子目录A中的@mocha、@mocha-multi可能与pg模块存在依赖冲突：

• 执行npm ls pg查看pg的依赖树，确认是否存在版本冲突或被其他依赖间接覆盖；
• 临时移除Mocha相关依赖，重新安装pg并启动服务，验证问题是否消失。

5. 避免主应用环境的干扰 #

主应用的Node v10环境可能对子目录A的v20环境造成污染：

• 在子目录A的Dockerfile中明确指定Node镜像版本为node:20.9.0，完全隔离主应用环境；
• 检查是否存在NODE_PATH环境变量导致模块解析路径异常，可在启动时临时取消该变量：

  NODE_PATH= node src/index.js
  

快速验证步骤 #

1. 在本地子目录A中直接启动服务（不通过Docker），确认是否仍出现错误，排除Docker配置问题；
2. 将子目录A的Node/npm版本切换为与正常工作的子目录B一致，验证是否是版本差异导致问题。

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