MacOS Catalina下运行Gatsby/Strapi遇dyld符号绑定失败求助

问题根源 #

_pthread_jit_write_protect_supported_np 是MacOS Big Sur（11.0+）才引入的系统API，而你当前使用的MacOS Catalina（10.15.7）不支持该符号。新项目默认安装的sharp新版本依赖的libvips库使用了这个API，导致启动失败；旧项目因为sharp版本兼容，所以没有问题。

具体解决步骤 #

• 锁定sharp到兼容Catalina的版本
  卸载当前版本并安装适配的旧版本（比如v0.30.7，该版本依赖的libvips未使用新API）：

  npm uninstall sharp
  npm install sharp@0.30.7
  

  若使用yarn：

  yarn remove sharp
  yarn add sharp@0.30.7
  

  编辑package.json，确保sharp版本被锁定（避免后续依赖升级再次触发问题）。

• 清理缓存并重建依赖
  彻底清除旧依赖缓存后重新安装：

  rm -rf node_modules
  rm package-lock.json  # yarn用户替换为 rm yarn.lock
  npm install
  npx sharp-cli clean
  

• 匹配Node版本兼容性
  Catalina对高版本Node支持有限，建议切换到sharp@0.30.7兼容的Node版本（如14.x-18.x），可通过nvm切换：

  nvm install 16
  nvm use 16
  

• 手动指定兼容的libvips版本（备选方案）
  若以上方法无效，安装sharp时直接指定适配Catalina的libvips版本（如8.12.2）：

  npm install sharp --sharp-libvips-version=8.12.2
  

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