create-next-app创建项目后npm run dev报错及进程异常求助

问题描述 #

昨日执行npx create-next-app@latest创建Next.js项目后，运行npm run dev出现Command failed with exit code 1错误，访问https://localhost:3000显示ERR_CONNECTION_REFUSED；今日再次运行npm run dev无报错，但进程自动终止，终端回到命令提示符状态。项目目录无空格。

环境信息 #

• 操作系统：Windows 11 Home（平台win32、架构ia32）
• 工具版本：Node 18.16.0、npm 9.5.1、Yarn 1.22.19（pnpm未安装）
• 依赖版本：next 13.3.0、eslint-config-next 13.3.0、react 18.2.0、react-dom 18.2.0

排查解决方案 #

1. 重置依赖环境 #

执行以下命令清理缓存并重装依赖：

npm cache clean --force
rmdir /s node_modules
del package-lock.json
npm install

完成后重新运行npm run dev测试。

2. 检查端口占用 #

Windows下执行命令查看3000端口占用情况：

netstat -ano | findstr :3000

若输出结果中有PID，打开任务管理器找到对应进程并终止；或指定其他端口启动服务：

npm run dev -- -p 3001

3. 验证Node架构兼容性 #

当前使用ia32架构的Node，部分现代npm包对32位架构支持有限。建议切换至x64版本的Node 18.x，重新安装依赖后测试启动。

4. 临时禁用ESLint排查 #

修改package.json中的dev命令，跳过ESLint检测：

"scripts": {
  "dev": "next dev --no-lint",
  // 其他脚本保持不变
}

运行npm run dev，若服务正常启动，则需检查ESLint配置或依赖版本问题。

5. 获取详细错误日志 #

添加调试参数运行服务，查看更详细的终止原因：

npm run dev -- --debug

也可检查项目根目录下.next/logs文件夹中的日志文件，定位进程终止的具体触发点。

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