React Native项目执行npm start卡在Starting Packager的问题求助

AI 小北

2026-5-29

解决React Native项目npm start卡在Starting Packager的问题

针对你遇到的情况——用create-react-native-app创建的项目，之前npm start正常运行，现在却卡在Starting Packager阶段，且重装依赖的方法已经失效，结合你的环境（Ubuntu 16.04、Node v10.0.0、npm 6.0.0、RN 0.54.0），给你几个逐步排查的解决方案，建议按顺序尝试：

彻底清除Metro缓存：缓存损坏是这类启动卡住问题的常见诱因，执行以下命令清理后再尝试启动：
```
watchman watch-del-all
rm -rf $TMPDIR/react-native-packager-cache-*
rm -rf $TMPDIR/metro-bundler-cache-*
npm start -- --reset-cache
```
提示：如果系统未安装watchman，先通过sudo apt install watchman完成安装。
检查Node/npm版本兼容性：React Native 0.54.0官方推荐的Node版本是8.x系列，你当前使用的Node v10.0.0可能存在版本兼容问题。可以用nvm管理Node版本，切换到8.x的稳定版本（比如8.17.0）后重新配置依赖：
```
# 若已安装nvm，安装Node 8.17.0
nvm install 8.17.0
# 切换到该版本
nvm use 8.17.0
# 重置依赖
rm -rf node_modules package-lock.json
npm install
```
避免全局CLI与项目版本冲突：你当前的react-native-cli是2.0.1，和RN 0.54.0可能存在版本不匹配的问题。可以卸载全局CLI，改用项目内置的命令启动：
```
npm uninstall -g react-native-cli
# 用npx调用项目内的react-native命令启动
npx react-native start --reset-cache
```
检查端口占用情况：Metro默认使用8081端口，可能被其他进程占用导致启动卡住。先查看端口占用状态：
```
sudo lsof -i :8081
```
如果输出结果中有占用8081的进程，记录对应的PID，执行kill -9 <PID>杀掉进程后再重新启动项目。
完全重置依赖环境：除了删除node_modules，还要删除锁文件避免依赖版本残留，再清理npm缓存后重装：
```
rm -rf node_modules package-lock.json
npm cache clean --force
npm install
npm start -- --reset-cache
```