Next.js 13中yarn dev启动异常：使用next-swc的wasm构建

问题场景 #

启用appDir实验性功能的Next.js 13项目，一台设备上yarn dev可正常运行开发服务器，但另一台Windows设备执行命令后，日志仅输出到info - Using wasm build of next-swc就直接终止，无法正常提供开发服务。环境配置：VSCode、Windows系统，next.js@13、yarn@1.22.19、node@18.14.0。

排查与解决步骤 #

• 清理依赖与构建缓存

  1. 删除项目根目录下的.next构建产物文件夹和node_modules依赖文件夹
  2. 执行yarn cache clean清理yarn全局缓存
  3. 重新执行yarn install完整安装依赖
  4. 再次启动yarn dev测试

• 检查文件权限与路径

  • 以管理员身份运行VSCode，避免因权限不足导致进程无法读写文件
  • 确保项目所在路径无中文、空格或特殊符号（如!@#$），Next.js对非标准路径的兼容性较差

• 调整SWC配置
  日志中显示使用wasm版本的SWC，部分Windows环境下该版本可能存在兼容性问题，可在next.config.js中强制禁用或调整：

  module.exports = {
    experimental: {
      appDir: true,
    },
    swcMinify: false, // 禁用SWC压缩，切换到默认编译逻辑
  }
  

  保存配置后重新启动开发服务器

• 统一Node.js环境
  确认两台设备的Node.js版本完全一致（包括小版本），执行node -v验证。若版本不同，使用nvm切换到18.14.0版本后重新安装依赖

• 排查安全软件干扰
  临时关闭Windows Defender实时保护或第三方杀毒软件，部分安全工具会拦截Next.js的进程或文件操作，导致服务异常终止

内容的提问来源于stack exchange，提问作者Shreyansh Agrawal