如何解决安装依赖时出现“websocket-driver完整性校验失败”的错误

本地依赖安装报错修复 #

• 首先删除本地缓存文件与无效依赖，执行对应系统命令：

# macOS/Linux
rm -rf node_modules yarn.lock .next
# Windows
rmdir /s /q node_modules yarn.lock .next

• 升级yarn到最新稳定版，避免旧版本网络请求兼容问题，执行命令：
  yarn set version stable
• 重新执行依赖安装，测试是否还会抛出websocket报错：
  yarn install
• 若依然报错，优先检查网络环境：关闭代理、VPN工具后重试，也可临时切换yarn源为国内镜像，执行命令：
  yarn config set registry https://registry.npmmirror.com
• 确认项目内websocket相关依赖（如ws、socket.io、pusher-js等）的版本和当前使用的Next.js版本兼容，存在不兼容情况时将对应依赖升级到匹配的稳定版本。

Vercel部署报错修复 #

• 登录Vercel进入对应项目的设置页，找到「Build & Development Settings」选项，将默认的依赖安装命令修改为：
  yarn install --network-timeout 100000
  延长网络超时时间，避免依赖拉取过程中websocket连接提前断开。
• 在项目环境变量配置中新增变量YARN_ENABLE_IMMUTABLE_INSTALLS，值设为false，跳过锁文件的严格校验，避免本地和部署环境的依赖版本差异导致的拉取报错。

内容的提问来源于stack exchange，提问作者Usama Abdul Razzaq