AWS CodeDeploy部署Node.js应用时npm install遇EACCES权限拒绝的非sudo解决方案咨询

我来帮你梳理下这个问题的根源和几个不用sudo就能解决的办法：

问题根源 #

你看到的node_modules目录属于root用户，大概率是之前某次部署（或手动操作）用root身份执行过npm install，导致后续ubuntu用户没有写入权限；另外也可能是目标目录/home/ubuntu/myapp的权限本身没有给ubuntu用户足够的控制权。

解决方案 #

1. 提前修复目录与文件权限 #

在BeforeInstall阶段先统一修复目标目录的权限，确保ubuntu用户对该目录拥有完全控制权。修改你的before_install.sh脚本，加入以下命令：

#!/bin/bash
# 确保目标目录存在并设置归属
mkdir -p /home/ubuntu/myapp
chown -R ubuntu:ubuntu /home/ubuntu/myapp
# 如果已有root权限的node_modules，直接变更归属或删除
if [ -d /home/ubuntu/myapp/node_modules ]; then
  chown -R ubuntu:ubuntu /home/ubuntu/myapp/node_modules
  # 或者直接删除重建：rm -rf /home/ubuntu/myapp/node_modules
fi

这样在部署前就把目录和已有文件的权限转交给ubuntu用户，后续npm install就能正常执行了。

2. 配置CodeDeploy自动设置文件权限 #

直接在appspec.yaml的files部分添加权限配置，让CodeDeploy在复制文件时自动把文件/目录的归属设置为ubuntu用户：

version: 0.0
os: linux
files:
  - source: /
    destination: /home/ubuntu/myapp
    permissions:
      - object: /home/ubuntu/myapp
        pattern: "**"
        owner: ubuntu
        group: ubuntu
        mode: 755
hooks:
  BeforeInstall:
    - location: scripts/before_install.sh
      timeout: 300
      runas: ubuntu
  AfterInstall:
    - location: scripts/after_install.sh
      timeout: 300
      runas: ubuntu
  ApplicationStart:
    - location: scripts/application_start.sh
      timeout: 300
      runas: ubuntu

这个配置能从根源上避免文件复制后出现权限不匹配的问题。

3. 让npm使用用户级目录安装依赖 #

如果不想修改系统目录权限，可以配置npm将依赖安装在ubuntu用户的个人目录下，绕开全局权限限制。修改你的after_install.sh脚本：

#!/bin/bash
cd /home/ubuntu/myapp
# 设置npm使用用户级前缀目录
npm config set prefix ~/.npm-global
# 把用户级bin目录加入PATH，确保后续能找到依赖的可执行文件
export PATH=~/.npm-global/bin:$PATH
# 执行安装
npm install

注意：这种方式需要在应用启动脚本里也配置同样的PATH，或者在package.json的启动命令中指定依赖路径。

总结 #

最稳妥的是方案1+方案2的组合：先用CodeDeploy的permissions配置确保文件复制时权限正确，再在BeforeInstall阶段修复可能存在的遗留权限问题，这样就能彻底摆脱对sudo的依赖。

内容的提问来源于stack exchange，提问作者Susitha Ravinda Senarath