Flutter 构建 compileDebugJavaWithJavac 报错时的阿里云 Maven 镜像配置

如果你在国内做 Flutter 开发，遇到 compileDebugJavaWithJavac 任务突然失败，同时控制台又报出 debugCompileClasspath 依赖解析异常，基本可以先把排查重点放在仓库访问上。它通常不是代码本身写坏了，而是 Gradle 在拉取 Android 侧依赖时卡住了。

错误到底卡在哪

compileDebugJavaWithJavac 是 Android 构建链里比较靠后的 Java 编译任务。它挂掉，往往说明前面的依赖解析已经失败了。日志里常见的那句 Could not resolve all task dependencies for configuration ':app:debugCompileClasspath'，说白了就是：编译 Debug 包需要的类路径没凑齐。

这个 debugCompileClasspath 配置会把编译所需的依赖都列出来，来源一般有三种：

• 项目里的模块依赖，比如 project(':mylibrary')
• 本地的 JAR / AAR
• 远程 Maven 仓库里的第三方库，比如 google()、mavenCentral()，早些时候还有 jcenter()

Gradle 会按仓库顺序去找构件。只要仓库访问慢、地址不可达，或者目标版本根本没同步到仓库里，解析就会失败，后面的编译任务自然跟着停掉。

对国内开发者来说，最常见的问题还是网络。海外仓库访问不稳定，构建时超时、重试、断连都不罕见。错误看起来很大，其实根子经常很简单。

用阿里云 Maven 镜像替换默认仓库

最直接的处理方式，是把项目里默认的海外仓库前面加上国内镜像，让 Gradle 先走阿里云。它同步了常见的 Google、Central、JCenter 仓库，够应付大多数 Flutter Android 构建场景。

修改 android/build.gradle

打开 Flutter 项目的 android/build.gradle，把 buildscript 和 allprojects 里的 repositories 都补上阿里云镜像。实际操作里，我一般会把镜像放在前面，先让它命中；保留 google() 和 mavenCentral()，这样镜像没同步到的包还能回退到官方仓库。

buildscript {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/central' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/central' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        google()
        mavenCentral()
    }
}

这类配置的价值不在于'看起来更完整'，而在于它确实能减少国内网络环境下的构建抖动。很多时候，Flutter 侧代码没动，Android 构建却老出问题，改完仓库后就安静了。