Troubleshooting
Flutter Troubleshooting
Find solutions to common Flutter, Dart, Firebase, Android, and iOS problems.
Browse by Category
Flutter
Widget errors, layout overflows, lifecycle and async-state problems.
2 solutions
Android
Gradle, Android Manifest, SDK, and Kotlin/Java build problems.
1 solution
iOS
CocoaPods, Xcode, signing, and provisioning problems.
1 solution
Firebase
Auth, Firestore, Cloud Messaging, and configuration errors.
1 solution
Dart
Null safety, type errors, and async/await problems.
0 solutions
Networking
HTTP errors, timeouts, SSL, and JSON parsing problems.
0 solutions
Build & Release
Release-only failures, R8/ProGuard, and signing problems.
1 solution
Performance
Slow apps, jank, excessive rebuilds, and memory problems.
0 solutions
Popular Flutter Problems
Running `flutter build apk`, `flutter build appbundle`, or launching on an Android device fails during the Gradle build phase, often with a message like `Execution failed for task ':app:...'` or `Build failed with an exception.`
Flutter Gradle Build Failed: Common Causes and Fixes
Push notifications sent via Firebase Cloud Messaging (FCM) aren't being received on an Android or iOS device running a Flutter app, even though the send appears to succeed from the Firebase Console or backend.
Firebase Messaging Not Working in Flutter
The app runs correctly with flutter run (debug mode) but crashes, behaves incorrectly, or fails to build entirely in release mode (flutter build apk --release, flutter build ipa, or flutter run --release).
Flutter App Works in Debug but Fails in Release
Running flutter build ios, flutter run on an iOS device/simulator, or pod install inside the ios/ directory fails with a CocoaPods dependency error.
Flutter CocoaPods Error: Common Causes and Fixes
An asynchronous operation (a network call, a Future, a Timer, a stream callback) completes and calls setState() after the widget that started it has already been removed from the widget tree.
Flutter setState Called After Dispose: How to Fix It
A Row, Column, or other Flex-based widget renders content that doesn't fit within the space available to it, and Flutter shows a yellow-and-black striped overflow warning in debug mode.
Flutter RenderFlex Overflowed by Pixels: How to Fix It
Latest Troubleshooting Guides
Running `flutter build apk`, `flutter build appbundle`, or launching on an Android device fails during the Gradle build phase, often with a message like `Execution failed for task ':app:...'` or `Build failed with an exception.`
Flutter Gradle Build Failed: Common Causes and Fixes
Push notifications sent via Firebase Cloud Messaging (FCM) aren't being received on an Android or iOS device running a Flutter app, even though the send appears to succeed from the Firebase Console or backend.
Firebase Messaging Not Working in Flutter
The app runs correctly with flutter run (debug mode) but crashes, behaves incorrectly, or fails to build entirely in release mode (flutter build apk --release, flutter build ipa, or flutter run --release).
Flutter App Works in Debug but Fails in Release
Running flutter build ios, flutter run on an iOS device/simulator, or pod install inside the ios/ directory fails with a CocoaPods dependency error.
Flutter CocoaPods Error: Common Causes and Fixes
An asynchronous operation (a network call, a Future, a Timer, a stream callback) completes and calls setState() after the widget that started it has already been removed from the widget tree.
Flutter setState Called After Dispose: How to Fix It
A Row, Column, or other Flex-based widget renders content that doesn't fit within the space available to it, and Flutter shows a yellow-and-black striped overflow warning in debug mode.