Flutter构建Release APK失败：SigningConfig缺失storeFile属性

这个错误是因为你的Android release版本签名配置缺失了密钥文件路径，按以下步骤解决：

1. 生成签名密钥（无密钥时执行） #

打开终端/命令提示符，执行密钥生成命令：

• Mac/Linux：

  keytool -genkey -v -keystore ~/key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key
  

• Windows：

  keytool -genkey -v -keystore C:\Users\你的用户名\key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key
  

执行时按提示输入密钥库密码、密钥密码等信息，记住这些参数后续要用到。

2. 创建密钥配置文件 #

在项目的android/app目录下新建key.properties文件，填入以下内容（替换为你自己的参数）：

storePassword=你的密钥库密码
keyPassword=你的密钥密码
keyAlias=key
storeFile=密钥文件的绝对路径（比如~/key.jks 或 C:\\Users\\你的用户名\\key.jks）

注意Windows路径要用双反斜杠转义，或直接用正斜杠。

3. 修改Android构建配置 #

打开android/app/build.gradle文件，做以下修改：

• 在android代码块开头添加密钥配置加载逻辑：

  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配置，关联签名：

  buildTypes {
      release {
          signingConfig signingConfigs.release
          // 保留原有的其他配置（如minifyEnabled等）
      }
  }
  

4. 重新打包APK #

先清理旧构建缓存：

flutter clean

再执行打包命令：

flutter build apk

常见注意事项 #

• 确保key.properties里的storeFile路径完全正确，路径错误是最常见的问题
• 不要把key.properties和密钥文件提交到版本控制，可添加到.gitignore中
• 如果之前修改过配置但未生效，检查build.gradle是否有语法错误或配置遗漏

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