按键触发游戏状态切换时如何避免Android OpenGL ES上下文丢失

该报错的核心触发逻辑非常明确：Android GLSurfaceView的OpenGL ES上下文默认仅绑定在独立的GL渲染线程，所有OpenGL ES API调用必须在该线程内执行，跨线程调用必然触发无上下文错误。

• 按键事件的分发、回调逻辑默认运行在Android UI主线程，如果你在按键回调中直接触发状态切换、执行目标状态内的GL相关调用，本质是在没有绑定EGL上下文的UI线程操作GL API，必然触发E/libEGL: call to OpenGL ES API with no current context (logged once per thread)错误
• 20秒无操作自动切换的逻辑通常写在Renderer.onDrawFrame()回调中，这个回调本身就在GL渲染线程执行，上下文处于绑定状态，自然不会触发错误
• 布尔数组缓存按键的方案之所以不报错，是因为该方案仅在UI线程修改布尔标记位，没有直接在UI线程执行GL调用，把状态切换的执行时机延后到了GL线程，但未处理多线程状态可见性、状态消费重置逻辑，才会出现按键状态持续为true的粘滞问题
• 自动切换状态后触发按键弹出的兼容性变更日志与该问题无关，是Android系统针对应用targetSdkVersion与系统版本差异输出的提示信息，不影响GL线程正常执行逻辑

1. 严格划分线程边界，禁止跨线程直接执行GL相关逻辑 #

所有涉及状态切换、GL资源创建/销毁、渲染参数修改的逻辑，必须投递到GL渲染线程执行，绝对不能在UI线程的按键回调中直接处理：

• 按键回调中仅做事件入队操作，不要直接修改渲染状态、调用GL方法
• 利用GLSurfaceView自带的queueEvent()方法将待执行的状态切换逻辑投递到GL渲染线程，保证逻辑执行时EGL上下文已正常绑定
  参考代码：

// 错误写法：直接在UI线程触发状态切换
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
    if (keyCode == KeyEvent.KEYCODE_DPAD_CENTER) {
        // 逻辑运行在UI线程，切换状态后触发GL调用必报错
        stateMachine.switchState(new GameRunState());
        return true;
    }
    return super.onKeyDown(keyCode, event);
}

// 正确写法：将状态切换逻辑投递到GL线程执行
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
    if (keyCode == KeyEvent.KEYCODE_DPAD_CENTER) {
        glSurfaceView.queueEvent(() -> {
            // 逻辑运行在GL渲染线程，上下文绑定正常
            stateMachine.switchState(new GameRunState());
        });
        return true;
    }
    return super.onKeyDown(keyCode, event);
}

2. 修复按键缓存方案的粘滞问题 #

如果继续使用布尔数组缓存按键状态，需要补全两个关键处理：

• 保证多线程状态可见性：不要用普通布尔数组存储按键状态，替换为AtomicBooleanArray，或者给数组引用加volatile修饰，避免UI线程写入的状态因CPU线程缓存对GL线程不可见，或读到残留旧状态
• 建立状态消费重置机制：固定在onDrawFrame每帧渲染的最开始读取按键缓存状态，执行完对应响应逻辑（包括状态切换）后，立刻将已处理的按键状态位重置为false；每次执行状态切换前，主动清空整个按键缓存数组，避免上一个状态的按键事件残留到新状态

3. 兜底上下文保护配置 #

初始化GLSurfaceView时增加如下配置，减少意外的上下文丢失概率：

// 暂停时保留EGL上下文不释放，避免切后台返回后上下文丢失
glSurfaceView.setPreserveEGLContextOnPause(true);
// 明确指定EGL上下文版本为3.0，和使用的OpenGL ES 3.0匹配
glSurfaceView.setEGLContextClientVersion(3);

修复完成后可按顺序验证：

• 按键触发状态切换时不再输出无上下文的EGL错误
• 状态切换后按键响应正常，无粘滞、状态不复位问题
• 手动按键切换状态、自动超时切换状态的表现完全一致

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