新电脑用AVD调试Flutter项目遇validateSigningDebug构建失败求助

问题描述 #

学习Flutter过程中，旧电脑上项目运行正常，但新电脑仅在使用AVD调试时出现构建失败，Chrome调试无异常。已配置Java SDK环境变量，核心错误为无法创建Keystore，导致:app:validateSigningDebug任务执行失败。

错误信息 #

FAILURE: Build failed with an exception.

• 出错原因：任务 ':app:validateSigningDebug' 执行失败。

  java.util.concurrent.ExecutionException: com.android.builder.utils.SynchronizedFile$ActionExecutionException: java.io.IOException: com.android.ide.common.signing.KeytoolException: Failed to create keystore.

• 建议尝试：

  使用 --stacktrace 选项获取堆栈跟踪信息。
  使用 --info 或 --debug 选项获取更多日志输出。
  使用 --scan 选项获取完整分析信息。

BUILD FAILED in 12s
Exception: Gradle task assembleDebug failed with exit code 1

解决方案 #

1. 检查调试Keystore路径权限 #

Flutter默认在用户目录下生成调试Keystore（路径：Windows为C:\Users\<你的用户名>\.android，macOS/Linux为~/.android），新电脑可能存在目录权限问题：

• 导航到上述.android文件夹，确保该文件夹及内部文件具备读写权限
• 若权限不足，修改文件夹权限设置

2. 手动生成调试Keystore #

若自动生成失败，手动创建调试Keystore：

• 打开终端/命令提示符，执行对应系统的命令：
  macOS/Linux：

  keytool -genkey -v -keystore ~/.android/debug.keystore -storepass android -alias androiddebugkey -keypass android -keyalg RSA -keysize 2048 -validity 10000
  

  Windows：

  keytool -genkey -v -keystore C:\Users\<你的用户名>\.android\debug.keystore -storepass android -alias androiddebugkey -keypass android -keyalg RSA -keysize 2048 -validity 10000
  

• 执行时按提示填写信息，可直接回车使用默认值

3. 清理并重新构建项目 #

• 在项目根目录执行清理命令：

  flutter clean
  

• 重新构建并运行AVD：

  flutter run
  

4. 验证Java SDK版本兼容性 #

确保安装的Java SDK版本与Flutter兼容（推荐Java 11或17）：

• 终端执行java -version查看当前版本
• 若版本不匹配，切换至兼容版本后重新构建

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