Flutter真机调试问题：Android设备运行后显示空白屏

问题详情 #

在Flutter开发中，Android设备通过USB调试运行程序后显示空白屏，但Web端运行完全正常。控制台输出如下：

Launching lib\main.dart on I2011 in debug mode...
Running Gradle task 'assembleDebug'...
√  Built build\app\outputs\flutter-apk\app-debug.apk.
Installing build\app\outputs\flutter-apk\app-debug.apk...
I/flutter ( 3705): The Dart VM service is listening on
Launching lib\main.dart on I2011 in debug mode...
Running Gradle task 'assembleDebug'...
√  Built build\app\outputs\flutter-apk\app-debug.apk.
Installing build\app\outputs\flutter-apk\app-debug.apk...
I/flutter ( 3705): The Dart VM service is listening on

已尝试更换Flutter、Android Studio版本，问题仍未解决。

实用排查方案 #

• 确认设备权限：开启设备「USB调试」「允许安装未知应用」权限，连接电脑时选择「文件传输」模式，避免仅充电模式导致的权限不足。
• 清理项目缓存：执行以下命令清除缓存后重新编译

  flutter clean
  flutter pub get
  

• 检查MainActivity配置：确保Android项目的MainActivity继承自FlutterActivity，无自定义初始化逻辑阻塞Flutter启动。
• 查看设备报错日志：通过adb命令过滤Flutter相关日志，定位是否存在初始化阶段的报错

  adb logcat -s flutter
  

• 禁用硬件加速：在AndroidManifest.xml的application标签中添加android:hardwareAccelerated="false"，部分老旧设备存在渲染兼容性问题。
• 检查入口代码逻辑：确认main.dart中runApp执行流程正常，无异步操作阻塞或未捕获异常导致UI未渲染。

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