如何修复flutter doctor提示Android SDK文件不存在的问题

问题现状 #

执行flutter doctor环境检测结果如下，仅Android工具链存在异常，其余组件均正常：

[✓] Flutter (Channel stable, 2.5.3, on Microsoft Windows [Version 10.0.22000.318], locale en-US)
[!] Android toolchain - develop for Android devices (Android SDK version 33.0.0)
✗ Android SDK file not found: C:\Users\huawei d15\AppData\Local\Android\sdk\platforms\android-33\android.jar.
[✓] Chrome - develop for the web
[✓] Visual Studio - develop for Windows (Visual Studio Community 2022 17.1.3)
[✓] Android Studio (version 2021.1)
[✓] VS Code (version 1.68.1)
[✓] Connected device (3 available)
[✓] HTTP Host Availability

核心报错为指定路径下Android API 33版本对应的android.jar文件缺失。

修复步骤 #

按优先级依次尝试以下操作即可解决问题：

• 通过Android Studio可视化界面补装缺失组件
  1. 打开Android Studio，依次进入Settings > Appearance & Behavior > System Settings > Android SDK
  2. 在SDK Platforms标签页下勾选Android 13.0 (Tiramisu) / API Level 33，点击Apply等待自动下载安装完成
  3. 切换到SDK Tools标签页，确认33版本对应的Android SDK Build-Tools已同步安装，未安装的话勾选后同步安装
  4. 安装完成后重启终端，执行flutter doctor验证检测结果
• 通过命令行安装对应SDK组件
  1. 找到本地Android SDK目录下的cmdline-tools/latest/bin文件夹，将该路径添加到系统环境变量Path中
  2. 新开终端窗口执行命令：sdkmanager "platforms;android-33" "build-tools;33.0.0"，等待组件下载安装结束
  3. 执行flutter doctor --android-licenses，所有弹窗许可都输入y确认同意
  4. 重新执行flutter doctor确认异常消除
• 路径兼容问题排查（前两步操作后仍报错时使用）
  1. 手动打开报错提示的C:\Users\huawei d15\AppData\Local\Android\sdk\platforms\路径，检查是否存在android-33文件夹，以及文件夹内是否包含android.jar文件
  2. 如果文件夹存在但文件损坏/缺失，直接删除整个android-33文件夹，重新走前两个步骤的安装流程即可，不要从非官方渠道单独下载零散jar包补文件，容易出现版本兼容问题
  3. 由于当前SDK所在的用户路径包含空格（huawei d15），如果重装后依旧识别失败，可以把整个SDK目录移动到无空格、无中文的路径下，比如C:\Android\sdk，之后配置系统环境变量ANDROID_SDK_ROOT指向新路径，再执行flutter config --android-sdk "C:\Android\sdk"更新Flutter绑定的SDK路径即可。

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