运行Next.js应用时遭遇Err_Connection_Refused错误求助

• 检查端口占用
  先确认3000端口是否被其他进程占用：

  • Windows：执行 netstat -ano | findstr :3000，找到PID后在任务管理器结束对应进程
  • macOS/Linux：执行 lsof -i :3000，用 kill -9 <PID> 杀掉占用进程
    也可以直接指定其他端口启动：npm run dev -- -p 3001，之后访问http://localhost:3001

• 强制绑定localhost启动
  0.0.0.0是监听所有网卡，但部分本地网络配置可能导致访问异常。修改package.json的启动命令：
  将scripts里的dev字段改为next dev -H localhost，然后重新执行npm run dev，再访问http://localhost:3000

• 排查防火墙/安全软件拦截
  本地防火墙、杀毒软件可能会拦截3000端口的请求，临时关闭这类软件后再尝试访问，确认是否是拦截导致的问题

• 验证hosts文件配置
  检查hosts文件是否正确映射localhost到127.0.0.1：

  • Windows路径：C:\Windows\System32\drivers\etc\hosts
  • macOS/Linux路径：/etc/hosts
    确保存在未被注释的一行：127.0.0.1 localhost

• 清理依赖缓存重装
  删除现有依赖文件后重新安装：

  # macOS/Linux
  rm -rf node_modules package-lock.json
  npm install
  npm run dev
  
  # Windows
  rmdir /s node_modules
  del package-lock.json
  npm install
  npm run dev
  

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