概述在使用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_mirrorhttps://npmmirror.com/mirrors/electron/ electron_builder_cacheC:\Users\你的用户名\AppData\Local\electron-builder\Cache优点配置跟随项目团队成员都能使用不需要每次手动设置环境变量版本控制友好方法 B设置环境变量系统级配置Windows PowerShell临时设置# 设置 Electron 镜像源$env:ELECTRON_MIRRORhttps://npmmirror.com/mirrors/electron/$env:ELECTRON_BUILDER_CACHEC:\Users\$env:USERNAME\AppData\Local\electron-builder\Cache# 然后运行打包命令npm run makeWindows 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# 临时设置exportELECTRON_MIRRORhttps://npmmirror.com/mirrors/electron/npmrunmake# 永久设置添加到 ~/.bashrc 或 ~/.zshrcechoexport ELECTRON_MIRRORhttps://npmmirror.com/mirrors/electron/~/.bashrcsource~/.bashrc常用镜像源淘宝镜像推荐https://npmmirror.com/mirrors/electron/腾讯云镜像https://mirrors.cloud.tencent.com/electron/华为云镜像https://mirrors.huaweicloud.com/electron/方案 2使用代理如果你有可用的代理服务器如科学上网工具可以配置代理来访问 GitHub。Windows PowerShell# 设置代理根据你的代理端口调整$env:HTTP_PROXYhttp://127.0.0.1:7890$env:HTTPS_PROXYhttp://127.0.0.1:7890$env:NO_PROXYlocalhost,127.0.0.1npm run makeLinux/macOSexportHTTP_PROXYhttp://127.0.0.1:7890exportHTTPS_PROXYhttp://127.0.0.1:7890exportNO_PROXYlocalhost,127.0.0.1npmrunmake注意代理端口号如 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.zipWindows ia32:electron-v39.2.3-win32-ia32.zipmacOS x64:electron-v39.2.3-darwin-x64.zipLinux 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-NetConnectiongithub.com-Port 443# 测试镜像源连接Test-NetConnectionnpmmirror.com-Port 443Linux/macOS# 测试连接curl-Ihttps://github.comcurl-Ihttps://npmmirror.com2. 查看详细日志启用 electron-forge 的详细日志输出Windows PowerShell$env:DEBUGelectron-forge:*npm run makeLinux/macOSDEBUGelectron-forge:*npmrunmake3. 清理缓存后重试有时候缓存文件损坏也会导致问题Windows PowerShell# 清理 Electron 缓存Remove-Item-Recurse-Force$env:LOCALAPPDATA\electron\Cache\*-ErrorAction SilentlyContinue# 清理 npm 缓存npm cache clean--force# 重新安装依赖npm install# 重新打包npm run makeLinux/macOS# 清理 Electron 缓存rm-rf~/.cache/electron/*# 清理 npm 缓存npmcache clean--force# 重新安装依赖npminstall# 重新打包npmrunmake4. 检查防火墙设置确保防火墙没有阻止 Node.js 或 npm 的网络访问。5. 使用网络监控工具使用网络监控工具如 Wireshark、Fiddler查看具体的网络请求和响应帮助定位问题。以上选择配置镜像源后然后打包后就可以成功了总结ECONNRESET错误主要是由于网络连接问题导致的。通过配置 Electron 镜像源方案 1通常可以快速解决这个问题。如果问题持续存在可以尝试其他方案或使用替代工具。源码地址https://atomgit.com/Axxx12345678/harmony-count-app欢迎加入开源鸿蒙PC社区https://harmonypc.csdn.net/