Windows环境下Next.js15搭配Turbopack报错：turbo.createProject不支持Wasm绑定

问题原因 #

该报错源于当前Next.js 15.1.7版本与Turbopack的Wasm绑定存在兼容性问题，或是Windows环境下的适配缺陷。

解决方案 #

• 升级Next.js到最新稳定版
  新版本会修复Turbopack相关的兼容性bug，执行对应包管理器命令升级：

  # npm
  npm install next@latest
  # yarn
  yarn add next@latest
  # pnpm
  pnpm add next@latest
  

  升级完成后重新执行next dev --turbopack。

• 清除缓存后重试
  缓存或损坏的依赖可能导致绑定异常，按以下步骤操作：

  1. 删除依赖目录与锁文件（PowerShell命令）：

     Remove-Item -Recurse -Force node_modules, package-lock.json, yarn.lock, pnpm-lock.yaml
     

  2. 重新安装依赖：

     npm install # 或 yarn install / pnpm install
     

  3. 再次启动项目：next dev --turbopack

• 强制使用Turbopack原生Node.js绑定
  绕过Wasm绑定限制，通过环境变量指定使用原生绑定：

  • Windows Cmd：

    set TURBOPACK_USE_NATIVE=1 && next dev --turbopack
    

  • Windows PowerShell：

    $env:TURBOPACK_USE_NATIVE=1; next dev --turbopack
    

• 检查并升级Node.js版本
  Next.js 15推荐使用Node.js v20.x及以上版本，版本过低可能引发兼容性问题：

  1. 查看当前Node.js版本：node -v
  2. 若版本不符，升级到官方推荐的稳定版本后重试。

内容的提问来源于stack exchange，提问作者usman wasif