You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

升级到Flutter 2.5.2后Flutter Web代码变更触发热重载卡住问题

问题根因

该问题是Flutter 2.5.x稳定版的已知官方BUG,仅出现在Windows平台的Web端运行场景。触发原因是2.5版本迭代中,Dart SDK的增量编译模块更新了Web端热重载的文件校验逻辑,但未适配Windows系统文件路径大小写不敏感的特性:修改代码后工具链生成的增量资源路径和本地缓存的资源路径因大小写规则不匹配,导致哈希校验持续失败,进程陷入无限重试逻辑,最终表现为热重载卡住、无响应。2.2.3版本未引入该校验逻辑,因此运行正常。

可行解决方案
  • 方案1(最优长期方案):升级Flutter到2.10.0及以上稳定版本,该问题已被官方在后续迭代中修复,升级后即可正常使用Web端热重载功能。
  • 方案2(临时兼容方案):若当前项目暂时无法升级Flutter版本,可在运行Web端时添加禁用增量编译的启动参数,执行命令为flutter run -d chrome --no-incremental,热重载速度会略有下降,但可规避卡住问题。
  • 方案3(应急临时方案):热重载卡住时无需停止运行进程,直接手动刷新浏览器页面即可加载最新修改的代码内容。

内容的提问来源于stack exchange,提问作者skosyrskyv

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.30 22:24:01