端口占用 / 依赖安装失败

环境常见问题排查

在 React Native 开发过程中，我们可能会遇到各种环境问题。本节将介绍如何排查和解决端口占用和依赖安装失败的问题。

1. 端口占用问题

症状

Expo 开发服务器无法启动，提示端口被占用
运行 npx expo start 时出现 "Port 8081 is already in use" 错误
模拟器无法连接到开发服务器

解决方案

方法一：指定不同的端口

使用 --port 参数
- 运行以下命令：
  bash
```
npx expo start --port 8082
```
- 这将使用 8082 端口启动开发服务器

方法二：查找并关闭占用端口的进程

查找占用端口的进程
- 在 Windows 上，运行：
  bash
```
netstat -ano | findstr :8081
```
- 在 Mac 上，运行：
  bash
```
lsof -i :8081
```
关闭占用端口的进程
- 在 Windows 上，运行：
  bash
```
taskkill /PID <进程ID> /F
```
- 在 Mac 上，运行：
  bash
```
kill -9 <进程ID>
```

方法三：重启电脑

如果以上方法都不起作用，尝试重启电脑，这通常会释放所有占用的端口

2. 依赖安装失败问题

症状

运行 npm install 或 npx expo install 时失败
出现 "npm ERR!" 或 "Error: Unable to resolve module" 错误
依赖安装过程中卡住或超时

解决方案

方法一：配置国内镜像

设置 npm 镜像

运行以下命令：

bash

npm config set registry https://registry.npmmirror.com/

设置 yarn 镜像（如果使用 yarn）
- 运行以下命令：
  bash
```
yarn config set registry https://registry.npmmirror.com/
```

方法二：清除 npm 缓存

清除缓存
- 运行以下命令：
  bash
```
npm cache clean --force
```
重新安装依赖
- 运行以下命令：
  bash
```
npm install
```

方法三：使用 --legacy-peer-deps 选项

运行以下命令：
bash
```
npm install --legacy-peer-deps
```
这将忽略 peer dependency 冲突

方法四：使用 Expo 修复命令

运行以下命令：
bash
```
npx expo install --fix
```
这将修复 Expo 项目的依赖问题

3. 网络问题

症状

依赖下载速度慢
依赖下载超时
Expo 命令无法连接到服务器

解决方案

方法一：使用代理

配置 npm 代理：

bash

npm config set proxy http://your-proxy-server:port
npm config set https-proxy http://your-proxy-server:port

方法二：使用 VPN

连接到 VPN 后再尝试安装依赖

方法三：手动下载依赖

对于某些特定的依赖，可以从官方网站下载后手动安装

4. 权限问题

症状

安装依赖时出现 "EACCES: permission denied" 错误
无法创建或修改文件

解决方案

方法一：使用 sudo 命令（Mac/Linux）

运行以下命令：
bash
```
sudo npm install
```

方法二：修改 npm 全局安装目录（推荐）

创建新的全局安装目录
- 运行以下命令：
  bash
```
mkdir ~/.npm-global
```
配置 npm 使用新目录
- 运行以下命令：
  bash
```
npm config set prefix '~/.npm-global'
```
更新环境变量
- 在 .bashrc 或 .zshrc 文件中添加：
  bash
```
export PATH=~/.npm-global/bin:$PATH
```
使配置生效
- 运行以下命令：
  bash
```
source ~/.bashrc
# 或
source ~/.zshrc
```

5. 总结

端口占用和依赖安装失败是 React Native 开发中常见的问题。通过本文介绍的方法，你应该能够解决大多数环境问题。

如果以上方法都不起作用，你可以尝试：

查看详细的错误信息，了解具体的问题原因
搜索相关错误信息，寻找解决方案
重新初始化项目
咨询社区或寻求专业帮助

下一节，我们将介绍模拟器无法连接和项目启动报错的问题排查方法。

端口占用 / 依赖安装失败 ​

环境常见问题排查 ​

1. 端口占用问题 ​

症状 ​

解决方案 ​

方法一：指定不同的端口 ​

方法二：查找并关闭占用端口的进程 ​

方法三：重启电脑 ​

2. 依赖安装失败问题 ​

症状 ​

解决方案 ​

方法一：配置国内镜像 ​

方法二：清除 npm 缓存 ​

方法三：使用 --legacy-peer-deps 选项 ​

方法四：使用 Expo 修复命令 ​

3. 网络问题 ​

症状 ​

解决方案 ​

方法一：使用代理 ​

方法二：使用 VPN ​

方法三：手动下载依赖 ​

4. 权限问题 ​

症状 ​

解决方案 ​

方法一：使用 sudo 命令（Mac/Linux） ​

方法二：修改 npm 全局安装目录（推荐） ​

5. 总结 ​

端口占用 / 依赖安装失败

环境常见问题排查

1. 端口占用问题

症状

解决方案

方法一：指定不同的端口

方法二：查找并关闭占用端口的进程

方法三：重启电脑

2. 依赖安装失败问题

症状

解决方案

方法一：配置国内镜像

方法二：清除 npm 缓存

方法三：使用 --legacy-peer-deps 选项

方法四：使用 Expo 修复命令

3. 网络问题

症状

解决方案

方法一：使用代理

方法二：使用 VPN

方法三：手动下载依赖

4. 权限问题

症状

解决方案

方法一：使用 sudo 命令（Mac/Linux）

方法二：修改 npm 全局安装目录（推荐）

5. 总结