自定义Android设备上Flutter应用启动失败，抛出Display.getRefreshRate()空指针异常

问题分析 #

异常堆栈核心是Flutter引擎调用android.view.Display.getRefreshRate()时，Display对象为null。这是自定义Android设备的系统层实现存在兼容性问题——标准Android 9设备能正常获取Display实例，但你的自定义设备在Flutter初始化阶段返回了null，触发空指针崩溃。

修复方案 #

1. 降级到兼容的Flutter稳定版本 #

部分新Flutter版本的Display获取逻辑未考虑自定义设备的异常场景，可尝试降级到经过广泛验证的稳定版本，比如3.7.12：

flutter downgrade 3.7.12

执行后重新编译运行项目。

2. 自定义MainActivity处理Display空值 #

修改Android端MainActivity，继承FlutterActivity并重写初始化逻辑，提前处理Display为null的情况：

import android.os.Bundle;
import android.view.Display;
import android.view.WindowManager;
import io.flutter.embedding.android.FlutterActivity;

public class MainActivity extends FlutterActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // 提前获取Display并处理空值
        Display display = getWindowManager().getDefaultDisplay();
        if (display == null) {
            // 为自定义设备设置默认刷新率 fallback
            WindowManager.LayoutParams params = getWindow().getAttributes();
            params.refreshRate = 60.0f;
            getWindow().setAttributes(params);
        }
        super.onCreate(savedInstanceState);
    }
}

修改完成后重新编译APK安装到自定义设备。

3. 切换Flutter渲染模式 #

在android/app/src/main/res/values/styles.xml中修改主题配置，强制使用兼容的渲染模式，绕开异常的Display获取路径：

<style name="LaunchTheme" parent="@android:style/Theme.Black.NoTitleBar">
    <!-- 添加以下属性 -->
    <item name="android:windowDisablePreview">true</item>
    <item name="io.flutter.embedding.android.renderMode">surface</item>
</style>

4. 检查自定义设备系统固件 #

自定义设备可能缺少标准Android 9的系统补丁，导致Display相关API返回异常。联系设备厂商获取最新固件更新，或自行补全系统中Display服务的实现逻辑。

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