VSCode运行Flutter应用遇Gradle构建失败：启用并回退Flutter Web后异常

Hey there, sorry to hear you're hitting this Gradle roadblock after enabling and rolling back Flutter Web support! This kind of issue usually stems from leftover cache or misconfigured settings from the Web toggle. Let's work through some actionable fixes:

1. Wipe Build Caches (First Step!) #

Stale caches are the most common culprit here. Let's clear both Flutter and Gradle caches:

• Run this in your terminal to clean Flutter's build artifacts:

  flutter clean
  

• Navigate to your project's android directory and delete the .gradle folder entirely (this holds project-specific Gradle cache).
• Clear your global Gradle cache too:
  • On Windows: Delete everything in C:\Users\<YourUsername>\.gradle\caches
  • On Mac/Linux: Delete everything in ~/.gradle/caches
• Finally, re-fetch dependencies with:

  flutter pub get
  

2. Ensure Flutter Web Support is Fully Disabled #

Sometimes the web toggle doesn't fully reset on its own. Let's enforce it:

• Run this command to disable Web support globally:

  flutter config --no-enable-web
  

• Run flutter doctor to verify your environment is healthy. Look for any red flags related to Android SDK or Gradle setup.

3. Reset Gradle Configuration Files #

The Web toggle might have modified default Gradle settings. Let's reset them for new projects:

• When creating a new project, open android/gradle/wrapper/gradle-wrapper.properties and set a stable Gradle distribution URL (match this to your Flutter version—Flutter 3.x works well with Gradle 7.x/8.x):

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

• Check android/build.gradle and ensure the Android Gradle Plugin version matches your Gradle version. For Gradle 7.5, use:

  classpath 'com.android.tools.build:gradle:7.4.2'
  

4. Verify Android SDK & Environment Setup #

Misconfigured Android SDK can cause Gradle to fail silently:

• Double-check that your ANDROID_HOME environment variable points to the correct Android SDK directory.
• Use Android Studio's SDK Manager (or VS Code's Flutter Doctor extension) to confirm you have the latest Build Tools and Platform Tools installed.
• Ensure your target Android SDK version in android/app/build.gradle matches what's installed in your SDK.

5. Create Projects with Explicit Platforms #

To avoid any accidental Web configuration leakage when creating new projects, specify only the platforms you need:

flutter create --platforms android,ios my_new_project

If none of these steps work, try updating Flutter to the latest stable release with flutter upgrade—sometimes older versions have bugs related to Web mode toggling.

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