运行npm run android时开发服务器返回500错误，仅本机触发求解决

执行npm run android启动带通知功能的Geofencing（地理围栏）React Native应用时，Metro开发服务器返回错误代码500。该问题仅在我的个人PC上出现，其他PC运行项目完全正常。

报错截图 #

• Metro报错截图：
• Android模拟器报错截图1：
• Android模拟器报错截图2：

已尝试搜索解决方案，但未找到有效修复方法，寻求帮助。

可能的修复步骤 #

1. 清理Metro缓存 #

执行命令清除Metro缓存后重启项目：

npx react-native start --reset-cache

或手动删除项目根目录下的.metro-cache文件夹。

2. 同步依赖与环境版本 #

因其他PC正常，优先排查本地依赖/环境差异：

• 核对本地Node.js版本与正常PC一致，可用nvm管理版本：

  node -v
  

• 删除本地依赖文件后重新安装：

  rm -rf node_modules package-lock.json
  npm install
  

3. 检查Android环境配置 #

• 确认本地Android SDK版本、构建工具版本与正常PC匹配，通过Android Studio的SDK Manager查看调整。
• 尝试创建新模拟器，或清除现有模拟器数据：打开模拟器 → 设置 → 系统 → 重置 → 清除所有数据。

4. 排查端口占用 #

Metro默认使用8081端口，若被占用需释放：

# Windows
netstat -ano | findstr :8081
taskkill /PID <进程ID> /F

# macOS/Linux
lsof -i :8081
kill -9 <进程ID>

释放后重新启动项目。

5. 检查防火墙/代理设置 #

临时关闭防火墙、VPN，或重置代理配置：

npm config set proxy null
npm config set https-proxy null

之后再尝试启动项目。

内容的提问来源于stack exchange，提问作者Wahyu Agung Budiyanto