Cocos引擎Android原生开发中的NullPointerException问题分析与解决方案

问题背景

在Cocos Creator 3.8.4版本的Android原生开发中，线上版本出现了大量由Java NullPointerException引起的闪退问题。这些问题主要涉及三种不同类型的异常情况，对用户体验造成了严重影响。

主要问题类型分析

1. InputDevice.getSources()空指针异常

这类异常主要出现在华为MatePad设备上，错误堆栈显示：

java.lang.NullPointerException
Attempt to invoke virtual method 'int android.view.InputDevice.getSources()' on a null object reference

该问题与游戏手柄控制器相关，虽然开发者并未直接调用相关API，但系统底层在处理输入设备时出现了空指针异常。

2. SharedPreferences空指针异常

这类问题表现为：

java.lang.NullPointerException
Attempt to invoke virtual method 'android.content.SharedPreferences android.content.Context.getSharedPreferences(java.lang.String, int)' on a null object reference

根本原因是GlobalObject中保存的Context对象（Activity上下文）在某些情况下被销毁后重建，导致在销毁后重建前的短暂时间内执行相关任务时出现空指针。

3. 不平衡的绘制调用异常

这类问题表现为：

java.lang.RuntimeException
Unbalanced drawPending/pendingDrawFinished calls

这是Android系统层面的绘制调用不平衡问题，通常与视图系统的生命周期管理有关。

技术原理分析

Context生命周期问题

在Android开发中，Context分为Application Context和Activity Context两种：

1. Application Context：与应用程序生命周期一致，不会随Activity销毁而改变
2. Activity Context：与特定Activity绑定，会随Activity销毁而无效

Cocos引擎当前实现中，GlobalObject保存的是Activity Context，这导致以下问题：

• 当Activity因系统资源回收、第三方登录/支付等操作被销毁重建时
• 在销毁后重建前的间隙期，任何使用该Context的操作都会失败
• 特别是后台任务（如下载）可能在此期间继续执行并访问无效Context

输入设备管理问题

华为设备特有的输入设备管理问题可能源于：

1. 设备特定的输入设备管理实现
2. 系统服务在特定情况下的异常行为
3. 输入设备热插拔处理不完善

解决方案

1. 针对Context问题的解决方案

推荐方案：使用Application Context

修改GlobalObject实现，使其保存Application Context而非Activity Context：

public static void init(Context context, Activity activity) {
    sContext = context.getApplicationContext(); // 改为获取Application Context
    sActivity = activity;
}

优点：

• 生命周期与应用程序一致
• 不受Activity重建影响
• 保证后台任务的持续执行

临时解决方案：增加空检查

在关键代码路径（如CocosDownloader）中添加Context空检查：

if (GlobalObject.getContext() != null) {
    // 执行需要Context的操作
}

2. 针对输入设备问题的解决方案

由于问题出现在系统层面，建议：

1. 添加try-catch块捕获相关异常
2. 在异常发生时提供优雅降级处理
3. 与华为技术团队沟通获取设备特定解决方案

3. 针对绘制不平衡问题的解决方案

这类问题通常需要：

1. 确保所有drawPending调用都有对应的pendingDrawFinished
2. 检查视图系统生命周期管理
3. 避免在非UI线程操作视图

实施建议

1. 优先级处理：首先解决Context相关问题，因其影响范围广且修复方案明确
2. 兼容性测试：修改后需进行全面测试，特别是Activity重建场景
3. 错误监控：加强线上错误监控，及时发现新问题
4. 渐进式发布：采用灰度发布策略观察修复效果

总结

Cocos引擎Android原生开发中的NullPointerException问题主要源于Context生命周期管理和设备特定实现差异。通过合理选择Context类型、增加防御性编程以及与设备厂商合作，可以有效解决这些问题，提升应用稳定性和用户体验。开发者在处理类似问题时，应深入理解Android系统原理，结合具体场景选择最适合的解决方案。