Android Studio新建SettingsActivity模板项目时Gradle同步失败如何解决？

• 排查端口占用与网络拦截

  • 暂停本地防火墙、杀毒软件等安全工具，测试是否能正常同步
  • 用命令检查Gradle相关端口占用：Windows执行netstat -ano | findstr "8080"（Gradle常用端口之一），Mac/Linux执行lsof -i :8080，找到占用进程后结束它

• 调整Gradle网络参数

  • 打开项目根目录的gradle.properties文件，添加以下配置强制使用IPv4：

    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true -Djava.net.preferIPv6Addresses=false
    

  • 进入Android Studio设置（File > Settings），在Build, Execution, Deployment > Build Tools > Gradle中，切换Gradle JVM为本地安装的JDK版本，避免内嵌JDK的网络配置问题

• 清理缓存重置状态

  • 关闭Android Studio，删除项目根目录下的.gradle文件夹，以及Android Studio的缓存目录（Windows路径：C:\Users\<你的用户名>\.AndroidStudio<版本号>\system\caches；Mac路径：~/Library/Caches/Google/AndroidStudio<版本号>）
  • 重启Android Studio后重新执行Gradle Sync

• 更换Gradle版本

  • 打开项目级build.gradle文件，修改Gradle插件版本，例如将classpath "com.android.tools.build:gradle:7.4.2"替换为7.3.1这类稳定版本，同步后验证是否解决问题

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