Next.js开发服务器加载SWC二进制文件失败问题求助

问题概述 #

使用yarn run dev启动Next.js 14.0.3项目时，出现动态链接库（DLL）初始化例程失败错误，具体为加载E:\SProject\my-app\node_modules@next\swc-win32-ia32-msvc\next-swc.win32-ia32-msvc.node文件失败，属于Win32/IA32环境下的SWC二进制文件加载异常。

排查步骤 #

• 检查Node.js架构：执行node -p "process.arch"命令，确认输出是否为ia32（32位）或x64（64位）。SWC二进制文件必须与Node.js架构完全匹配，否则会触发加载失败。
• 验证依赖完整性：
  1. 删除项目下的node_modules文件夹（Windows命令：rd /s /q node_modules）
  2. 清理Yarn缓存：yarn cache clean
  3. 重新安装依赖：yarn install
• 检查系统依赖：确认已安装最新版Microsoft Visual C++ Redistributable，SWC运行依赖该组件。
• 确认版本兼容性：检查当前Node.js版本是否在Next.js 14.0.3的兼容范围内（推荐使用Node.js 18.x或20.x LTS版本）。

解决方案 #

1. 架构不匹配修复：
   • 若系统是64位但安装了32位Node.js，卸载32位版本，重新安装64位Node.js，再执行yarn install重新拉取对应架构的SWC二进制文件。
   • 若必须使用32位Node.js，尝试降级Next.js到13.x系列版本（部分旧版本对32位环境支持更稳定），修改package.json中的next版本后重新安装依赖。
2. 修复VC++运行时：
   下载对应架构的Microsoft Visual C++ Redistributable安装包完成安装，重启电脑后再尝试启动项目。
3. 清理SWC缓存：
   删除项目根目录下的.next/cache文件夹，然后执行yarn run dev重新生成缓存文件。

内容的提问来源于stack exchange，提问作者Awais Ahmad