三星折叠屏Android14设备UnsupportedOperationException崩溃求助

问题背景 #

应用仅在三星折叠屏Android14设备上触发UnsupportedOperationException崩溃，暂未明确复现步骤，以下是基于堆栈信息的分析与修复方案。

崩溃堆栈 #

Fatal Exception: java.lang.UnsupportedOperationException: 尝试从未关联显示器的Context获取显示器。仅可视化Context（如Activity或通过Context#createWindowContext创建的实例）或通过Context#createDisplayContext创建的Context才关联显示器。其他类型Context通常属于后台实体，可能返回任意显示器。
       at android.app.ContextImpl.getDisplay(ContextImpl.java:3166)
       at android.content.ContextWrapper.getDisplay(ContextWrapper.java:1209)
       at android.content.ContextWrapper.getDisplay(ContextWrapper.java:1209)
       at android.content.ContextWrapper.getDisplay(ContextWrapper.java:1209)
       at androidx.window.extensions.layout.WindowLayoutComponentImpl.shouldReportDisplayFeatures(WindowLayoutComponentImpl.java:355)
       at androidx.window.extensions.layout.WindowLayoutComponentImpl.getDisplayFeatures(WindowLayoutComponentImpl.java:313)
       at androidx.window.extensions.layout.WindowLayoutComponentImpl.getWindowLayoutInfo(WindowLayoutComponentImpl.java:265)
       at androidx.window.extensions.layout.WindowLayoutComponentImpl.onDisplayFeaturesChanged(WindowLayoutComponentImpl.java:250)
       at androidx.window.extensions.layout.WindowLayoutComponentImpl.$r8$lambda$CcdqSJgN0v7j8yjFplaR5_gC_ag()
       at androidx.window.extensions.layout.WindowLayoutComponentImpl$ExternalSyntheticLambda0.accept(:4)
       at androidx.window.util.BaseDataProducer.notifyDataChanged(BaseDataProducer.java:101)
       at androidx.window.common.DeviceStateManagerFoldingFeatureProducer.notifyFoldingFeatureChange(DeviceStateManagerFoldingFeatureProducer.java:212)
       at androidx.window.common.DeviceStateManagerFoldingFeatureProducer.-$Nest$mnotifyFoldingFeatureChange()
       at androidx.window.common.DeviceStateManagerFoldingFeatureProducer\$1.$r8$lambda$Cq8m54r9pahGe0xgKiimh_L76YM()
       at androidx.window.common.DeviceStateManagerFoldingFeatureProducer\$1$ExternalSyntheticLambda0.accept(:4)
       at androidx.window.common.RawFoldingFeatureProducer.getData(RawFoldingFeatureProducer.java:71)
       at androidx.window.common.DeviceStateManagerFoldingFeatureProducer\$1.onStateChanged(DeviceStateManagerFoldingFeatureProducer.java:87)
       at android.hardware.devicestate.DeviceStateManagerGlobal$DeviceStateCallbackWrapper.lambda$notifyStateChanged\$2(DeviceStateManagerGlobal.java:428)
       at android.hardware.devicestate.DeviceStateManagerGlobal$DeviceStateCallbackWrapper.$r8$lambda$FiFeo7UDl_Jzgv3ijVmtwGDn8K0()
       at android.hardware.devicestate.DeviceStateManagerGlobal$DeviceStateCallbackWrapper$ExternalSyntheticLambda0.run(:4)
       at android.os.Handler.handleCallback(Handler.java:958)
       at android.os.Handler.dispatchMessage(Handler.java:99)
       at android.os.Looper.loopOnce(Looper.java:230)
       at android.os.Looper.loop(Looper.java:319)
       at android.app.ActivityThread.main(ActivityThread.java:8919)
       at java.lang.reflect.Method.invoke(Method.java)
       at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:578)
       at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1103)

核心原因 #

崩溃由androidx.window库在处理折叠屏状态变化时，使用了未关联显示器的Context（如Application Context、Service Context）调用getDisplay()导致。Android14对Context的Display关联校验更严格，三星折叠屏设备的系统实现进一步强化了这一限制，当折叠状态触发布局更新时，不符合要求的Context直接抛出异常。

修复方案 #

• 强制使用可视化Context：所有涉及折叠屏布局信息（如WindowLayoutInfo）的操作，必须传入Activity Context。若需在后台组件（如Service）中处理，需通过Context.createWindowContext()或Context.createDisplayContext()创建关联显示器的Context实例。
• 调整初始化时机：避免在Application启动阶段或后台组件中提前注册折叠屏状态监听，应延迟到Activity的onCreate()或onStart()生命周期之后执行。
• 异常捕获降级：在调用getWindowLayoutInfo()等相关API的代码块外层添加try-catch，捕获UnsupportedOperationException后使用默认布局逻辑兜底。
• 升级依赖库：将androidx.window:window及相关扩展库升级至最新稳定版，官方可能已修复此类设备特定的兼容性问题。

复现思路 #

• 使用三星折叠屏Android14设备，在应用后台运行时切换折叠状态（展开/折叠）。
• 模拟应用从后台唤醒时触发折叠状态变化的场景。
• 检查代码中是否存在在Service、BroadcastReceiver等后台组件中处理折叠屏逻辑的路径。

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