You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

GitHub Actions构建Electron应用失败,请求协助排查修复

解决GitHub Actions构建Electron应用的网络连接失败问题

问题分析

从报错截图来看,核心问题是构建过程中无法正常连接GitHub资源(大概率是Electron二进制包下载或Release上传环节的网络/权限问题),结合你的配置文件,给出以下针对性修复方案:

修复步骤

1. 补全GITHUB_TOKEN权限

默认的GITHUB_TOKEN没有创建Release的权限,需要在工作流中显式配置:
在jobs.release节点下添加权限声明:

jobs:
  release:
    runs-on: ${{ matrix.os }}
    permissions:
      contents: write  # 赋予创建Release的必要权限
    strategy:
      matrix:
        os: [macos-latest, ubuntu-latest, windows-latest]

2. 切换Electron国内镜像源

GitHub Actions runner默认访问GitHub官方源可能出现网络波动,通过环境变量切换国内镜像加速下载:
在构建步骤前新增镜像配置步骤:

- name: Set Electron domestic mirror
  run: |
    echo "ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/" >> $GITHUB_ENV
    echo "ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/" >> $GITHUB_ENV

3. 使用稳定版action分支

你当前使用的master分支属于开发分支,可能存在兼容性问题,切换到指定稳定版本(以v1.4.0为例,可根据仓库最新稳定版调整):

uses: ResearchHelper/action-electron-builder@v1.4.0

4. 可选:添加网络连通性测试

如果以上操作仍无效,可在构建前添加网络测试步骤,确认runner能否正常访问GitHub:

- name: Test GitHub connectivity
  run: curl -v https://api.github.com

修改后的完整配置

name: Build/release

on:
  push:
    tags:
      - v*

jobs:
  release:
    runs-on: ${{ matrix.os }}
    permissions:
      contents: write
    strategy:
      matrix:
        os: [macos-latest, ubuntu-latest, windows-latest]

    steps:
      - name: Check out Git repository
        uses: actions/checkout@v3

      - name: Install Node.js, NPM and Yarn
        uses: actions/setup-node@v3
        with:
          node-version: 16

      - name: Set Electron domestic mirror
        run: |
          echo "ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/" >> $GITHUB_ENV
          echo "ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/" >> $GITHUB_ENV

      - name: Build/release Electron app
        uses: ResearchHelper/action-electron-builder@v1.4.0
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          skip_build: true
          release: true

内容的提问来源于stack exchange,提问作者Jack251970

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.22 10:52:17