添加Flutter本地通知后Android/build.gradle配置致应用无法启动

1. 确认Gradle版本与构建工具的兼容性 #

com.android.tools.build:gradle和Gradle wrapper版本必须严格匹配，不能随意替换。比如7.3.1版本的构建工具对应的Gradle版本范围是7.4~7.6.x，你用7.6.3是符合要求的，但要检查android/build.gradle里的其他依赖是否冲突：

buildscript {
    ext.kotlin_version = '1.7.10' // Kotlin版本必须与构建工具兼容，7.3.1建议用1.6.21~1.7.x区间版本
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.3.1'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
        // 若本地通知插件依赖其他classpath（如Firebase相关），需确保版本匹配
    }
}

2. 清理构建缓存并重新同步 #

缓存冲突是常见诱因，执行以下步骤彻底清理：

• 终端运行：

  flutter clean
  flutter pub get
  

• 删除android/.gradle和android/build目录
• 在Android Studio中执行File -> Sync Project with Gradle Files后重新构建

3. 检查本地通知插件的版本兼容性 #

你使用的本地通知插件（如flutter_local_notifications）可能与当前Gradle构建工具版本不兼容：

• 查看插件的官方文档，确认其支持的Gradle构建工具版本范围
• 尝试降级/升级插件版本，比如将插件锁定到与7.3.1构建工具匹配的稳定版本

4. 定位具体错误日志 #

不要只看“启动失败”的表面现象，必须查看详细错误信息：

• 运行flutter run -v获取完整构建日志
• 在Android Studio的Logcat中查看崩溃堆栈信息
  常见问题包括：Kotlin版本不匹配、Android SDK版本（compileSdk/targetSdk）与构建工具不兼容、Manifest配置错误等

5. 校验gradle-wrapper.properties配置 #

确保gradle/wrapper/gradle-wrapper.properties中的distributionUrl正确指向对应版本：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.3-all.zip

检查文件是否存在拼写错误或格式问题

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