Node.js后端AWS Cognito登录端点报错：找不到指定AWS SDK包

问题场景：离开Node.js后端项目数周后，调用登录端点时突然报错Cannot find module '@aws-sdk/client-cognito-identity-provider'，但启动服务器无控制台报错，同仓库其他成员无此问题，切换旧分支、更换Node.js版本（22/20/14）、更新AWS相关包、删除重装node_modules、重新克隆仓库均无效。

1. 清理本地包缓存与排查全局依赖冲突 #

• 清理npm/yarn全局缓存，避免缓存的损坏包干扰：
  • npm：npm cache clean --force
  • yarn：yarn cache clean
• 检查全局是否安装了同名AWS SDK包导致版本冲突：
  • 查看全局包列表：npm list -g @aws-sdk/client-cognito-identity-provider
  • 若存在，执行npm uninstall -g @aws-sdk/client-cognito-identity-provider卸载后重新安装项目依赖

2. 严格同步依赖版本 #

• 直接拉取仓库最新的package-lock.json或yarn.lock文件，避免lock文件差异导致依赖安装不一致：
  • npm：执行npm ci（会严格按照lock文件安装依赖，忽略package.json的版本范围）
  • yarn：执行yarn install --frozen-lockfile
• 对比本地lock文件与其他成员的版本，确认@aws-sdk/client-cognito-identity-provider的版本号完全一致

3. 排查动态导入/条件加载逻辑 #

• 由于仅调用登录端点时触发报错，说明模块是动态导入或条件加载的：
  • 搜索项目中所有导入@aws-sdk/client-cognito-identity-provider的代码，确认是否存在import('@aws-sdk/client-cognito-identity-provider')这类动态导入
  • 检查是否有环境分支判断（如开发/生产环境变量），导致该模块仅在特定条件下加载，而你的本地环境变量配置异常

4. 检查开发工具与环境变量 #

• 清空Postman缓存，避免旧请求配置干扰：
  • 打开Postman → 右上角设置 → Settings → General → 点击「Clear Cache」，新建干净的请求测试
• 检查NODE_PATH环境变量是否异常：
  • Linux/macOS：执行echo $NODE_PATH；Windows：执行echo %NODE_PATH%
  • 若有自定义路径，临时取消该环境变量后重启服务器再测试
• 关闭本地代理工具（如Charles、Fiddler）或VPN，避免网络层面干扰模块加载

5. 验证模块解析上下文 #

• 在项目根目录创建测试文件test-cognito-import.js，写入以下代码：

  const { CognitoIdentityProviderClient } = require('@aws-sdk/client-cognito-identity-provider');
  console.log('模块加载成功', CognitoIdentityProviderClient);
  

  • 执行node test-cognito-import.js：
    • 若报错，说明模块未正确安装，需重新检查依赖安装流程
    • 若成功，说明问题出在服务器运行时上下文（如PM2、nodemon的启动参数），检查是否使用了--preserve-symlinks等可能影响模块解析的参数

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