如果构建日志同时出现 Flutter 3.50.0、Dart 3.14.0、AOT 编译和 linearscan.cc:3013: unreachable code,应优先按原报告所称的已知编译器 P0 处理,而不是先排查业务代码里的空指针。它发生在应用生成之前,与 Release 包安装后出现的白屏或运行时崩溃不是同一类问题。
临时处理方式有两种:回退到包含 Dart 3.13.5 的已知可用 Flutter 工具链,或者等待并升级到包含上游修复的正式 Flutter 版本。现有资料只能确认“热榜原文发布时尚未发布 hotfix”,不能证明现在仍然没有 hotfix;正式升级前需要核对 Dart #64923 及其关联提交,再对照 Flutter 官方发布记录。不要只替换一个 dart 二进制,Flutter SDK、Dart SDK 和引擎版本应保持为一套经过验证的工具链。
这条报错到底是不是 Flutter 3.50.0 的已知问题?
原报告给出了一组版本对照:同一份代码在 Dart 3.13.5 下可以完成编译;升级到 Dart 3.14.0 后,dart run 完全正常,但只要进入 AOT 编译,gen_snapshot 就会报:
linearscan.cc:3013: unreachable code
这说明 dart run 正常只能证明解释执行路径没有暴露问题,不能证明 AOT 编译路径正常。gen_snapshot 会在编译阶段生成快照,一旦失败,此时还没有可供安装、启动并观察运行日志的应用包。
因此,如果构建失败发生在 gen_snapshot,排查重点应当是编译器、SDK 版本和触发它的代码模式,而不是应用启动后的 Widget 渲染、插件生命周期或空值访问。
先从当前构建环境确认实际使用的版本:
flutter --version
这里应当同时记录 Flutter 版本和它所带的 Dart 版本,而不是只看 CI 镜像标签。不同任务可能使用不同的缓存、容器镜像或开发机 SDK,宿主机升级了 Flutter 并不代表构建机也已经更新。
为什么 dart run 正常,gen_snapshot 还是会失败?
问题来自 Dart 编译器前端留下的控制流与后端 Store-to-Load Forwarding 优化之间的一处不一致。
以一个只有 Query 和 Item 两种子类型的 sealed class 为例,模式匹配原本是穷尽的。按照 Dart 的类型语义,进入 Item 分支时可以把 picked 赋给一个尚未初始化的 final 局部变量,随后再由闭包捕获这个变量。
但 Dart CFE,也就是 Common Front End,在把模式匹配转换成底层条件分支时,仍然保留了一条类似 if (opt is Item) 的判断结构。这样一来,中间控制流里就多出了一条“跳过赋值,继续往下走”的路径。
在 Dart 3.14 之前,25ae146 引入了 Store-to-Load Forwarding 优化。它针对的是被闭包捕获的 effectively final 局部变量:这类变量通常保存在 Context 中,如果初始化写入唯一,就可以把后续读取直接替换为初始化值,从而少做一次内存读取。
这套实现隐含了一个前提:找到唯一的初始化写入后,它一定支配所有读取位置。上面那条由 CFE 留下的多余路径却绕过了赋值,导致初始化值和读取之间不满足支配关系。后端继续做替换后,生成的 IL 中就出现了“当前路径上尚未定义,却被拿去读取”的值,最终形成非法中间表示,gen_snapshot 随之在支配关系或线性扫描阶段报出 unreachable code。
所以它并不是 sealed class 本身有错,也不是模式匹配在 Dart 语义上不成立,而是编译器降级后的控制流与后端优化之间出现了不一致。Dart 团队为相关 CFE lowering 问题建立了 #64923 跟踪。
什么条件下,sealed class 和 switch 写法可能触发这个问题?
原报告展示的关键模式如下:
case Query(:final text):
case Item(value: final picked):
这段代码不能脱离上下文直接复制成完整工程,但已经能看出问题结构:Opt 是仅包含 Query 和 Item 两种子类型的 sealed class;Query 分支直接返回,Item 分支绑定 picked,再把 picked 赋给一个局部变量;局部变量的声明类似下面:
final Object value;
随后,这个变量被闭包捕获。
要命中这个已知问题,通常需要同时具备几个条件:使用 sealed 子类型的模式匹配;某个 final 局部变量只在其中一个分支初始化;该变量随后被闭包捕获;最终构建进入受影响的 AOT 优化路径。
其中,闭包捕获和分支内初始化很关键。如果变量在 switch 之前已经完成初始化,或者读取路径没有经过这次 Store-to-Load Forwarding,问题就未必会复现。同样,仅凭项目里出现了 sealed class、模式匹配或 Release 构建,还不足以认定为同一个 P0。
怎样确认自己的项目确实命中了它?
可以把下面几项放在一起判断:
| 核对项 | 命中信号 |
|---|---|
| Flutter 版本 | 3.50.0 |
| Dart 版本 | 3.14.0 |
| 失败阶段 | gen_snapshot 或 AOT snapshot 生成 |
| 错误文件 | linearscan.cc |
| 错误文本 | unreachable code |
| 原报告中的行号 | 3013 |
| 代码结构 | sealed 模式匹配、分支内初始化 final 变量、闭包捕获 |
原报告中的行号来自当时的编译器版本,后续代码调整可能让行号发生变化,因此检索日志时不要只匹配 3013,应当同时搜索:
linearscan.cc
unreachable code
Android 项目可以用 Release 构建快速确认是否进入同一路径:
flutter build apk --release
其他平台应运行对应的 Release 构建命令。关键是保留完整构建日志、Flutter/Dart 版本以及失败发生在哪个子命令中。仅凭“Release 崩溃”这一描述不足以确认命中;如果 flutter build 已经成功,随后安装启动才崩溃,就应转入运行时排查。
清理 build 目录或下载缓存通常也不会解决这个 P0,因为触发点位于 SDK 内部的 AOT 优化路径,而不是项目构建产物。
修复提交到底改了什么,25ae146 是不是修复?
25ae146 不是这次问题的修复提交。它引入了相关的 Store-to-Load Forwarding 优化,也是让旧有初始化假设暴露出来的改动之一。
原报告给出的修复位置是 LoadFieldInstr::Canonicalize()。核心检查是:
Definition* value = initializing_store->value()->definition();
if (IsDominatedBy(value)) {
这只是修复片段,不是可以脱离上下文直接应用的补丁。它的含义是:只有当初始化值的定义支配读取位置,也就是到达读取点的所有控制流路径都已经完成初始化时,后端才允许把读取替换为该初始化值。
这样一来,CFE 留下的那条“没有初始化就继续执行”的路径不会再被错误优化,生成非法 IL 的条件也就被切断了。
现有资料没有提供这次修复的完整 commit SHA 或 PR 链接,因此不能凭 25ae146 推断修复提交,也不应把它作为 cherry-pick 的目标。正式核验时,应从 Dart #64923 找到实际关联的提交与 PR,再确认该提交进入了哪个 Dart SDK,最后查清哪个 Flutter 稳定版本实际携带了这个 Dart SDK。
现在已经发布 Flutter 3.50.0 hotfix 了吗?
仅凭热榜原文,能够确认的状态只有“原文发布时尚未 hotfix”。这个结论只反映原报告发布时点,不能视为当前状态,也不能据此推断今天仍没有补丁。现有资料支持的结论与发布前需要完成的核验如下:
| 核验项 | 现有材料支持的状态 | 发布前动作 |
|---|---|---|
| Dart 上游修复 | 原报告称修复已加入 LoadFieldInstr::Canonicalize(),相关 CFE lowering 问题由 #64923 跟进 |
核对关联 PR、完整 commit SHA 和首个包含修复的 Dart SDK |
| Flutter hotfix | 热榜原文发布时尚未 hotfix | 检查 Flutter 3.50.x 官方发布记录,确认实际捆绑的 Dart 版本 |
| 当前版本号 | 所给资料没有最新 Flutter 3.50.x 列表,不能自行填写 | 以官方 release notes 为准,记录具体版本与发布日期 |
| 核验时间 | 旧文章只能说明原报告发布时点 | 每次发布前记录实际核验日期,不能沿用旧结论 |
核验时使用 Dart SDK #64923、Flutter Release Notes 和 Flutter Release Archive。如果官方记录没有明确列出对应 hotfix,团队就不应把“上游仓库已经有补丁”等同于“生产构建已经能拿到修复”。
没有 hotfix 时,开发和运维现在怎么做?
先暂停受影响的 Release 发布,把已知可用的 Flutter 工具链固定下来。原报告中的 Dart 3.13.5 可以作为编译基线,但它只证明报告里的样例在该版本能够通过,不能保证所有依赖和目标平台都能无条件降级。回退后仍要重新执行依赖解析、目标平台构建和必要的集成测试。
如果构建发生在 Docker 或 CI 中,应锁定实际安装的 Flutter SDK 版本,而不是只固定镜像名称或使用 latest 标签。升级开发机上的 SDK,也不会自动改变已有容器镜像里的工具链。
AOT 编译应当进入 CI 冒烟检查。对 Android 项目,至少保留一条 Release 构建:
flutter build apk --release
需要发布其他平台时,再补上对应目标的 Release 构建。这样做不仅能拦截这次 gen_snapshot 失败,也能发现升级 SDK 后才出现的其他 AOT 编译回归。
等到正式 hotfix 发布后,也不要只因为版本号变新就直接恢复全部构建。至少要确认三件事:官方发布记录明确包含该修复;构建机实际使用的 SDK 与预期版本一致;同一提交重新完成 AOT 构建并通过目标平台验证。
如果不是编译时报错,而是应用启动后才崩呢?
如果应用已经成功生成、安装并启动后才崩溃,就不属于这条 AOT 编译 P0。运行时至少应先区分崩溃发生在哪一层:
| 日志标记 | 排查方向 |
|---|---|
Caught signal |
Native 引擎、C++、GPU 或内存访问问题 |
Unhandled exception |
Dart 代码中的未处理异常 |
FLUTTER_ETS_EXCEPTION |
OHOS 场景下的 ETS 插件或平台通道问题 |
Native 崩溃通常没有 Dart 异常栈,需要结合 Caught signal、引擎堆栈和 GPU 相关信息继续定位;Unhandled exception 应回到 Dart 业务代码;FLUTTER_ETS_EXCEPTION 则要检查 ArkTS 插件和 MethodChannel 回调,在 OHOS 场景中它也可能只导致某项功能失败,而不是整个进程退出。
Release 模式下部分 Dart 异常信息还可能不如调试模式完整,相关排查资料也提醒不要因为日志里没有明显异常就立即判断“没有异常”。 但无论运行时日志是否丰富,都不能把应用启动后的崩溃倒推成 gen_snapshot 的编译器问题,更不能据此直接套用 Dart 3.13.5 的回退结论。
“Dart 上游给出修复”和“Flutter 用户拿到可用 hotfix”是两件事。生产升级是否安全,最终要看团队是否从官方发布记录中确认了包含修复的 Flutter/Dart 正式版本,并确认构建环境真的使用了它。












暂无评论内容