Decentraland本地预览加载卡在88%无法正常加载场景问题咨询

问题匹配特征 #

• 环境版本：node v16.0.0、npm 8.13.2、dcl 3.11.0
• 执行dcl init初始化场景、dcl start启动服务无报错
• 浏览器加载预览页进度永久停在88%，长时间等待无响应

排查修复步骤 #

• 修复版本兼容缺陷
  node v16.0.0为16.x分支初始版本，存在HTTP模块长连接传输bug，会中断本地预览服务的分片资源传输；dcl 3.11.0版本存在WebSocket断连无重试逻辑缺陷，两个问题叠加会直接触发88%节点加载卡死。
  先将node版本切换至16.18.0+的16.x LTS版本或18.x全量LTS版本，之后执行以下命令重装稳定版SDK工具：

  npm uninstall -g decentraland @dcl/sdk
  npm install -g decentraland@3.13.1 @dcl/sdk@latest
  

• 清理本地构建缓存与冗余依赖
  进入已初始化的场景目录，执行命令清除旧版本生成的缓存与依赖锁文件：

  # Windows系统直接手动删除对应文件夹即可
  rm -rf node_modules package-lock.json .dcl/preview-cache
  npm install
  

• 排除浏览器侧拦截问题
  广告拦截、脚本类浏览器插件会拦截预览页的WASM引擎加载请求，触发88%节点卡死，加载前需关闭这类插件；不要使用浏览器无痕模式打开预览地址，无痕模式默认限制本地存储权限会导致场景状态初始化失败。
  启动预览时添加禁用缓存参数：

  dcl start --no-cache
  

  首次加载如果仍卡顿，按Ctrl+Shift+R（Mac系统为Cmd+Shift+R）硬刷新页面2-3次即可正常进入场景。

加载进度88%对应WASM引擎初始化、场景资源桥接的节点，只要控制台无红色的WebSocket连接失败、WASM资源404报错，按上述步骤操作后均可正常加载。

内容的提问来源于stack exchange，提问作者Seetharaman GR