Что означает сообщение об ошибке во Flutter и как его исправить?

How can I fix the error "Gradle task assembleDebug failed with exit code 1"?
  • 4 июня 2026 г. 20:01
Ответы на вопрос 2
Коротко — сообщение "Gradle task assembleDebug failed with exit code 1" просто означает, что сборка Android-проекта через Gradle упала с ошибкой. Это обобщённое сообщение; причина может быть любой — от простой опечатки в build.gradle до несоответствия версий Gradle/плагина/Java или отсутствия нужного файла (например google‑services.json). Чтобы исправить, нужно посмотреть подробный лог и затем устранить конкретную причину.

Ниже — пошаговая инструкция и типовые исправления.

1) Получите подробный лог (покажет реальную причину)
- В корне Flutter-проекта запустите:
  flutter run -v
  или для Android-подкаталога:
  cd android
  ./gradlew assembleDebug --stacktrace --info
Посмотрите первую конкретную ошибку (обычно несколько строк выше строки с exit code 1).

2) Быстрые общие шаги (часто помогают)
- flutter clean
- flutter pub get
- в android/ выполнить:
  ./gradlew clean
- удалить папки .gradle и build в android/ (или очистить кэш Android Studio)
- перезапустить Android Studio/IDE

3) Частые причины и решения
- Неполные/неподключённые репозитории
  Откройте android/build.gradle и android/settings.gradle — убедитесь, что в repositories есть google() и mavenCentral():
  repositories { google(); mavenCentral() }
- Несовместимые версии Gradle и Android Gradle Plugin
  Проверьте android/build.gradle (classpath 'com.android.tools.build:gradle:...') и android/gradle/wrapper/gradle-wrapper.properties (distributionUrl=...). Подберите совместимые версии (см. документацию плагина).
- Неподходящая версия JDK
  Для современных плагинов нужен JDK 11. Проверьте java -version и установите JAVA_HOME на JDK 11, если требуется.
- Отсутствует google-services.json (для Firebase)
  Если вы используете Firebase, положите google-services.json в android/app/.
- Проблемы с AndroidX / зависимостями
  Если миграции не было — выполните миграцию на AndroidX или включите jetifier. В android/gradle.properties:
  android.useAndroidX=true
  android.enableJetifier=true
- Недостаточно памяти Gradle
  В android/gradle.properties увеличьте:
  org.gradle.jvmargs=-Xmx2048M
- MultiDex / minSdk
  Если зависимости требуют multidex и minSdk < 21, добавьте поддержу multidex в build.gradle и в Application включите MultiDexApplication.
- Непринятые лицензионные соглашения SDK
  Выполните:
  sdkmanager --licenses
- Отсутствие интернета при загрузке зависимостей
  Убедитесь, что сеть доступна и репозитории reachable.

4) Конкретные типичные ошибок (и что с ними делать)
- "Could not resolve all files for configuration ':classpath'": добавить google() / mavenCentral() и проверить интернет.
- "Execution failed for task ':app:compileDebugKotlin'": проверьте версию kotlin и classpath в build.gradle, возможно обновите kotlin_version.
- "A problem occurred evaluating project ':app'": откройте build.gradle — синтаксическая ошибка или неправильный плагин.
- "Manifest merger failed": посмотрите конфликтующие атрибуты в манифестах зависимостей.

5) Если не получается — что прислать для помощи
Скопируйте несколько строк ПОСЛЕ запуска сборки, где видна первая конкретная ошибка (обычно 5–20 строк над "Gradle task assembleDebug failed..."). Лучше всего — вывод команды:
cd android
./gradlew assembleDebug --stacktrace --info
и приложите соответствующую ошибку.

Если хотите, пришлите сюда вывод ошибки (или несколько верхних строк из flutter run -v), и я помогу конкретно.
exit code 1 — это итоговая строка, реальная причина написана выше в том же логе (ищи FAILURE: Build failed with an exception и Caused by:). <br/> <br/> Запусти с подробностями: <code>cd android &amp;&amp; ./gradlew assembleDebug --stacktrace</code> <br/> <br/> Стандартный ритуал перед этим: <code>flutter clean &amp;&amp; flutter pub get</code> . Часто причина в JDK, Android Gradle Plugin или несовместимых зависимостях.
Похожие вопросы