在macOS上安装Flutter时，不少开发者会遇到检查maven.google.com时提示网络错误的问题，导致安装流程卡住无法继续。这个问题大多和国内网络访问谷歌服务受限有关，也可能是配置不当导致的，下面我们一步步排查解决。
问题成因分析
出现这个错误的核心原因是Flutter默认会访问谷歌的Maven仓库maven.google.com来获取Android相关的依赖，而该地址在国内网络环境下通常无法直接访问，就会触发网络错误提示。另外如果本地已经安装了Android SDK但镜像配置不正确，或者Flutter的环境变量、代理设置有问题，也可能出现同类报错。
解决方法
方法一：替换Flutter国内镜像源
Flutter官方提供了国内镜像源，我们可以修改环境变量让Flutter优先使用国内镜像，避免直接访问谷歌服务。首先打开终端，编辑shell配置文件，如果你用的是zsh就编辑~/.zshrc，用bash就编辑~/.bashrc：
# 打开配置文件，以zsh为例 open -e ~/.zshrc
在文件末尾添加以下内容，设置Flutter和Dart的国内镜像：
export PUB_HOSTED_URL=https://pub.flutter-io.cn export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
保存后执行以下命令让配置生效：
source ~/.zshrc
之后重新运行Flutter安装检查命令，看是否还会报错。
方法二：配置Android SDK国内镜像
如果已经安装了Android SDK，需要把SDK的仓库地址替换为国内镜像，避免访问maven.google.com。首先找到Android SDK的安装目录，默认路径通常是~/Library/Android/sdk，然后进入~/.android目录，编辑repositories.cfg文件，如果没有就新建一个：
# 进入.android目录 cd ~/.android # 新建或编辑repositories.cfg open -e repositories.cfg
在文件中添加以下内容，指定国内镜像仓库：
# 阿里云Android镜像 maven.aliyun.com/repository/google maven.aliyun.com/repository/public
同时打开Android Studio，进入Preferences -> Android SDK -> SDK Update Sites，把默认的谷歌仓库地址替换为对应的阿里云镜像地址，保存后重启Android Studio。
方法三：检查网络代理设置
如果你的网络需要代理才能访问外部服务，需要确保终端和Flutter都能正确使用代理。可以在终端中临时设置代理：
# 替换为你的代理地址和端口 export http_proxy=http://127.0.0.1:7890 export https_proxy=http://127.0.0.1:7890
设置后重新运行Flutter的检查命令，确认代理是否生效。如果代理正常但还是报错，可以尝试关闭代理后使用国内镜像源的方式解决。
验证解决效果
完成上述配置后，在终端运行Flutter的环境检查命令：
flutter doctor
如果不再出现maven.google.com相关的网络错误提示，且其他检查项都正常，就说明问题已经解决，可以继续完成Flutter的后续安装配置步骤了。
FluttermacOSmaven.google.com网络错误Android SDK修改时间：2026-05-31 06:11:18