执行npm start启动开发服务器失败，浏览器无法访问站点求助
2026-7-21
React项目npm start启动失败问题解决
问题情况
运行npm start后终端卡在“Starting the development server...”提示，浏览器显示“无法访问此站点”。问题出在执行以下命令之后：
npm i -g react-scriptsnpm install react-scripts --savenpm installdel node_modules && npm install
解决步骤
1. 排查端口占用
默认开发服务器使用3000端口，先检查端口是否被占用：
- Windows终端执行：
netstat -ano | findstr :3000 - 找到对应进程ID（PID）后，在任务管理器结束该进程，再重新运行
npm start
2. 清理缓存与重装依赖
- 清理npm缓存：
npm cache clean --force - 删除项目根目录下的
package-lock.json文件 - 重新安装依赖：
npm install
3. 修复react-scripts版本冲突
全局安装的react-scripts可能和本地项目版本冲突：
- 卸载全局版本：
npm uninstall -g react-scripts - 重新安装本地依赖：
npm install - 若仍有问题，指定package.json里的版本安装：
npm install react-scripts@[你的版本号] --save（将[你的版本号]替换为你package.json中react-scripts的实际版本）
4. 检查hosts文件配置
打开C:\Windows\System32\drivers\etc\hosts文件（需管理员权限编辑），确认存在127.0.0.1 localhost这一行，若缺失则添加
5. 换端口启动测试
- Windows终端执行：
set PORT=3001 && npm start - Mac/Linux终端执行：
PORT=3001 npm start
换端口后观察服务器是否能正常启动
内容的提问来源于stack exchange，提问作者Mayur
相关产品推荐
相关产品推荐
