Gitlab流水线安装依赖报mozjpeg@7.1.1 postinstall ELIFECYCLE错误如何处理

报错日志 #

npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! mozjpeg@7.1.1 postinstall: `node lib/install.js`
npm ERR! Exit status 1
npm ERR! 
npm ERR! Failed at the mozjpeg@7.1.1 postinstall script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.
npm ERR! A complete log of this run can be found in:
npm ERR!     /root/.npm/_logs/2021-10-21T11_15_27_617Z-debug.log

触发原因分析 #

该报错的核心为mozjpeg@7.1.1包的*postinstall（后置安装）*脚本执行异常退出，常见触发场景如下：

• CI运行环境缺少系统级编译依赖：mozjpeg的安装需要依赖底层系统的编译工具和图形处理库，包含gcc、autoconf、automake、libpng-dev、libjpeg-turbo-dev、make等，绝大多数轻量版Node.js CI镜像默认不会预装这类依赖，当预编译二进制包拉取失败触发本地编译时，就会直接报错。
• root用户执行权限限制：npm默认禁止以root身份执行postinstall脚本，会自动降权到普通用户执行，从日志路径可判断当前是用root用户执行npm安装操作，降权后大概率没有对应目录的读写权限，导致脚本执行失败。
• 网络访问受限：mozjpeg安装阶段会默认请求外网拉取对应版本的预编译二进制包，Gitlab Runner如果处于内网环境未配置外网代理，或者对应的资源地址访问受限，就会拉取失败，后续触发的本地编译也会因缺少依赖报错。
• Node.js版本不兼容：mozjpeg@7.1.1仅兼容Node.js 10及以上的稳定版本，如果CI环境使用的Node.js版本低于要求，也会导致postinstall脚本运行异常。
• npm缓存异常：CI环境如果复用了旧的npm缓存，缓存中存储的mozjpeg残留文件损坏，也会导致安装阶段脚本执行失败。

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