Flutter Windows应用单设备触发Null check operator异常求助

问题场景 #

Flutter开发的Windows应用上线一年，近百台设备运行正常，但一台Windows 11 24H2（内部版本26100.2033）设备出现异常：应用启动后仅显示灰色背景，IDE中运行触发红底黄字错误界面，错误栈指向Flutter源码Directionality.of的空检查操作，而非业务代码。设备配置为AMD Ryzen 5 6600H+Radeon显卡，无特殊语言或Directionality相关配置，预期展示包含用户名/密码输入框、错误提示、登录按钮的登录页。

错误栈信息 #

Null check operator used on a null value
#0      Directionality.of (package:flutter/src/widgets/basic.dart:178)
#1      RichText.createRenderObject (package:flutter/src/widgets/basic.dart:5881)
#2      RenderObjectElement.mount (package:flutter/src/widgets/framework.dart:6586)
#3      MultiChildRenderObjectElement.mount (package:flutter/src/widgets/framework.dart:7042)
#4      Element.inflateWidget (package:flutter/src/widgets/framework.dart:4468)
#5      Element.updateChild (package:flutter/src/widgets/framework.dart:3963)
#6      ComponentElement.performRebuild (package:flutter/src/widgets/framework.dart:5642)
#7      Element.rebuild (package:flutter/src/widgets/framework.dart:5333)
#8      ComponentElement._firstBuild (package:flutter/src/widgets/framework.dart:5599)
#9      ComponentElement.mount (package:flutter/src/widgets/framework.dart:5593)
#10     Element.inflateWidget (package:flutter/src/widgets/framework.dart:4468)
#11     Element.updateChild (package:flutter/src/widgets/framework.dart:3957)
#12     SingleChildRenderObjectElement.update (package:flutter/src/widgets/framework.dart:6907)
#13     Element.updateChild (package:flutter/src/widgets/framework.dart:3941)
#14     ComponentElement.performRebuild (package:flutter/src/widgets/framework.dart:5642)
#15     StatefulElement.performRebuild (package:flutter/src/widgets/framework.dart:5780)
#16     Element.rebuild (package:flutter/src/widgets/framework.dart:5333)
#17     BuildScope._tryRebuild (package:flutter/src/widgets/framework.dart:2693)
#18     BuildScope._flushDirtyElements (package:flutter/src/widgets/framework.dart:2752)
#19     BuildOwner.buildScope (package:flutter/src/widgets/framework.dart:3048)
#20     WidgetsBinding.drawFrame (package:flutter/src/widgets/binding.dart:1162)
#21     RendererBinding._handlePersistentFrameCallback (package:flutter/src/rendering/binding.dart:468)
#22     SchedulerBinding._invokeFrameCallback (package:flutter/src/scheduler/binding.dart:1397)
#23     SchedulerBinding.handleDrawFrame (package:flutter/src/scheduler/binding.dart:1318)
#24     SchedulerBinding._handleDrawFrame (package:flutter/src/scheduler/binding.dart:1176)
#28     _invoke (dart:ui/hooks.dart:314)
#29     PlatformDispatcher._drawFrame (dart:ui/platform_dispatcher.dart:419)
#30     _drawFrame (dart:ui/hooks.dart:283)
(elided 3 frames from dart:async)

可能的Windows系统设置诱因及解决方法 #

1. 区域/语言配置损坏 #

部分Win11 24H2版本可能存在区域设置缓存异常，导致Flutter无法获取系统文本方向（LTR/RTL），进而使Directionality组件初始化失败。

• 排查步骤：
  • 打开「设置」→「时间和语言」→「语言和区域」，确认默认语言为LTR类语言（如中文简体、英文），异常则重置为默认
  • 进入「管理语言设置」→「区域」选项卡，点击「重置」恢复默认格式配置
  • 重启设备后重新运行应用

2. 辅助功能干扰 #

高对比度、文本缩放等辅助功能可能修改系统UI渲染逻辑，破坏Directionality上下文传递。

• 排查步骤：
  • 打开「设置」→「辅助功能」→「高对比度」，确认功能关闭
  • 检查「文本大小」「缩放」设置为默认值（100%），有调整则恢复
  • 临时关闭所有辅助功能（屏幕阅读器、颜色滤镜等）后测试应用

3. 显示缩放比例异常 #

非标准缩放比例（如125%、150%）可能与Flutter渲染引擎存在兼容性问题，间接导致上下文丢失。

• 排查步骤：
  • 右键桌面→「显示设置」，确认「缩放」为系统推荐值
  • 若使用自定义缩放，尝试在应用manifest文件中添加高DPI支持声明：

    <application xmlns="urn:schemas-microsoft-com:asm.v3">
      <windowsSettings>
        <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/PM</dpiAware>
        <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">PerMonitorV2, PerMonitor</dpiAwareness>
      </windowsSettings>
    </application>
    

4. Flutter SDK版本兼容性 #

Win11 24H2为较新版本，旧版Flutter SDK可能存在未适配的系统API调用问题。

• 排查步骤：
  • 将Flutter SDK升级至最新稳定版（3.19+），重新编译应用测试
  • 若问题仍存在，在main.dart中强制指定Directionality根组件：

    void main() {
      runApp(
        Directionality(
          textDirection: TextDirection.ltr,
          child: MyApp(),
        ),
      );
    }
    

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