CRA/NextJS项目localhost:3000无法访问，0.0.0.0:3000正常求助

API 探路者

2026-8-25

解决方案建议

检查hosts文件映射
打开系统hosts文件：
- Windows：C:\Windows\System32\drivers\etc\hosts
- macOS/Linux：/etc/hosts
  确认是否存在一行 127.0.0.1 localhost，若缺失则添加该行；若存在但被注释（行首带#），去掉注释符号后保存文件。
重置本地网络栈
- Windows：以管理员身份打开命令提示符，依次执行：
```
ipconfig /flushdns
netsh winsock reset
netsh int ip reset
```
  执行完成后重启电脑。
- macOS/Linux：打开终端执行：
```
sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder
```
排查端口占用情况
确认3000端口是否被其他进程占用：
- Windows：
```
netstat -ano | findstr :3000
```
  若有结果，记下对应PID，打开任务管理器结束该进程。
- macOS/Linux：
```
lsof -i :3000
```
  执行kill -9 <PID>（将<PID>替换为实际进程ID）结束占用进程。
临时修改项目启动端口
换一个端口测试是否能正常访问：
- NextJS：修改package.json中的启动命令为"dev": "next dev -p 3001"，启动后访问localhost:3001
- CRA：Windows环境执行set PORT=3001 && npm start，macOS/Linux环境执行PORT=3001 npm start，启动后访问localhost:3001
检查浏览器代理设置
打开浏览器的代理设置界面，确认是否开启了自动代理或手动代理，暂时关闭代理后重新访问localhost:3000。