Cocos Engine中WebSocket在Activity不可见时的JNI引用泄漏问题分析

问题背景

在Cocos Engine 3.8.2版本中，当运行在Android 11设备上时，开发者发现一个严重的稳定性问题：当包含Cocos视图的Activity被其他Activity覆盖或进入不可见状态时，应用会崩溃并抛出"JNI ERROR: global reference table overflow"错误。

问题现象

应用崩溃时的核心表现为：

1. 当Cocos所在的Activity从onResume进入onStop状态时
2. WebSocket在回调信息给JNI的过程中出现全局引用表溢出
3. 错误日志显示全局引用表已达到最大限制51200个
4. 崩溃堆栈指向CocosWebSocket的nativeOnBinaryMessage方法

技术分析

根本原因

通过分析崩溃堆栈和代码，发现问题出在JNI全局引用的管理上：

1. 在nativeOnBinaryMessage方法中，当创建JNI全局引用(NewGlobalRef)后
2. 如果此时Activity处于非Resume状态
3. 后续的引用释放代码(DeleteGlobalRef)未能执行
4. 导致每次WebSocket消息都会泄漏一个全局引用
5. 最终累积超过系统限制(51200)导致崩溃

引用泄漏机制

JNI全局引用是Java对象在Native代码中的长期引用，需要手动管理其生命周期。正常情况下应该遵循"创建-使用-释放"的流程。但在这种情况下：

1. WebSocket线程在后台持续接收消息
2. 每条消息都会触发JNI回调
3. 回调中创建全局引用但无法释放
4. 引用数量线性增长直至达到上限

解决方案

该问题已在Cocos Engine的最新代码中得到修复，主要改进包括：

1. 在JNI回调中添加状态检查机制
2. 确保在Activity不可见时不再处理WebSocket消息
3. 或者在处理消息时确保引用能够被正确释放
4. 增加异常处理逻辑防止引用泄漏

开发者建议

对于使用Cocos Engine的开发者，建议：

1. 及时升级到包含此修复的版本
2. 在Activity生命周期变化时适当管理WebSocket连接
3. 对于需要后台运行的WebSocket通信，考虑使用Service代替Activity
4. 定期检查应用中的JNI引用管理情况

总结

这个案例展示了Android开发中常见的JNI引用管理问题，特别是在多线程和复杂生命周期场景下的挑战。通过这个问题的分析，开发者可以更好地理解：

1. JNI全局引用的重要性
2. Activity生命周期对Native代码的影响
3. 多线程环境下资源管理的复杂性
4. Cocos Engine在Android平台上的工作机制

这类问题的解决不仅提高了框架的稳定性，也为开发者提供了处理类似问题的参考模式。