Limited Time Offer!
For Less Than the Cost of a Starbucks Coffee, Access All DevOpsSchool Videos on YouTube Unlimitedly.
Master DevOps, SRE, DevSecOps Skills!
1. Understanding the Root Cause
Your build failed with errors like:
- Could not read workspace metadata from metadata.bin
- Error resolving plugin id: dev.flutter.flutter-plugin-loader
- A problem occurred configuring project :gradle
- Multiple build operations failed
These errors have a single underlying cause:
Gradle 8.12 cache corruption.
Flutter works best with Gradle versions between 8.3 and 8.5.
Gradle 8.12 introduces a number of changes that break compatibility with the Flutter plugin loader, especially when using:
- Kotlin DSL (.kts files)
- Android plugin versions bundled with Flutter
- Flutter plugin build transforms
- Cached transform metadata stored in metadata.bin
When the metadata cache becomes corrupted, Gradle will repeatedly fail, even if you clean your Flutter project, because the problem exists outside your Flutter directory in:
C:\Users\<username>\.gradle\
This is why deleting only .gradle/caches was not enough.
To fix the issue permanently, you must reset the entire Gradle environment and make sure Flutter uses a stable Gradle version.
2. Symptoms That Confirm Gradle Cache Corruption
The following signs match exactly what you experienced:
- Every build fails at
settings.gradle.ktsat the same line - Errors mention
transforms/.../metadata.bin - Errors repeat even after running
flutter clean - Multiple metadata.bin files cannot be read
- Gradle plugin loader fails with the message:
Error resolving plugin dev.flutter.flutter-plugin-loader
These symptoms always mean that:
- The Gradle cache stored on the machine is broken
- Flutter is trying to use the wrong Gradle version
- Kotlin DSL accessors cannot be regenerated
3. The Correct Fix: Reset, Downgrade, Rebuild
Below is the complete step-by-step solution that you should follow exactly in this order.
This sequence resolves the issue in all cases.
4. Step 1 โ Close Everything
Before fixing anything, you must close:
- Android Studio
- VS Code
- Terminal windows
- Any running Gradle daemon
Leaving these open prevents deleting Gradle files.
5. Step 2 โ Delete the Entire Global Gradle Folder
This is the most important step.
Run this command in PowerShell:
rd /s /q "C:\Users\ashwa\.gradle"
This removes:
- Caches
- Transforms
- Kotlin DSL accessors
- Corrupted metadata.bin files
- Old plugin loader versions
- Old Gradle versions
This forces Gradle to rebuild everything from scratch.
6. Step 3 โ Delete Gradle Inside the Android Project
Every Flutter Android module has its own .gradle folder.
Delete it:
rd /s /q "C:\Flutter app\MyHospitalNow\android\.gradle"
This avoids Flutter reusing corrupt metadata.
7. Step 4 โ Reset the Flutter Project
Run:
flutter clean
flutter pub get
This clears:
- Build artifacts
- Cached Dart code
- Outdated plugin snapshots
8. Step 5 โ Downgrade Gradle Wrapper to a Stable Version
Flutter is not compatible with Gradle 8.12.
To downgrade:
cd "C:\Flutter app\MyHospitalNow\android"
gradlew wrapper --gradle-version 8.5
Gradle 8.5 is the most reliable for Flutter at the moment.
If needed, you may also use Gradle 8.3.
9. Step 6 โ Fix settings.gradle.kts
Your build failure pointed to line 20 in this file.
The simplest, stable version of this file is shown below.
Replace the entire content with:
pluginManagement {
includeBuild("gradle")
repositories {
google()
mavenCentral()
gradlePluginPortal()
}
}
plugins {
id("dev.flutter.flutter-plugin-loader") version "1.0.0"
}
include(":app")
Make sure the file has:
- No extra plugin lines
- No experimental gradle features
- No mismatched indents
- No commented invalid lines
A clean file regenerates Kotlin accessors properly.
10. Step 7 โ Run Flutter Build Again
Now run:
flutter run
At this point, Gradle will:
- Download a fresh clean Gradle 8.5 distribution
- Rebuild Kotlin DSL accessors
- Recreate all transform caches
- Re-register Flutter plugin loader
The build should now succeed.
11. If the Error Still Occurs
In rare cases, Flutter forces Gradle to use an incompatible version.
Then edit this file:
android/gradle/wrapper/gradle-wrapper.properties
Replace this line:
distributionUrl=https\://services.gradle.org/distributions/gradle-8.3-all.zip
Save and rebuild.
This forces a known working Gradle version.
12. Why These Steps Work
This sequence permanently fixes the issue because:
- Deleting the entire Gradle directory removes the corrupted metadata.bin files
- Removing
.gradleinside the project resets local build data - Flutter clean removes cached build artifacts
- Downgrading to Gradle 8.5 fixes Flutter compatibility
- Rewriting settings.gradle.kts fixes Kotlin DSL loading
- New Gradle wrapper regenerates plugin loaders cleanly
This resolves every root cause of the error.
13. How to Prevent This Issue in the Future
Here are the recommended practices:
- Do not let Flutter automatically use the newest Gradle versions
- Avoid manually editing Gradle Kotlin DSL files
- Do not interrupt Gradle downloads or builds
- Use Android Studio’s built-in Gradle tools instead of external scripts
- Always run
flutter cleanafter adding or removing plugins - Keep Gradle versions between 8.3 and 8.5 for Flutter
- Delete Gradle cache folders if you ever see metadata.bin errors
Following these steps avoids 99 percent of Gradle-related failures.

Leave a Reply