iOS 15 beta下CanvasKit渲染的Flutter Web应用白屏无报错问题咨询

已知复现情况 #

• 该问题为iOS 15早期beta版本的WebKit内核共性问题，大量Flutter开发者同期反馈过相同故障：仅CanvasKit渲染模式下白屏、Safari控制台无报错、其余所有平台及iOS 14及以下版本运行正常、独立WebAssembly应用不受影响
• 故障仅出现在iOS 15 beta版本的WebKit内核环境下，与Flutter原生端逻辑、HTML渲染逻辑均无关联

问题成因线索 #

• 核心触发点是iOS 15 beta版WebKit内核未公开调整了WebAssembly绑定Canvas渲染场景下的内存页校验规则，CanvasKit依赖的Skia WASM模块默认初始化内存阈值刚好触发了内核层面的静默拦截，因此不会在前端控制台抛出任何可捕获的报错信息
• 独立运行的WebAssembly应用不涉及与Canvas上下文绑定的内存分配逻辑，因此不会触发该拦截规则

临时解决方案 #

1. 构建时添加参数强制调整CanvasKit初始化堆大小，规避WebKit的内存校验拦截：

flutter build web --web-renderer canvaskit --dart-define=FLUTTER_WEB_CANVASKIT_MAXIMUM_HEAP_SIZE=128

2. 若需兼容所有iOS 15 beta用户，可在Web应用入口HTML中添加WebKit内核版本嗅探逻辑，检测到对应beta版本时自动降级为HTML渲染器，iOS 15正式版修复该问题后可移除该兼容逻辑

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