启动Next.js项目时出现Bus error (core dumped)错误求助
2026-8-11
Next.js
npm run dev启动错误排查方案 以下是针对启动失败的常见解决步骤：
- 验证Node.js版本：Next.js要求Node.js版本≥18.17.0（LTS版本），执行
node -v查看当前版本，版本不符则升级到官方推荐版本。 - 重装项目依赖：删除项目根目录下的
node_modules文件夹和package-lock.json文件，然后执行npm install重新拉取依赖。 - 清理缓存文件：删除
.next文件夹，或者执行npx next cache命令清除Next.js缓存，之后再尝试启动。 - 排查端口占用：默认启动端口3000可能被其他进程占用，可通过以下命令排查：
- Mac/Linux：
lsof -i :3000，找到进程后用kill -9 <进程ID>终止 - Windows：
netstat -ano | findstr ":3000"，通过任务管理器终止对应进程
也可以指定其他端口启动：npm run dev -- -p 3001
- Mac/Linux：
- 检查配置文件：确认
next.config.js中无语法错误（如括号不匹配、配置项拼写错误），若有自定义配置可临时注释后测试。 - 查看完整日志：若终端提示信息不足，可查看项目根目录
.next/logs下的日志文件，获取更详细的错误堆栈信息。
内容的提问来源于stack exchange，提问作者Cletus Kingdom
相关产品推荐
相关产品推荐
