Flutter打包iOS/Android失败，出现空安全相关编译错误

问题背景 #

此前项目打包一直正常，近几个月未更新Flutter、Dart及任何依赖包，现在执行打包时出现编译错误。

环境信息 #

Flutter 3.3.8 • channel stable • https://github.com/flutter/flutter.git
Framework • revision 52b3dc25f6 (4个月前) • 2022-11-09 12:09:26 +0800
Engine • revision 857bd6b74c
Tools • Dart 2.18.4 • DevTools 2.15.0

编译错误详情 #

💪 使用严格空安全模式构建 💪

...
注意：使用 -Xlint:unchecked 重新编译以获取详细信息。
../../../../Development/flutter/.pub-cache/hosted/pub.dartlang.org/keyboard_actions-4.2.0/lib/keyboard_actions.dart:322:31: 错误：类型为'OverlayState?'的值无法分配给类型为'OverlayState'的变量，因为'OverlayState?'可为空而'OverlayState'不可为空。
 - 'OverlayState' 来自 'package:flutter/src/widgets/overlay.dart' ('../../../../Development/flutter/packages/flutter/lib/src/widgets/overlay.dart').
    OverlayState os = Overlay.of(context);
                              ^
../../../../Development/flutter/.pub-cache/hosted/pub.dartlang.org/syncfusion_flutter_calendar-20.4.53/lib/src/calendar/sfcalendar.dart:10776:71: 错误：类型为'RenderAbstractViewport?'的值无法从返回类型为'RenderAbstractViewport'的函数返回，因为'RenderAbstractViewport?'可为空而'RenderAbstractViewport'不可为空。
 - 'RenderAbstractViewport' 来自 'package:flutter/src/rendering/viewport.dart' ('../../../../Development/flutter/packages/flutter/lib/src/rendering/viewport.dart').
  RenderAbstractViewport get _stackViewPort => RenderAbstractViewport.of(this);
                                                                      ^
../../../../Development/flutter/.pub-cache/hosted/pub.dartlang.org/keyboard_actions-4.2.0/lib/external/keyboard_avoider/bottom_area_avoider.dart:194:27: 错误：无法在'RenderAbstractViewport?'上调用方法'getOffsetToReveal'，因为它可能为空。
 - 'RenderAbstractViewport' 来自 'package:flutter/src/rendering/viewport.dart' ('../../../../Development/flutter/packages/flutter/lib/src/rendering/viewport.dart').
请尝试改用 ?. 调用。
  final offset = viewport.getOffsetToReveal(object, 1.0).offset + overscroll;
                          ^^^^^^^^^^^^^^^^

FAILURE: 构建失败，出现异常。

* 位置：
脚本 '/Users/christophevidal/Development/flutter/packages/flutter_tools/gradle/flutter.gradle' 行：1159

* 错误原因：
任务 ':app:compileFlutterBuildRelease' 执行失败。
> 进程 'command '/Users/christophevidal/Development/flutter/bin/flutter'' 以非零退出值1结束

* 尝试方案：
使用 --stacktrace 选项获取堆栈跟踪。使用 --info 或 --debug 选项获取更多日志输出。使用 --scan 获取完整分析信息。

* 获取更多帮助：https://help.gradle.org

构建失败耗时17秒
正在运行Gradle任务 'assembleRelease'...                           18.2秒
Gradle任务assembleRelease执行失败，退出码1

问题原因及解决方法 #

核心原因 #

这些错误均由依赖包未适配Flutter的空安全规则导致：Flutter 3.x版本中部分API返回值改为可空类型（如Overlay.of(context)返回OverlayState?），但当前使用的依赖包版本仍按非空类型处理，触发编译报错。

解决步骤 #

1. 升级keyboard_actions依赖
   当前使用的4.2.0版本未处理空安全适配，需升级到最新稳定版。在pubspec.yaml中修改版本号后执行flutter pub get：

   dependencies:
     keyboard_actions: ^最新版本号
   

2. 升级syncfusion_flutter_calendar依赖
   20.4.53版本的_stackViewPort getter未处理RenderAbstractViewport.of(this)的可空返回值，升级到适配空安全的版本即可解决：

   dependencies:
     syncfusion_flutter_calendar: ^最新版本号
   

3. 临时替代方案（不推荐）
   若暂时无法升级依赖，可手动修改本地缓存的依赖包代码（添加空安全处理，如使用!断言或?.调用），但后续执行flutter pub get会覆盖修改，仅作临时测试使用。

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