Electron/Firebase项目CI/CD构建遇PAT未设置等多问题求助

核心问题：GH_TOKEN环境变量不匹配 #

错误提示明确要求环境变量名为GH_TOKEN，但你的配置中使用的是GITHUB_TOKEN，Electron Builder等发布工具默认读取GH_TOKEN，这是导致认证失败的直接原因。

修复步骤： #

• 在Publish步骤中替换环境变量名：

  - name: Publish
    run: npm run publish
    env:
      GH_TOKEN: ${{ secrets.SECRET_KEY }}
  

• 确认你的PAT权限：必须勾选repo下所有子权限，组织私有仓库需确保PAT拥有对应组织的访问权限（创建PAT时选择指定组织或全部组织）。
• 检查npm run publish对应的脚本（如electron-builder publish），确保代码中没有硬编码或覆盖GH_TOKEN变量。

其他构建问题处理 #

Docker构建失败 #

• 确保Dockerfile中的Node.js版本与Actions中使用的16.x一致。
• 安装Electron构建依赖：Linux环境需安装libgtk-3-0、libnss3等系统库；Windows环境需确保Docker容器拥有足够权限。
• 私有仓库依赖拉取：配置NODE_AUTH_TOKEN环境变量，用PAT认证私有npm/git仓库。

Electron图标不生效 #

• 确保图标格式对应平台：Windows用.ico（256x256）、macOS用.icns、Linux用.png。
• 在package.json的build字段中明确指定图标路径：

  "build": {
    "win": {
      "icon": "build/icon.ico"
    }
  }
  

7-Zip权限错误 #

• 在Windows Runner上，给7-Zip二进制文件添加执行权限，或使用系统自带的压缩工具替代。
• 若使用自定义7-Zip，在构建前执行chmod +x path/to/7z.exe赋予权限。

自动更新配置 #

• 在Electron应用中配置autoUpdater指向GitHub Releases：

  const { autoUpdater } = require("electron-updater");
  
  autoUpdater.setFeedURL({
    provider: "github",
    owner: "你的组织名",
    repo: "你的仓库名"
  });
  

• 确保package.json中的version与GitHub标签版本完全匹配（如标签v1.0.0对应"version": "1.0.0"）。

调整后的完整release.yml配置 #

name: Release

on:
  push:
    tags:
      - 'v*.*.*'

jobs:
  release:
    runs-on: windows-latest
    permissions:
      contents: write

    steps:
    - name: Checkout code
      uses: actions/checkout@v3
      with:
        fetch-depth: 0 # 确保获取完整Git历史，满足Electron Builder需求

    - name: Setup Node.js
      uses: actions/setup-node@v3
      with:
        node-version: '16'
        cache: 'npm' # 缓存依赖加速构建

    - name: Install dependencies
      run: npm install
      env:
        NODE_AUTH_TOKEN: ${{ secrets.SECRET_KEY }} # 私有依赖认证用

    - name: Generate release info
      run: |
        echo "Release information for version ${{ github.ref_name }}" > release-info.md
        echo "Download your app from the assets below or from: Google Drive (ID: 1ozNzQRQdilmfNHfx-sga1WLCN2qo-mgP)" >> release-info.md

    - name: Build
      run: npm run build
      env:
        GH_TOKEN: ${{ secrets.SECRET_KEY }} # 部分构建工具可能需要该token

    - name: Publish
      run: npm run publish
      env:
        GH_TOKEN: ${{ secrets.SECRET_KEY }}

    - name: Create Release
      uses: softprops/action-gh-release@v1
      with:
        files: |
          dist/*.exe
          dist/*.yml
        body_path: release-info.md
      env:
        GITHUB_TOKEN: ${{ secrets.SECRET_KEY }} # 该Action默认使用GITHUB_TOKEN

注意：将Generate release info步骤移至Create Release之前，避免引用未生成的文件。

内容的提问来源于stack exchange，提问作者Rodrigo Galvão