MacBook上用Android模拟器运行Flutter项目遇UnknownHostException错误求助

• 检查网络连通性
  先在浏览器尝试访问services.gradle.org，如果无法打开，说明是网络层面的问题——切换到稳定的外网（比如手机热点），或者检查Mac的防火墙、安全软件是否拦截了该域名的请求。

• 替换Gradle镜像源（国内用户优先）
  国内访问官方Gradle服务常出现不稳定，修改项目Gradle配置换用国内镜像：

  1. 打开Flutter项目下的android/build.gradle文件
  2. 找到buildscript和allprojects中的repositories块，替换为阿里云镜像：

     buildscript {
         repositories {
             maven { url 'https://maven.aliyun.com/repository/google' }
             maven { url 'https://maven.aliyun.com/repository/jcenter' }
             maven { url 'http://maven.aliyun.com/nexus/content/groups/public' }
         }
     }
     
     allprojects {
         repositories {
             maven { url 'https://maven.aliyun.com/repository/google' }
             maven { url 'https://maven.aliyun.com/repository/jcenter' }
             maven { url 'http://maven.aliyun.com/nexus/content/groups/public' }
         }
     }
     

• 清理无效Gradle代理配置
  如果之前配置过代理但已失效，会导致域名解析失败：

  1. 打开用户目录下的.gradle/gradle.properties文件（路径：~/Users/你的用户名/.gradle/gradle.properties）
  2. 找到并注释/删除所有包含http.proxyHost、http.proxyPort的代理配置行，保存后重新运行项目。

• 清除Gradle缓存
  缓存损坏也可能引发异常，执行命令清除缓存：

  rm -rf ~/.gradle/caches
  

  之后重新执行flutter run启动项目。

• 更新Flutter与Android SDK环境
  确保环境依赖为最新版本，执行以下命令：

  flutter upgrade
  flutter doctor
  

  根据flutter doctor的提示修复缺失的依赖或配置问题。

内容的提问来源于stack exchange，提问作者Unudulmayan melodiyalar