GitHub Actions构建Flutter APK时提示Keystore文件缺失如何解决

报错核心原因是GitHub Actions的运行环境为临时独立虚拟机，不存在你本地存储的upload-keystore.jks签名文件，build.gradle中配置的固定路径无法定位到对应文件。

步骤1：将密钥库信息存入GitHub Secrets #

首先在本地将upload-keystore.jks转为base64编码：

• macOS/Linux 执行命令：base64 -i upload-keystore.jks | pbcopy （执行后base64内容会直接复制到剪贴板）
• Windows 可在Git Bash中执行：base64 -w 0 upload-keystore.jks | clip

随后进入GitHub仓库的「Settings → Secrets and variables → Actions」，点击「New repository secret」添加以下4个密钥：

• KEYSTORE_BASE64：值为刚才复制的base64编码内容
• KEYSTORE_PASSWORD：密钥库密码
• KEY_ALIAS：签名key的别名
• KEY_PASSWORD：签名key的密码

步骤2：修改GitHub Actions工作流配置 #

在执行Android构建的步骤之前，新增两个步骤，动态生成密钥库文件和签名配置文件：

- name: 创建密钥库存储目录并生成jks文件
  run: |
    mkdir -p android/app/keystore
    echo "${{ secrets.KEYSTORE_BASE64 }}" | base64 --decode > android/app/keystore/upload-keystore.jks
  shell: bash

- name: 生成签名配置文件key.properties
  run: |
    echo "storePassword=${{ secrets.KEYSTORE_PASSWORD }}" > android/key.properties
    echo "keyPassword=${{ secrets.KEY_PASSWORD }}" >> android/key.properties
    echo "keyAlias=${{ secrets.KEY_ALIAS }}" >> android/key.properties
    echo "storeFile=keystore/upload-keystore.jks" >> android/key.properties
  shell: bash

步骤3：确认build.gradle签名配置 #

检查android/app/build.gradle中的release签名配置，确认是从key.properties读取配置，而非硬编码路径和密码，参考配置如下：

def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}

android {
    // 其余配置省略
    signingConfigs {
        release {
            keyAlias keystoreProperties['keyAlias']
            keyPassword keystoreProperties['keyPassword']
            storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
            storePassword keystoreProperties['storePassword']
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
            // 其余配置省略
        }
    }
}

注意事项 #

• 务必将upload-keystore.jks、key.properties加入项目的.gitignore文件，禁止提交到代码仓库
• GitHub Secrets会自动脱敏，不会在运行日志中泄露明文内容
• 确保配置的文件路径和build.gradle中读取的路径完全一致，避免路径不匹配问题

内容的提问来源于stack exchange，提问作者s3tupw1zard