Jenkins流水线Docker代理执行sh npm i失败问题排查

我来帮你拆解这个问题并给出更合理的解决方案：

问题根源 #

你遇到的EACCES错误本质是权限不匹配：

• 手动启动node:latest容器时，默认以root用户运行，对/.npm缓存目录有完全权限，所以npm install正常执行。
• 但Jenkins的Docker Agent默认会用Jenkins执行用户的UID/GID启动容器（这个UID/GID和容器内的root或node用户都不匹配），当npm尝试写入/.npm目录时，因为该目录属于root，当前Jenkins用户没有操作权限，所以抛出错误。

解决方案 #

1. 使用容器内的node用户+自定义缓存目录（推荐）

node:latest镜像内置了一个非root的node用户（UID=1000），我们可以指定用这个用户运行容器，同时把npm缓存目录设置到Jenkins工作空间（当前用户有权限的目录），既保证安全又解决权限问题：

pipeline {
    agent { 
        docker { 
            image 'node:latest' 
            args '-u node' 
        } 
    }
    environment {
        // 将npm缓存目录设置到工作空间，避免访问root所属的/.npm
        NPM_CONFIG_CACHE = "${WORKSPACE}/.npm"
    }
    stages {
        stage('Install Dependencies') {
            steps {
                sh 'npm -v'
                sh 'ls -lart'
                sh 'npm i axios'
            }
        }
    }
}

2. 临时用root用户运行（不推荐）

你之前尝试的args '-u root'确实能解决问题，但不建议在生产环境使用——以root用户运行容器会带来安全风险，若构建过程中引入恶意依赖，可能会对容器或宿主机造成破坏。

3. 自定义Node镜像优化权限

如果你的流水线需要频繁使用Node镜像，可以提前构建一个自定义镜像，预先处理/.npm目录的权限：

FROM node:latest
# 提前修改/.npm目录权限为node用户所有
RUN mkdir -p /.npm && chown -R node:node /.npm
# 默认用node用户启动容器
USER node

之后在Jenkinsfile中使用这个自定义镜像，就不需要额外配置权限了。

为什么你之前的chown命令失败？ #

容器内默认没有sudo命令，且你当前运行的用户不是root，所以没有权限修改/.npm目录的所有权——只有root用户能修改root所属的目录权限。

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