在Android原生项目集成Flutter模块时遇构建配置错误求助

DevOps 小满

2026-7-26

解决Android原生项目集成Flutter模块时的仓库配置冲突问题

问题原因

Android Gradle 7.0及以上版本强制要求仓库配置统一放在settings.gradle（或settings.gradle.kts）中，而Flutter插件会自动在Flutter模块的build.gradle里添加maven仓库，这就违反了当前项目的配置规则，导致报错。

解决方案

1. 移除Flutter模块build.gradle中的仓库配置

找到你的Flutter模块下的android/build.gradle文件，删除里面类似下面的仓库配置代码：

repositories {
    maven {
        url 'https://storage.googleapis.com/download.flutter.io'
    }
}

2. 在项目根目录的settings.gradle中添加Flutter所需仓库

打开项目根目录的settings.gradle（如果是KTS则是settings.gradle.kts），在dependencyResolutionManagement块内的repositories中添加Flutter的maven仓库：

Groovy版本（settings.gradle）：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // 添加Flutter所需的maven仓库
        maven { url 'https://storage.googleapis.com/download.flutter.io' }
    }
}

Kotlin版本（settings.gradle.kts）：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // 添加Flutter所需的maven仓库
        maven(url = "https://storage.googleapis.com/download.flutter.io")
    }
}