Next.js执行npm run dev后localhost无法连接问题求助

问题场景 #

执行以下操作后出现异常：

1. 运行 npx create-next-app@latest 创建空项目
2. 完成项目命名后进入目录：cd project-name
3. 执行 npm run dev 启动开发服务器

命令行输出 info - Using wasm build of next-swc 后服务器直接终止，无法访问 http://localhost:3000。已完成以下排查操作但未解决：

• 用 netstat -ano | findstr :3000 确认3000端口未被占用
• 关闭防火墙及杀毒软件
• 在 C:\Windows\System32\drivers\etc\hosts 中添加 127.0.0.1 localhost 并重启电脑
• 修改 package.json 中的启动端口

环境信息：Windows 10，Node v18.15.0，Next 13.3.0，未使用VPN

可行解决方案 #

1. 清理依赖与缓存 #

• 删除项目根目录下的 node_modules 文件夹
• 删除 package-lock.json 文件
• 执行 npm cache clean --force 清理npm缓存
• 重新安装依赖：npm install，再启动服务器 npm run dev

2. 调整Next.js版本 #

Next.js 13.3.0可能存在特定环境兼容性问题，尝试切换版本：

• 降级到稳定版：npm install next@13.2.4
• 或升级到最新补丁版：npm install next@latest
• 重新执行 npm run dev

3. 禁用SWC构建 #

在项目根目录的 next.config.js 中添加配置，强制使用Babel替代SWC：

/** @type {import('next').NextConfig} */
const nextConfig = {
  swcMinify: false,
}

module.exports = nextConfig

保存后重启开发服务器

4. 检查权限与运行方式 #

• 确认项目目录及 node_modules 文件夹拥有读写权限（右键文件夹→属性→安全→确保当前用户有完全控制权限）
• 以管理员身份打开命令提示符/终端，再执行 npm run dev

5. 重置系统代理设置 #

即使未使用VPN，自动代理可能干扰连接：

• 打开Windows设置→网络和互联网→代理
• 关闭「自动检测设置」，并清空所有手动代理配置

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