概述

在使用 electron-forge 打包 Electron 应用时，经常会遇到 ECONNRESET（连接重置）错误。这个错误通常发生在下载 Electron 二进制文件的过程中，特别是在网络环境受限的情况下。本文档详细分析了该问题的原因，并提供了多种实用的解决方案。

这个错误表明在打包过程中，electron-forge 尝试从远程服务器下载 Electron 二进制文件时，网络连接被重置了。

问题原因分析

ECONNRESET 错误表示网络连接被重置，通常发生在以下情况：

1. 网络不稳定

在下载 Electron 二进制文件（通常几十到几百 MB）时，网络连接中断或不稳定，导致下载失败。

2. 防火墙/代理拦截

企业防火墙或代理服务器可能会阻止或限制对 GitHub 等外部服务器的访问，导致连接被重置。

3. 访问 GitHub 受限

electron-forge 默认从 GitHub 下载 Electron 二进制文件。在某些地区，由于网络限制，访问 GitHub 可能不稳定或被阻止。

4. 下载超时

Electron 二进制文件较大，如果网络速度较慢，可能会超过默认的超时时间，导致连接被重置。

5. 并发连接限制

某些网络环境对并发连接数有限制，多个下载任务同时进行时可能导致连接被重置。

---

解决方案

方案 1：配置 Electron 镜像源（推荐⭐⭐⭐）

使用国内镜像源可以显著提高下载速度和稳定性。这是最推荐的解决方案。

方法 A：使用 .npmrc 文件（项目级配置）

在项目根目录创建或编辑 .npmrc 文件：

electron_mirror=https://npmmirror.com/mirrors/electron/
electron_builder_cache=C:\Users\你的用户名\AppData\Local\electron-builder\Cache

优点：

• 配置跟随项目，团队成员都能使用
• 不需要每次手动设置环境变量
• 版本控制友好

方法 B：设置环境变量（系统级配置）

Windows PowerShell（临时设置）：

# 设置 Electron 镜像源
$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
$env:ELECTRON_BUILDER_CACHE="C:\Users\$env:USERNAME\AppData\Local\electron-builder\Cache"

# 然后运行打包命令
npm run make

Windows PowerShell（永久设置）：

# 设置用户级环境变量
[System.Environment]::SetEnvironmentVariable('ELECTRON_MIRROR', 'https://npmmirror.com/mirrors/electron/', 'User')
[System.Environment]::SetEnvironmentVariable('ELECTRON_BUILDER_CACHE', "$env:LOCALAPPDATA\electron-builder\Cache", 'User')

# 设置后需要重新打开终端

Linux/macOS：

# 临时设置
export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
npm run make

# 永久设置（添加到 ~/.bashrc 或 ~/.zshrc）
echo 'export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"' >> ~/.bashrc
source ~/.bashrc

常用镜像源

• 淘宝镜像（推荐）：https://npmmirror.com/mirrors/electron/
• 腾讯云镜像：https://mirrors.cloud.tencent.com/electron/
• 华为云镜像：https://mirrors.huaweicloud.com/electron/

---

方案 2：使用代理

如果你有可用的代理服务器（如科学上网工具），可以配置代理来访问 GitHub。

Windows PowerShell：

# 设置代理（根据你的代理端口调整）
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:NO_PROXY="localhost,127.0.0.1"

npm run make

Linux/macOS：

export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export NO_PROXY="localhost,127.0.0.1"

npm run make

注意：代理端口号（如 7890）需要根据你的实际代理配置进行调整。

---

方案 3：手动下载 Electron 二进制文件

如果网络问题持续存在，可以手动下载 Electron 二进制文件。

步骤 1：查看需要的 Electron 版本

npm list electron

或者查看 package.json 中的版本号。

步骤 2：下载对应版本

访问 Electron 发布页面：

• GitHub Releases: https://github.com/electron/electron/releases
• 或使用镜像源：https://npmmirror.com/mirrors/electron/

下载对应平台和架构的 Electron 二进制文件：

• Windows x64: electron-v39.2.3-win32-x64.zip
• Windows ia32: electron-v39.2.3-win32-ia32.zip
• macOS x64: electron-v39.2.3-darwin-x64.zip
• Linux x64: electron-v39.2.3-linux-x64.zip

步骤 3：放置到缓存目录

Windows：

%LOCALAPPDATA%\electron\Cache\

Linux：

~/.cache/electron/

macOS：

~/Library/Caches/electron/

将下载的 zip 文件解压后放到对应的缓存目录中。

---

调试技巧

1. 检查网络连接

Windows PowerShell：

# 测试 GitHub 连接
Test-NetConnection github.com -Port 443

# 测试镜像源连接
Test-NetConnection npmmirror.com -Port 443

Linux/macOS：

# 测试连接
curl -I https://github.com
curl -I https://npmmirror.com

2. 查看详细日志

启用 electron-forge 的详细日志输出：

Windows PowerShell：

$env:DEBUG="electron-forge:*"
npm run make

Linux/macOS：

DEBUG=electron-forge:* npm run make

3. 清理缓存后重试

有时候缓存文件损坏也会导致问题：

Windows PowerShell：

# 清理 Electron 缓存
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\electron\Cache\*" -ErrorAction SilentlyContinue

# 清理 npm 缓存
npm cache clean --force

# 重新安装依赖
npm install

# 重新打包
npm run make

Linux/macOS：

# 清理 Electron 缓存
rm -rf ~/.cache/electron/*

# 清理 npm 缓存
npm cache clean --force

# 重新安装依赖
npm install

# 重新打包
npm run make

4. 检查防火墙设置

确保防火墙没有阻止 Node.js 或 npm 的网络访问。

5. 使用网络监控工具

使用网络监控工具（如 Wireshark、Fiddler）查看具体的网络请求和响应，帮助定位问题。

---

以上选择配置镜像源后，然后打包后就可以成功了：

总结

ECONNRESET 错误主要是由于网络连接问题导致的。通过配置 Electron 镜像源（方案 1）通常可以快速解决这个问题。如果问题持续存在，可以尝试其他方案或使用替代工具。

---

欢迎加入开源鸿蒙PC社区：https://harmonypc.csdn.net/