You need to enable JavaScript to run this app. 执行flutter doctor提示Android SDK 29.0.3版本aapt缺失如何解决
优惠活动
大模型
产品
解决方案
定价
更多

执行flutter doctor提示Android SDK 29.0.3版本aapt缺失如何解决

Flutter Android工具链检测报错:缺失aapt文件

检测输出还原(译自原英文结果)

Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel stable, 2.0.3, on Microsoft Windows [Version 10.0.19041.208], locale en-US)
[!] Android toolchain - develop for Android devices (Android SDK version 29.0.3)
X Android SDK file not found: C:\Users\AppData\Local\Android\Sdk\build-tools\29.0.3\aapt.
[√] Chrome - develop for the web
[√] Android Studio (version 4.1.0)
[√] VS Code (version 1.54.3)
[√] Connected device (1 available)
! Doctor found issues in 1 category.

对应中文说明:除Android工具链外其余环境项均正常,仅提示指定路径下缺失aapt(Android打包必需的资源编译工具)文件。

根因说明

该报错一般由两类问题导致:

  • Flutter配置的Android SDK路径错误,缺失用户名层级,指向了不存在的目录
  • 本地安装的build-tools 29.0.3包损坏、安装不完整,或是被安全软件误删了aapt可执行文件

分步解决操作

  • 第一步:校验Android SDK实际路径
    打开Android Studio,进入Settings > Appearance & Behavior > System Settings > Android SDK,记录页面显示的「Android SDK Location」完整路径(正常应为C:\Users\你的用户名\AppData\Local\Android\Sdk),如果和报错里的路径比对后发现缺失用户名段,直接在终端执行命令修正Flutter配置:
    flutter config --android-sdk <上面记录的实际SDK完整路径>
  • 第二步:修复build-tools安装包
    还是在刚才的Android SDK设置页,切换到「SDK Tools」标签,勾选右下角的「Show Package Details」,展开列表里的「Android SDK Build-Tools」:
    • 找到当前识别到的29.0.3版本,先取消勾选,点击Apply卸载
    • 重新勾选29.0.3版本,点击Apply重新下载安装该包
  • 第三步:复检环境
    关闭所有终端窗口,重新打开执行flutter doctor,确认异常项消失。如果仍报错,直接手动打开SDK目录下的build-tools\29.0.3文件夹,确认是否存在aapt.exe文件;若不存在,可选择更换安装其他版本的build-tools(比如29.0.3的补丁迭代版、或30.0.0稳定版),安装后重新配置对应版本即可。

内容的提问来源于stack exchange,提问作者muhammed alsmawi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 10:06:04