Docker构建Apache Superset失败：npm run命令返回非零代码1

第一步：获取完整错误日志 #

当前仅看到返回码1，无法定位具体问题，重新构建时输出完整日志：

docker build --progress=plain -t superset:1.0.0 .

重点查看npm run ${BUILD_CMD}执行阶段的具体报错信息，比如依赖下载失败、版本冲突、权限问题等，这是排查的核心依据。

常见问题及解决方法 #

1. 网络导致npm包下载失败

容器内默认npm源可能访问缓慢或失败，可临时修改Dockerfile添加国内镜像源：
在Dockerfile中找到RUN npm ci或npm install相关步骤，在其上方添加：

RUN npm config set registry https://registry.npmmirror.com/

修改后重新执行构建命令。

2. 依赖版本冲突或Node.js版本不匹配

Superset 1.0.0对Node.js版本有明确要求（推荐14.x），检查Dockerfile中Node的安装版本是否符合。若官方Dockerfile版本不符，可手动指定Node版本：
将Dockerfile中的Node安装部分替换为：

RUN curl -sL https://deb.nodesource.com/setup_14.x | bash - \
    && apt-get install -y nodejs

3. 容器内npm运行权限不足

尝试在npm命令后添加--unsafe-perm参数，修改Dockerfile中的对应命令：

RUN npm run ${BUILD_CMD} --unsafe-perm

4. Docker缓存引发的问题

清理Docker构建缓存后重新构建：

docker build --no-cache -t superset:1.0.0 .

替代方案：直接使用官方预构建镜像 #

如果构建问题难以快速解决，可直接拉取官方1.0.0版本镜像跳过构建步骤：

docker pull apache/superset:1.0.0

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