Ubuntu 20.04系统下VS Code Flutter调试报错如何解决？

根本原因定位 #

从报错日志可确认，构建失败的核心原因是Gradle无法访问Google存储资源下载Flutter相关依赖包，与Android许可未生效、Chrome缺失的告警无直接关联。 #

解决步骤 #

1. 网络连通性排查与优化 #

• 先在终端执行以下命令测试目标资源连通性：

  curl -v https://storage.googleapis.com/download.flutter.io/io/flutter/x86_debug/1.0.0-0fdb562ac8068ce3dda6b69aca3f355f4d1d2718/x86_debug-1.0.0-0fdb562ac8068ce3dda6b69aca3f355f4d1d2718.jar
  

  若返回连接失败、超时，说明当前网络无法访问Google相关资源，需进行镜像配置。
• 配置Flutter国内镜像：
  编辑当前用户的shell配置文件（~/.bashrc/~/.zshrc，根据你使用的shell选择），添加以下环境变量：

  export PUB_HOSTED_URL=https://pub.flutter-io.cn
  export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
  

  保存后执行source ~/.bashrc（对应你修改的配置文件）使环境变量生效。
• 配置Gradle国内镜像：
  打开Flutter项目下的android/build.gradle文件，替换两处repositories配置块（buildscript和allprojects下的）内容为：

  repositories {
      maven { url 'https://maven.aliyun.com/repository/google' }
      maven { url 'https://maven.aliyun.com/repository/jcenter' }
      maven { url 'https://maven.aliyun.com/repository/public' }
  }
  

  再打开android/settings.gradle文件，同样替换其中的插件仓库地址为上述镜像地址。
• 若你本地使用代理，检查~/.gradle/gradle.properties文件中的代理配置是否正确，不需要代理的话直接删除相关配置即可。

2. 验证配置 #

• 在项目根目录依次执行以下命令：

  flutter clean
  flutter pub get
  

• 重新启动调试，确认依赖下载是否正常。

3. 处理flutter doctor剩余告警（可选，不影响Android端调试） #

• 若执行flutter doctor --android-licenses后仍提示许可状态未知：打开Android Studio的SDK Manager，在SDK Tools标签页安装最新版Android SDK Command-line Tools，再重新执行flutter doctor --android-licenses并全部确认许可即可。
• Chrome缺失告警不影响Android端开发，仅开发Web端时需要安装Chrome浏览器解决。

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