前言

配置jenkins的流水线部署时，有个前端项目一直打包失败，具体报错信息是Error: pngquant failed to build, make sure that libpng-dev is installed。虽然最后解决了，但是过程挺坎坷的，所以就写篇文章记录一下解决的过程，希望对各位读者有所帮助。

排查思路

（1）尝试一：切换镜像源，重新下载

最开始看这个错误日志时，第一反应就是由于网络关系导致包没有正常下载下来，由于我是内网环境部署，通过走代理的方式访问npm镜像源，所以确实有可能存在包下载失败的问题。
此处镜像源已经确认过没有问题了，所以需要做的事情就是重新尝试下载

npm clean cache --force
rm -rf node_module
npm install

如果有读者没有把默认的镜像源切换为淘宝或者腾讯的镜像源的话，这里可以使用
npm config set registry http://mirrors.cloud.tencent.com/npm/或者npm config set registry http://registry.npmmirror.com命令进行镜像源的配置

（2）尝试二：升级node版本

百度后有踩过坑的开发人员提出，有可能是node版本太低导致的，建议升级node版本后继续打包。这个我也试过了，未能解决问题

（3）尝试三：切换镜像源

我一开始用的是腾讯云的镜像源，所以刚开始的时候也在怀疑是不是腾讯的npm源有问题，但是切换到淘宝的镜像源后发现问题依旧存在。。。（好吧，起码是证明了腾讯云还是可靠的）

（4）尝试四：安装本地相关依赖（大概率有用）

libpng是一个png的参考库，那么使用这个依赖可能是要操作系统提供了相关的底层支持的，linux系统需要确保服务器本身有支持png库运行的依赖。
参考文章：修复错误pngquant构建失败，请确保安装了 libpng-dev

• Ubuntu/Debian

apt update
apt install -y build-essential gcc make libpng-dev

• CentOS linux

yum group install "Development Tools"
yum -y install libpng-devel

（5）尝试五：调整npm执行权限（最后的解决方式）

第四个尝试还以为看到了希望的曙光，不过最后还是没有解决我的问题。再仔细看日志，由于npm在下载一些依赖的时候会去连接github（内网自然是走不通），连接超时后会尝试自己编译源文件，但是因为权限问题导致无法正常创建文件出来。所以执行如下命令来强制提升npm的执行权限

npm install --unsafe-perm --allow-root

• unsafe-perm：
  这个标志允许npm安装包含潜在不安全脚本的包。在某些情况下，包可能包含需要执行权限的脚本（比如 preinstall、install、postinstall 脚本）。默认情况下，npm会检查这些脚本的权限，并阻止执行具有潜在风险的脚本。使用 --unsafe-perm 可以绕过这个安全检查，允许执行这些脚本。通常，不建议使用这个标志，因为它可能会带来安全风险，比如执行恶意脚本。
• allow-root：
  默认情况下，npm不允许以root用户身份全局安装包，因为这可能会影响系统文件和安全。使用 --allow-root 标志可以允许npm以root用户身份安装包。这通常用于系统管理员需要在系统级别安装npm包时。

使用这个命令重新下载依赖后，最后问题确实可以解决了，虽然解决了，但是个人觉得这个命令还是有一定危险性的，从安全考虑的话，生产环境最好还是不要执行相关的命令，毕竟权限的口子开得有点大了。

（n）可以解决但不太推荐的尝试

把本地打包成功的node_module复制一份到内网服务器上面，绕过依赖问题。这个方法大概率是可以成功的，我没有使用的原因是，以后总会有新的依赖需要下载，不解决npm install的问题，那么jenkins自动部署的工作就永远有这个坑在。

一个小小的吐槽

npm下载有点奇怪，命名已经配置了镜像却有时候还会跳转到非镜像地址进行依赖下载，个人觉得属实是没有maven这么规范的，希望以后npm下载会不会慢慢把下载安全和入口统一的事情给进行优化。这里也推荐一篇文章，是windows系统下怎么解决这个问题的，个人觉得对于windows操作系统来说还是很有参考价值的：https://juejin.cn/post/7224149297951408185