Node降级至V16.16.0后运行npm run dev遇符号缺失错误

问题根源 #

你遇到的_pthread_jit_write_protect_supported_np符号缺失错误，是因为当前安装的sharp依赖的libvips 8.13.3使用了旧macOS系统不支持的系统API，你的系统版本过低，无法提供该符号导致动态链接失败。

修复步骤 #

1. 安装兼容旧系统的sharp版本 #

sharp较新版本的预编译二进制包默认适配新macOS，你需要降级到明确支持旧系统的版本：

# 卸载当前sharp
npm uninstall sharp
# 安装适配旧系统的稳定版本，比如v0.30.7
npm install sharp@0.30.7

如果v0.30.7仍不兼容，可尝试更低版本如v0.29.3。

2. 强制从源码编译sharp（预编译包无效时） #

若指定版本后依旧报错，说明预编译包不匹配你的系统环境，需强制从源码编译，生成适配当前系统的二进制文件：

npm uninstall sharp
# 设置环境变量强制源码编译
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install sharp --build-from-source

注意：编译前需确保已安装Xcode Command Line Tools，未安装的话执行xcode-select --install完成安装。

3. 彻底清理缓存并重装依赖 #

清理残留缓存和旧依赖文件，避免干扰：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

4. 验证修复 #

执行启动命令测试：

npm run dev

内容的提问来源于stack exchange，提问作者maurijn.vd