使用新Keystore签名Flutter应用时遇错误的解决方法

一、验证新keystore的有效性 #

• 确认keystore创建流程合规，标准创建命令：
  keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload
  注意创建时密钥库密码、密钥密码（若分开设置）和别名要准确记录，避免混淆
• 用命令验证keystore是否正常可读：
  keytool -list -v -keystore 你的keystore完整路径
  输入密码后若能正常输出密钥详情，说明keystore本身无损坏

二、检查项目签名配置准确性 #

• 打开android/app/build.gradle，确保签名配置与keystore信息完全匹配：

  signingConfigs {
       release {
           keyAlias '你的密钥别名'
           keyPassword '你的密钥密码'
           storeFile file('keystore文件路径，如../upload-keystore.jks')
           storePassword '你的密钥库密码'
       }
   }
   buildTypes {
       release {
           signingConfig signingConfigs.release
           // 其他构建配置
       }
   }
  

  重点核对：路径是否正确（keystore放在项目根目录则用../前缀，放在android目录下直接写文件名）、密码无拼写错误或不可见字符

三、清理缓存后重新构建 #

• 执行Flutter缓存清理：
  flutter clean
• 进入android目录清理gradle缓存：
  cd android && ./gradlew clean
• 重新构建release包：
  flutter build apk --release

四、排除环境兼容性问题 #

• 确保创建keystore的JDK版本与当前构建环境一致（推荐JDK 8或11，避免跨版本兼容性问题）
• Windows系统需检查keystore文件权限，确保当前用户拥有读取权限
• 不要将keystore放在含中文的路径下，避免编码解析错误

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