前言
配置jenkins的流水線(xiàn)部署時(shí)，有個(gè)前端項(xiàng)目一直打包失敗，具體報(bào)錯(cuò)信息是
Error: pngquant failed to build, make sure that libpng-dev is installed赤套。雖然最后解決了，但是過(guò)程挺坎坷的沽讹，所以就寫(xiě)篇文章記錄一下解決的過(guò)程宾符，希望對(duì)各位讀者有所幫助。
排查思路
（1）嘗試一：切換鏡像源梗掰，重新下載
最開(kāi)始看這個(gè)錯(cuò)誤日志時(shí)嵌言，第一反應(yīng)就是由于網(wǎng)絡(luò)關(guān)系導(dǎo)致包沒(méi)有正常下載下來(lái)，由于我是內(nèi)網(wǎng)環(huán)境部署及穗，通過(guò)走代理的方式訪(fǎng)問(wèn)npm鏡像源摧茴，所以確實(shí)有可能存在包下載失敗的問(wèn)題。
此處鏡像源已經(jīng)確認(rèn)過(guò)沒(méi)有問(wèn)題了埂陆，所以需要做的事情就是重新嘗試下載
npm clean cache --force
rm -rf node_module
npm install
如果有讀者沒(méi)有把默認(rèn)的鏡像源切換為淘寶或者騰訊的鏡像源的話(huà)苛白，這里可以使用
npm config set registry http://mirrors.cloud.tencent.com/npm/或者npm config set registry http://registry.npmmirror.com命令進(jìn)行鏡像源的配置
（2）嘗試二：升級(jí)node版本
百度后有踩過(guò)坑的開(kāi)發(fā)人員提出，有可能是node版本太低導(dǎo)致的焚虱，建議升級(jí)node版本后繼續(xù)打包丸氛。這個(gè)我也試過(guò)了，未能解決問(wèn)題
（3）嘗試三：切換鏡像源
我一開(kāi)始用的是騰訊云的鏡像源著摔，所以剛開(kāi)始的時(shí)候也在懷疑是不是騰訊的npm源有問(wèn)題缓窜，但是切換到淘寶的鏡像源后發(fā)現(xiàn)問(wèn)題依舊存在。谍咆。禾锤。（好吧，起碼是證明了騰訊云還是可靠的）
（4）嘗試四：安裝本地相關(guān)依賴(lài)（大概率有用）
libpng是一個(gè)png的參考庫(kù)摹察，那么使用這個(gè)依賴(lài)可能是要操作系統(tǒng)提供了相關(guān)的底層支持的恩掷，linux系統(tǒng)需要確保服務(wù)器本身有支持png庫(kù)運(yùn)行的依賴(lài)。
參考文章：修復(fù)錯(cuò)誤pngquant構(gòu)建失敗供嚎，請(qǐng)確保安裝了 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）嘗試五：調(diào)整npm執(zhí)行權(quán)限（最后的解決方式）
第四個(gè)嘗試還以為看到了希望的曙光黄娘，不過(guò)最后還是沒(méi)有解決我的問(wèn)題峭状。再仔細(xì)看日志，由于npm在下載一些依賴(lài)的時(shí)候會(huì)去連接github（內(nèi)網(wǎng)自然是走不通）逼争，連接超時(shí)后會(huì)嘗試自己編譯源文件优床，但是因?yàn)闄?quán)限問(wèn)題導(dǎo)致無(wú)法正常創(chuàng)建文件出來(lái)。所以執(zhí)行如下命令來(lái)強(qiáng)制提升npm的執(zhí)行權(quán)限
npm install --unsafe-perm --allow-root
- unsafe-perm：
這個(gè)標(biāo)志允許npm安裝包含潛在不安全腳本的包誓焦。在某些情況下胆敞，包可能包含需要執(zhí)行權(quán)限的腳本（比如 preinstall、install杂伟、postinstall 腳本）移层。默認(rèn)情況下，npm會(huì)檢查這些腳本的權(quán)限赫粥，并阻止執(zhí)行具有潛在風(fēng)險(xiǎn)的腳本观话。使用 --unsafe-perm 可以繞過(guò)這個(gè)安全檢查，允許執(zhí)行這些腳本越平。通常匪燕，不建議使用這個(gè)標(biāo)志，因?yàn)樗赡軙?huì)帶來(lái)安全風(fēng)險(xiǎn)喧笔，比如執(zhí)行惡意腳本帽驯。 - allow-root：
默認(rèn)情況下，npm不允許以root用戶(hù)身份全局安裝包书闸，因?yàn)檫@可能會(huì)影響系統(tǒng)文件和安全尼变。使用 --allow-root 標(biāo)志可以允許npm以root用戶(hù)身份安裝包。這通常用于系統(tǒng)管理員需要在系統(tǒng)級(jí)別安裝npm包時(shí)浆劲。
使用這個(gè)命令重新下載依賴(lài)后嫌术，最后問(wèn)題確實(shí)可以解決了，雖然解決了牌借，但是個(gè)人覺(jué)得這個(gè)命令還是有一定危險(xiǎn)性的度气，從安全考慮的話(huà)，生產(chǎn)環(huán)境最好還是不要執(zhí)行相關(guān)的命令膨报，畢竟權(quán)限的口子開(kāi)得有點(diǎn)大了磷籍。
（n）可以解決但不太推薦的嘗試
把本地打包成功的node_module復(fù)制一份到內(nèi)網(wǎng)服務(wù)器上面，繞過(guò)依賴(lài)問(wèn)題现柠。這個(gè)方法大概率是可以成功的院领，我沒(méi)有使用的原因是，以后總會(huì)有新的依賴(lài)需要下載够吩，不解決npm install的問(wèn)題比然，那么jenkins自動(dòng)部署的工作就永遠(yuǎn)有這個(gè)坑在。
一個(gè)小小的吐槽
npm下載有點(diǎn)奇怪周循，命名已經(jīng)配置了鏡像卻有時(shí)候還會(huì)跳轉(zhuǎn)到非鏡像地址進(jìn)行依賴(lài)下載强法，個(gè)人覺(jué)得屬實(shí)是沒(méi)有maven這么規(guī)范的万俗，希望以后npm下載會(huì)不會(huì)慢慢把下載安全和入口統(tǒng)一的事情給進(jìn)行優(yōu)化。這里也推薦一篇文章饮怯，是windows系統(tǒng)下怎么解決這個(gè)問(wèn)題的闰歪，個(gè)人覺(jué)得對(duì)于windows操作系統(tǒng)來(lái)說(shuō)還是很有參考價(jià)值的：https://juejin.cn/post/7224149297951408185
