Flutter多Flavor终端构建AppBundle时签名密钥错误排查

• 检查Flavor与签名配置的绑定关系
  确认android/app/build.gradle中，每个企业对应的productFlavor，其release构建类型是否正确关联了目标签名配置。如果不同企业使用独立签名密钥，需为每个Flavor单独指定签名配置，示例如下：

  flavorDimensions "enterprise"
  productFlavors {
    companyA {
      dimension "enterprise"
      signingConfig signingConfigs.companyA
    }
    // 其余9家企业的Flavor配置
  }
  buildTypes {
    release {
      // 确保未覆盖签名配置
    }
  }
  

• 验证key.properties加载逻辑

  1. 确认key.properties文件路径正确：构建脚本中加载路径通常为rootProject.file('key.properties')，需保证文件位于项目根目录而非android子目录。
  2. 检查文件内配置项拼写：storeFile、storePassword、keyAlias、keyPassword需与实际密钥信息完全匹配，避免大小写或拼写错误。

• 明确指定构建类型参数
  终端构建时需明确指定--release参数，确保构建的是已配置签名的Release版本，完整命令示例：

  flutter build appbundle --release -t lib/xxx_main.dart --flavor=xxx
  

• 检查文件权限（Linux/macOS环境）
  确保终端当前用户对key.properties和JKS密钥文件拥有读取权限，可通过以下命令调整：

  chmod 644 key.properties
  chmod 644 your-enterprise-key.jks
  

• 排查签名配置覆盖问题
  检查build.gradle中是否存在Flavor或BuildType层级的签名配置覆盖，比如某些Flavor的release类型中设置了signingConfig null，这会导致终端构建时跳过签名步骤。

内容的提问来源于stack exchange，提问作者Hüseyin Bedir