Ошибка Gradle Sync Failed в Android Studio: как исправить

Что означает ошибка Gradle Sync Failed

Ошибка Gradle Sync Failed возникает, когда Android Studio не может завершить процесс синхронизации проекта с Gradle. В логах вы увидите сообщение вида: Gradle sync failed: Could not resolve all files for configuration... или Failed to resolve: com.android.tools.build:gradle. Эта ошибка блокирует сборку проекта, так как Gradle не загружает необходимые зависимости из репозиториев (например, Maven Central, Google Maven). Синхронизация запускается автоматически при открытии проекта, изменении build.gradle или вручную через кнопку Sync Now.

Причины возникновения

Ошибка Gradle Sync Failed обычно вызвана одной из следующих конкретных причин:

1. Отсутствие или нестабильное интернет-соединение — Gradle не может скачать зависимости из удалённых репозиториев.
2. Неправильные настройки прокси — если вы находитесь за корпоративным прокси, Android Studio или система могут использовать неверные параметры.
3. Конфликт версий — несовместимость версий Gradle, Android Gradle Plugin (AGP) или установленных библиотек.
4. Повреждение локального кэша Gradle — кэш в папке ~/.gradle/caches содержит битые или неполные файлы.
5. Блокировка антивирусом или фаерволом — безопасное ПО может запрещать доступ к репозиториям Gradle (например, repo.maven.apache.org).
6. Устаревшие или некорректные URL репозиториев — в файлах build.gradle указаны недоступные или изменённые адреса.

Способы решения

Способ 1: Проверка интернет-соединения и настройки прокси

Убедитесь, что ваш компьютер имеет доступ в интернет и может достигать репозиториев Gradle.

1. Откройте браузер и перейдите на https://gradle.org — если страница не загружается, проблема с сетью.
2. Если вы используете прокси, проверьте настройки:
   • В Android Studio: File → Settings → Appearance & Behavior → System Settings → HTTP Proxy.
   • Выберите Auto-detect proxy settings или вручную укажите адрес и порт прокси.
   • Нажмите Check connection и введите https://repo.maven.apache.org — должно вернуть 200 OK.
3. Если прокси не требуется, установите No proxy.
4. Перезапустите Android Studio и попробуйте синхронизировать проект (кнопка Sync Now в панели инструментов).

Способ 2: Очистка кэша Gradle и перезапуск

Повреждённый кэш Gradle — частая причина ошибки. Инвалидация кэша решает проблему в большинстве случаев.

1. В Android Studio перейдите в File → Invalidate Caches and Restart....
2. В диалоговом окне выберите Invalidate and Restart.
3. После перезапуска Android Studio автоматически начнётся синхронизация. Если она не стартует, нажмите Sync Now.
4. Если ошибка persists, удалите кэш вручную:
   • Закройте Android Studio.
   • Удалите папку кэша Gradle:
     • Windows: C:\Users\<Ваше_Имя>\.gradle\caches
     • macOS/Linux: ~/.gradle/caches
   • Перезапустите Android Studio и дождитесь повторной загрузки зависимостей (может занять несколько минут).

Способ 3: Отключение режима офлайн

Режим офлайн (Offline work) заставляет Gradle использовать только локальные файлы, что приводит к ошибке, если зависимости отсутствуют.

1. Откройте настройки Gradle: File → Settings → Build, Execution, Deployment → Gradle (на macOS: Android Studio → Preferences → Build, Execution, Deployment → Gradle).
2. В разделе Gradle settings найдите опцию Offline work.
3. Снимите галочку, если она установлена.
4. Нажмите Apply и OK.
5. Запустите синхронизацию повторно.

Способ 4: Обновление Gradle и Android Gradle Plugin

Несовместимость версий вызывает сбои. Убедитесь, что используете актуальные версии.

1. Откройте файл build.gradle на уровне проекта (не модуля).
2. Найдите раздел dependencies и обновите классpath AGP:

   dependencies {
       classpath 'com.android.tools.build:gradle:8.2.0' // используйте последнюю стабильную версию
   }
   

3. Откройте файл gradle/wrapper/gradle-wrapper.properties и обновите распределение Gradle:

   distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip
   

   Актуальные версии смотрите на официальном сайте Android Developer.
4. После изменений нажмите Sync Now.
5. Если Android Studio предлагает миграцию, следуйте подсказкам.

Способ 5: Настройка исключений в антивирусе и фаерволе

Антивирусное ПО может блокировать доступ Gradle к репозиториям.

1. Временно отключите антивирус и фаервол (например, Windows Defender, Avast, Kaspersky).
2. Попробуйте синхронизировать проект — если ошибка исчезла, проблема в блокировке.
3. Добавьте исключения:
   • Для папки Gradle: C:\Users\<Ваше_Имя>\.gradle (Windows) или ~/.gradle (macOS/Linux).
   • Для процессов: java.exe, javaw.exe (Android Studio использует Java).
   • Для URL-адресов: https://repo.maven.apache.org, https://dl.google.com.
4. Перезапустите антивирус и Android Studio.

Способ 6: Переустановка Android Studio (крайний случай)

Если все предыдущие способы не помогли, возможно, повреждена установка Android Studio.

1. Создайте резервную копию важных проектов и настроек (файлы .idea, gradle в папке проекта).
2. Удалите Android Studio:
   • Windows: через Панель управления → Программы и компоненты.
   • macOS: перетащите приложение в Корзину и удалите папки ~/Library/Application Support/Google/AndroidStudio* и ~/.android.
   • Linux: удалите папку установки и ~/.AndroidStudio*.
3. Скачайте последнюю версию с официального сайта и установите заново.
4. При первом запуске укажите пути к SDK и настройте прокси при необходимости.
5. Откройте проект и дождитесь завершения синхронизации.

Профилактика

Чтобы избежать повторения ошибки Gradle Sync Failed, следуйте этим рекомендациям:

• Поддерживайте стабильный интернет — используйте проводное соединение или надёжный Wi-Fi. Избегайте общественных сетей с ограничениями.
• Регулярно обновляйте инструменты — устанавливайте обновления Android Studio, Gradle и AGP через Help → Check for Updates.
• Правильно настраивайте прокси — если работаете в корпоративной сети, уточните у IT-отдела параметры прокси и добавьте исключения для репозиториев Gradle.
• Не отключайте режим офлайн без необходимости — включайте его только для сборки без интернета, после возвращайтесь в онлайн-режим.
• Добавляйте исключения в антивирус — как минимум для папки ~/.gradle и процессов Java.
• Используйте фиксированные версии — в build.gradle указывайте конкретные версии библиотек, а не + (например, implementation 'com.squareup.retrofit2:retrofit:2.9.0' вместо 2.9.+), чтобы избежать неожиданных обновлений.