Flutter项目在Android模拟器启动卡住无响应问题求助

1. 排查环境配置问题 #

• 运行flutter doctor，检查是否有Android SDK组件缺失、licenses未同意等问题，严格按照提示修复所有报错项。
• 确认ANDROID_HOME环境变量指向正确的Android SDK路径，避免配置错误。

2. 清理项目缓存 #

• 依次执行以下命令清空构建缓存：

  flutter clean
  cd android
  ./gradlew clean
  cd ..
  flutter pub get
  

• 清理完成后重新启动项目。

3. 调整模拟器设置 #

• 关闭模拟器的快速启动：点击模拟器右上角三个点→开发者选项→关闭"快速启动"，重启模拟器再试。
• 增加模拟器内存：在AVD管理器里编辑该模拟器，把RAM调至2GB以上，避免内存不足导致启动卡住。

4. 更新Flutter版本 #

• 切换到稳定通道并升级：

  flutter channel stable
  flutter upgrade
  

• 部分旧版本Flutter和新模拟器存在兼容性问题，升级后大概率能解决。

5. 检查项目启动逻辑 #

• 打开AndroidManifest.xml，确认Application类的android:name配置正确，排除自定义Application引发的初始化阻塞。
• 暂时注释掉main.dart或页面initState里的耗时初始化代码，测试是否能正常启动，排查是否是业务代码导致的停滞。

6. 查看详细启动日志 #

• 用命令行启动项目并打印详细日志：

  flutter run -v
  

• 从日志里定位停滞的具体阶段（比如gradle构建、设备连接、代码初始化），精准排查问题。

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