Ubuntu 20.04容器中sudo全局安装aws-sdk后找不到模块，无sudo安装遇权限错误

出现“全局安装后依然找不到aws-sdk模块”的问题，核心是三类配置错位导致的，和安装命令的使用习惯直接相关：

• 全局安装路径与模块解析路径不匹配
  你用sudo npm install -g执行安装时，npm的全局路径配置是绑定root用户环境的。一方面，Node.js在做模块解析时，默认不会自动把全局安装目录加入查找路径列表，必须通过NODE_PATH环境变量显式指向对应目录；另一方面，普通用户运行脚本时，Node只会从脚本所在目录向上逐级遍历node_modules目录查找模块，不会主动检索root用户专属的全局安装目录，自然会报找不到模块的错误。
• 多环境Node版本的路径分裂
  Ubuntu 20.04容器中经常存在多套Node环境共存的情况：sudo执行命令时使用的是root用户环境下配置的Node版本，而你跑脚本时用的是普通用户环境下的Node版本，两套Node的全局安装目录是完全独立的。aws-sdk实际被安装到了root用户对应的Node版本的全局路径下，普通用户运行的另一套Node自然无法检索到这个模块。
• 权限错位引发的加载失败
  你不用sudo执行全局安装时报权限不足，本质是npm默认全局目录的所有者是root，普通用户没有写权限。反过来用sudo安装的模块，文件所有者也为root，如果当前运行脚本的普通用户对全局模块目录没有读取权限，Node加载模块时会直接跳过无权限访问的目录，对外表现依然是“Cannot find module”，不会直接弹出权限不足的提示。

• 第一步先定位路径错位的实际情况
  分别在普通用户、sudo权限下执行两个命令，对比输出的全局路径：
  • 普通用户环境执行：npm root -g
  • sudo权限环境执行：sudo npm root -g
    如果两个路径输出不一致，就可以确认是用户与root的全局路径配置分裂导致的问题。
• 彻底摆脱sudo安装的依赖
  不需要通过sudo获取全局目录的写权限，直接给当前普通用户配置独立的npm全局目录：
  1. 在家目录下创建专属的全局依赖存储目录：mkdir ~/.npm-global
  2. 配置npm的全局安装路径指向该目录：npm config set prefix '~/.npm-global'
  3. 将全局目录下的可执行文件路径加入当前用户的环境变量，在~/.bashrc文件末尾追加配置：export PATH=~/.npm-global/bin:$PATH
  4. 执行source ~/.bashrc让配置生效，之后再执行npm install -g aws-sdk，安装路径和运行脚本的用户环境完全对齐，不会出现路径错位问题。
• 优先选择本地依赖安装方式
  Node生态中更推荐在脚本所在的项目目录下做本地依赖安装，从根源上绕开全局路径的配置问题：直接进入项目根目录，执行npm init -y && npm install aws-sdk，这种方式安装的依赖会存在项目目录下的node_modules文件夹中，Node解析模块时会优先检索该目录，既不会出现找不到模块的问题，也能避免不同项目间的依赖版本冲突。
• 临时方案补充
  如果确实需要引用全局安装的模块，可以在执行脚本时临时指定模块查找路径：NODE_PATH=$(npm root -g) node your-script.js，但这种方式只是临时绕过问题，不适合长期稳定的生产场景。

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