Flutter从2.5.0升级到3.19.0时AAPT2链接异常致构建失败

问题描述 #

将Flutter应用从2.5.0版本升级到3.19.0版本后，持续出现构建失败错误：

Build Failed with Exception AAPT2 aapt2-7.0.0-7396180-osx Daemon #0: Unexpected error during link, attempting to stop daemon

已尝试过的无效方案：

• 更换多个Gradle版本
• 升级Kotlin版本
• 禁用AAPT2
• 延长AAPT2超时时间

1. 彻底清理构建缓存并重新构建 #

执行以下命令清除所有缓存文件后重新构建：

flutter clean
rm -rf android/.gradle android/build ios/Pods ios/Podfile.lock
flutter pub get
cd ios && pod install && cd ..
flutter build apk --debug

2. 排查资源文件问题 #

AAPT2链接错误多数源于资源文件异常，重点检查：

• 所有XML资源文件（layout、drawable、values目录下）的语法，确保标签闭合、属性拼写正确
• drawable目录下的图片文件名无空格、中文等特殊字符，统一用小写字母+下划线命名
• values目录下的样式、颜色、字符串等资源是否存在重复定义或无效引用

3. 同步Android构建工具版本 #

在android/build.gradle文件中，将构建工具及SDK版本调整为与Flutter 3.19.0兼容的版本：

buildscript {
    ext {
        buildToolsVersion = "34.0.0"
        compileSdkVersion = 34
        targetSdkVersion = 34
    }
    // 其余配置保持不变
}

4. 升级Flutter插件到兼容版本 #

部分旧插件可能不兼容新版Flutter，执行命令检查并升级所有插件：

flutter pub outdated

根据输出将插件逐一升级到最新稳定版，尤其注意涉及资源处理的插件（如flutter_svg、image_picker等）

5. 指定AAPT2版本尝试切换 #

在android/gradle.properties中手动指定AAPT2版本，尝试降级或升级：

android.aapt2Version=7.4.0-7445603

6. 更新Android Studio配置 #

• 将Android Studio升级到最新稳定版（2023.1.1及以上）
• 执行File > Invalidate Caches...，勾选"Clear file system cache and local history"后重启IDE

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