修改Gradle脚本后因Kotlin插件版本冲突导致Flutter构建失败
修改Gradle脚本后因Kotlin插件版本冲突导致Flutter构建失败
兄弟,我太懂你这种被Gradle版本冲突搞到心态爆炸的感觉了!我之前手动改了Gradle配置后也遇到过一模一样的报错,跟你唠唠为啥会这样,以及怎么解决:
首先说根源:Flutter的工具链本身有一套自动依赖版本管理逻辑,它会根据你当前使用的Flutter SDK版本,自动匹配兼容的Kotlin插件、Gradle Plugin、Gradle Wrapper这些底层依赖版本。比如你用的这个Flutter版本,默认已经内置了Kotlin插件2.1.0来保证构建稳定性,但你手动在build.gradle.kts里指定了1.9.23版本的org.jetbrains.kotlin.android插件,这就导致Gradle在解析类路径时发现了两个不同版本的同一个插件,直接懵了——它不知道该用哪个,所以就抛出了冲突报错。
给你几个亲测有效的解决步骤:
- 恢复Gradle文件到默认状态:找到你手动修改的
settings.gradle或者项目级build.gradle.kts,把你加的Kotlin插件版本配置(就是那句id: 'org.jetbrains.kotlin.android', version: '1.9.23', apply: false)删掉,让Flutter自己去管理这个版本,别手动干预。 - 彻底清理缓存:先执行
flutter clean清理项目构建缓存,然后删掉项目根目录下的.gradle文件夹,以及android目录下的.gradle文件夹——这些缓存有时候会残留旧版本依赖,导致冲突反复出现。 - 重新同步依赖:在终端执行
flutter pub get拉取项目依赖,然后再运行flutter run或者你需要的构建命令,让Flutter工具链重新生成并同步正确的依赖版本。 - 别碰Gradle Wrapper版本:如果你还手动改了
gradle/wrapper/gradle-wrapper.properties里的Gradle版本,也赶紧改回去——Flutter会根据SDK版本自动对应合适的Gradle版本,手动改大概率会踩兼容性坑。
总结一句:Flutter的跨平台构建稳定性全靠这套内置的依赖版本映射,除非你对每个版本的兼容性有十足把握,否则千万别随便手动修改Gradle里的底层依赖版本,不然很容易就像这样踩版本冲突的坑。
内容来源于stack exchange
相关产品推荐
相关产品推荐

