Parcel构建出现@parcel/transformer-js线程局部变量访问错误如何解决

解决方案 #

该报错是Parcel 2.0~2.8版本底层Rust依赖scoped-tls的已知偶发panic，按以下顺序排查即可解决：

• 第一步：清理缓存与锁文件后重装依赖
  依次执行以下命令：

  rm -rf .parcel-cache node_modules package-lock.json yarn.lock pnpm-lock.yaml
  npm install
  

  完成后重新执行构建命令，缓存损坏是该问题最高发的触发原因。
• 第二步：升级Parcel到最新稳定版
  执行以下命令升级Parcel：

  npm install parcel@latest --save-dev
  

  该问题已在Parcel 2.9.0及以上版本官方修复了底层线程变量调用逻辑，升级后基本可以彻底解决问题。
• 第三步：临时兼容方案（若暂时无法升级Parcel版本）
  构建时添加--no-scope-hoist参数绕过触发bug的逻辑，修改后的构建命令为：

  npx parcel build theme/app-home.tsx --log-level verbose --no-scope-hoist
  

  该方案仅会略微增大构建产物体积，不影响功能正常运行。
• 额外检查项
  补充代码中缺失的ProductItemProps类型定义或导入，避免TypeScript类型推断异常触发Transformer边界bug。

内容的提问来源于stack exchange，提问作者Diego de Sousa