Flutter打包Release APK报错：SigningConfig缺失storePassword（环境变量已配置）

我在Flutter项目中构建Release APK时，通过build.gradle的System.getenv(name)读取密钥信息，配置如下：

release {
    keyAlias 'e-commerce-alias'
    keyPassword System.getenv("KEYPASSWORD")
    storePassword System.getenv("STOREPASSWORD")
    storeFile file("e-commerce.keystore")
}

本地Linux环境已在.bashrc中配置环境变量并执行source ~/.bashrc，配置内容：

export KEYPASSWORD="****"
export STOREPASSWORD="****"
export KEY_STORE_PATH="/home/omer358/Documents/keystore_files/e-commerce-releasa.keystore"

本地执行echo $STOREPASSWORD能正常输出值，说明环境变量已生效，但构建时仍报错。

GitHub Actions中已将密钥设为仓库机密，并在build.yaml中写入GITHUB_ENV：

# Set environment variables
- name: Set environment variables
  run: |
    echo "export KEYPASSWORD=${{ secrets.E_COMMERCE_KEY_PASSWORD }}" >> $GITHUB_ENV
    echo "export STOREPASSWORD=${{ secrets.E_COMMERCE_STORE_PASSWORD }}" >> $GITHUB_ENV

构建时始终提示SigningConfig "release" is missing required property "storePassword"，但硬编码keyPassword和storePassword时可正常打包安装。

本地环境解决方案 #

• 确保执行构建的终端已加载最新环境变量：如果是通过.bashrc配置的，关闭终端重新打开，或者在当前终端执行source ~/.bashrc后再运行构建命令。也可直接在当前终端手动导出变量后构建：

  export KEYPASSWORD="你的密钥密码"
  export STOREPASSWORD="你的仓库密码"
  flutter build apk --release
  

• 检查storeFile路径：当前配置使用相对路径file("e-commerce.keystore")，确保文件存在于项目对应目录；或者改用已配置的环境变量路径：

  storeFile file(System.getenv("KEY_STORE_PATH"))
  

GitHub Actions环境解决方案 #

• 修正GITHUB_ENV写入格式：不需要添加export，直接使用变量名=值的格式，GitHub Actions会自动注入环境变量：

  # Set environment variables
  - name: Set environment variables
    run: |
      echo "KEYPASSWORD=${{ secrets.E_COMMERCE_KEY_PASSWORD }}" >> $GITHUB_ENV
      echo "STOREPASSWORD=${{ secrets.E_COMMERCE_STORE_PASSWORD }}" >> $GITHUB_ENV
  

• 调整步骤顺序：确保环境变量设置步骤在构建步骤之前执行，避免构建时变量未生效。
• 验证变量设置（可选）：在构建前添加打印步骤，确认变量已正确注入：

  - name: Verify environment variables
    run: |
      echo "KEYPASSWORD set: ${{ env.KEYPASSWORD != '' }}"
      echo "STOREPASSWORD set: ${{ env.STOREPASSWORD != '' }}"
  

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