Flutter Hot Reload在Google Pixel 9 Pro真机上无法正常工作

1. 检查Impeller渲染后端兼容性 #

控制台显示应用使用了Impeller Vulkan渲染后端，Pixel 9系列这类新机型可能存在Vulkan版本与Flutter的适配问题。可临时切换到Skia渲染后端测试：

• 在Android Studio运行配置中添加启动参数：--no-enable-impeller
• 或修改android/app/src/main/AndroidManifest.xml，在<application>标签内添加：

  <meta-data
      android:name="io.flutter.embedding.android.EnableImpeller"
      android:value="false" />
  

  重启应用后尝试Hot Reload。

2. 确认设备调试连接状态 #

• 执行flutter devices命令，检查设备是否标注(debug)模式
• 执行flutter attach手动连接调试服务，验证是否能成功建立WebSocket连接（对应控制台的Debug service listening on ws://...）
• 断开USB重新连接，确保设备上“允许USB调试”权限未过期

3. 同步插件与SDK版本 #

• 升级Android Studio的Flutter、Dart插件到最新稳定版
• 执行flutter upgrade将Flutter SDK更新至最新稳定版本，规避版本兼容性问题

4. 验证代码变更符合热重载条件 #

• Hot Reload仅支持无状态代码变更，若修改了main()方法、全局变量初始化、新增/删除Widget的key，需重启应用而非使用Hot Reload
• 强制保存所有修改文件（Ctrl+S），观察控制台是否出现Syncing files to device...提示

5. 深度清理缓存并重建项目 #

• 删除项目根目录下的.dart_tool、build文件夹
• 执行flutter pub get重新获取依赖
• 重启Android Studio并清除IDE缓存（File -> Invalidate Caches... -> Invalidate and Restart）

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