yarn install 报错【There appears to be trouble with your network connection. Retrying...】解决方案（五种情况分析解决）

Yarn 报错 `There appears to be trouble with your network connection. Retrying...` 解决方案

在使用 yarn install 安装前端依赖时，报错信息 There appears to be trouble with your network connection. Retrying... 是一个常见的网络连接错误。这种错误可能由网络配置、DNS 问题、代理设置、yarn 缓存、或依赖镜像源不可用等多个因素引起。本文将分析五种可能的情况，并提供相应的解决方案。

一、网络连接问题

1.1 错误描述

该错误表明 Yarn 无法访问外部网络，可能由于网络连接中断或网络配置不正确导致 Yarn 无法下载所需的包。

1.2 解决方案

检查网络连接：
使用 ping 命令测试与外部网络的连通性，确保服务器或本地机器可以访问互联网。
```
ping google.com
```
重启网络：
如果网络连接不稳定，尝试重启网络设备或更换网络环境。
使用代理：
如果在公司或其他限制网络的环境下工作，可能需要配置代理。使用以下命令为 Yarn 配置代理：
```
yarn config set proxy http://proxy-server:port
yarn config set https-proxy http://proxy-server:port
```

二、DNS 解析问题

2.1 错误描述

Yarn 无法通过 DNS 解析依赖包的下载地址，这可能是 DNS 配置不正确或公共 DNS 服务器不可访问引起的。

2.2 解决方案

更换 DNS 服务器：
编辑 /etc/resolv.conf 文件（对于 Linux 系统），将 DNS 服务器配置为公共 DNS，如 Google 的 8.8.8.8：
```
nameserver 8.8.8.8
```
在 Windows 系统中，可以通过网络设置更改 DNS 配置。
手动设置 DNS：
通过命令行为 Yarn 设置 DNS 服务器：
```
yarn config set dns 8.8.8.8
```
检查 DNS 缓存：
清理 DNS 缓存，确保没有使用过期或错误的解析结果：
```
sudo systemd-resolve --flush-caches  # Linux
ipconfig /flushdns  # Windows
```

三、依赖包镜像源不可用

3.1 错误描述

默认的 npm 或 Yarn 镜像源可能由于网络问题无法访问，导致依赖包下载失败。

3.2 解决方案

切换到国内镜像源：
对于中国大陆用户，使用国内的 npm 镜像源可以提升下载速度并解决部分网络问题。切换到淘宝镜像源：
```
yarn config set registry https://registry.npmmirror.com
```
确认镜像源的可用性：
通过 curl 或 ping 检查镜像源是否可用，确保能够访问设置的镜像地址。

四、yarn 缓存问题

4.1 错误描述

Yarn 使用缓存来加速依赖包的下载和安装，如果缓存损坏，可能会导致安装失败。

4.2 解决方案

清除 Yarn 缓存：
通过清除 Yarn 缓存来解决缓存损坏导致的问题：
```
yarn cache clean
```
检查缓存目录权限：
确保 Yarn 缓存目录的权限正确，如果权限不足可能导致 Yarn 无法正确读写缓存文件。
```
sudo chown -R $(whoami) ~/.cache/yarn
```
禁用缓存：
如果怀疑缓存问题影响下载，可以临时禁用 Yarn 缓存进行安装：
```
yarn install --no-cache
```

五、防火墙或安全软件的干扰

5.1 错误描述

本地或服务器的防火墙、杀毒软件、或其他安全软件可能阻止了 Yarn 的网络连接，导致无法正常下载依赖包。

5.2 解决方案

检查防火墙设置：
检查操作系统或公司网络中的防火墙设置，确保 Yarn 的网络请求没有被阻止。对于 Linux 用户，可以使用 iptables 或 ufw 工具查看和修改防火墙规则。
```
sudo ufw status
```
检查安全软件：
某些杀毒软件或安全工具可能会干扰网络请求。暂时禁用这些软件，确认是否是它们导致了 Yarn 的网络问题。
允许特定端口的网络流量：
确保 Yarn 使用的端口没有被防火墙阻止。通常，Yarn 需要允许对 80 和 443 端口的网络访问。

六、思维导图

yarn install 报错 "There appears to be trouble with your network connection" 解决方案
    1. 网络连接问题
        1.1 检查网络连接
        1.2 重启网络
        1.3 使用代理
    2. DNS 解析问题
        2.1 更换 DNS 服务器
        2.2 手动设置 DNS
        2.3 清理 DNS 缓存
    3. 依赖包镜像源不可用
        3.1 切换到国内镜像源
        3.2 确认镜像源的可用性
    4. Yarn 缓存问题
        4.1 清除 Yarn 缓存
        4.2 检查缓存目录权限
        4.3 禁用缓存
    5. 防火墙或安全软件干扰
        5.1 检查防火墙设置
        5.2 检查安全软件
        5.3 允许特定端口网络流量

七、总结

在执行 yarn install 时遇到网络连接问题可能由多种因素引起。通过检查网络连接、配置 DNS、切换镜像源、清理缓存以及排除防火墙干扰，可以有效解决大多数 Yarn 安装中的网络问题。