李游LeoHarmonyOS
XComponent 切换页面销毁后,NAPI 创建的纹理、缓冲区内存没有释放,咋回事
我在 XComponent 的 surfaceCreated 里面通过 NAPI 创建了外部纹理和像素缓冲区,当退出页面触发 surfaceDestroyed 回调。内存观测发现这部分原生内存并没有回落,我怀疑资源泄漏。
XComponent 的 surfaceDestroyed 回调触发时机和组件 aboutToDisappear 谁先执行?
哪些情况会出现 surfaceDestroyed 不被调用?
贝罗特surfaceDestroyed 不被调用的情况有:
1.页面/组件未真正销毁
2.应用切后台/熄屏
3.Surface没有被成功创建
蓝瘦的蜕变
这通常不是 ArkUI 自动没回收,而是 Native 资源还被你自己的渲染对象、全局 Map、渲染线程或 NAPI 引用持着。surfaceDestroyed 只说明 Surface 没了,不会自动帮你 glDeleteTextures/glDeleteBuffers、eglDestroySurface/eglDestroyContext、释放 OHNativeWindow、munmap/free,更不会自动删你按 surfaceId 缓存的 Renderer。
aboutToDisappear 和 surfaceDestroyed 没有可依赖的固定先后顺序。实际页面销毁时通常会先看到 aboutToDisappear,Surface 真正解绑后才到 surfaceDestroyed;但转场、页面缓存、组件复用时 Surface 可能延后销毁甚至不销毁。做法是两个回调都调用同一个幂等 releaseOnce(surfaceId):先停渲染线程并 join,再在有效 EGL Context 中删纹理/VBO/FBO,最后销毁 EGL Surface、Context 和 NativeWindow,并从全局容器 erase。
surfaceDestroyed 不一定会触发的常见情况:
- 页面只是
aboutToDisappear,但被 Navigation 缓存、复用或仅隐藏,XComponent 仍在渲染树。 - 只是退后台、锁屏、窗口失焦或尺寸变化;这些不等于 Surface 被销毁。
- XComponent 不是
SURFACE类型,或 Surface 根本没创建成功。 - 进程崩溃、被系统直接杀掉、用户强停,生命周期回调本来就不保证执行。
另外 GPU 内存释放常是异步的,glDelete* 后监控数值不会立刻下降;但如果多次进出页面持续上涨,优先查 surfaceId -> Renderer 的 Map、渲染线程、napi_ref/JS 包装对象和 NativeWindow 是否仍有引用。
橙动创意surfaceDestroyed 表示 Surface 生命周期结束,不会替你释放自建纹理、像素内存和所有 N-API 引用。不要依靠它与 aboutToDisappear 的猜测顺序做正确性保证;先停止新帧和旧异步回调,再让持有正确图形上下文的渲染线程清理自己拥有的 GPU 对象。
例如 GLES 清理的关键部分应在对应 Context 仍 current 的线程执行,而不是线程退出后随便换线程调用:
if (textureId != 0) {
glDeleteTextures(1, &textureId);
textureId = 0;
}
if (bufferId != 0) {
glDeleteBuffers(1, &bufferId);
bufferId = 0;
}随后按所有权配对释放 EGL/NativeWindow/像素缓冲区;别在 finalizer 和页面退出各 delete 一次。仅隐藏、退后台或页面仍被缓存不等于 Surface 已销毁;定位泄漏看多次进入退出后的活跃对象、线程和引用计数趋势,单次 RSS 不立刻下降还不能证明泄漏。
仙银
内存不回落大概率不是泄漏,是没在回调里主动释放 Native 资源。XComponent 的 Surface 销毁只回收系统侧的 NativeWindow 引用计数和 BufferQueue,你自己在 Native 层 malloc 的像素缓冲区、glGenTextures 创建的 GPU 纹理、OH_NativeImage 对象,系统不会帮你释放。
1. 纹理和缓冲区内存为什么不回落
Surface 销毁时系统做的事:把持有的 NativeWindow 引用计数减一,归零后释放 NativeWindow 和关联的 BufferQueue(OH_NativeXComponent_Callback 文档)。你自己创建的东西需要自己清:
- OpenGL 纹理:调
glDeleteTextures删除 - EGL 资源:依次调
eglDestroySurface→eglDestroyContext→eglTerminate - OH_NativeImage 对象:调
OH_NativeImage_Destroy,之后将指针置 nullptr - malloc/new 的像素缓冲区:调
free/delete
官方图形缓冲区稳定性文档明确说了:超过 90% 的问题都是引用计数增减接口未配对导致的(图形缓冲区常见稳定性问题)。如果你在 surfaceCreated 里对 NativeWindow 调了 OH_NativeWindow_NativeObjectReference() 加引用,surfaceDestroyed 里必须配对调 OH_NativeWindow_NativeObjectUnreference() 减回来,否则该 NativeWindow 永远不会释放。
正确的 surfaceDestroyed 清理示例:
void OnSurfaceDestroyedCB(OH_NativeXComponent* component, void* window) {
// 1. 通知渲染线程停止
render_->Stop();
renderThread_.join();
// 2. 释放 GPU 资源
glDeleteTextures(1, &textureId_);
glDeleteProgram(program_);
eglDestroySurface(eglDisplay_, eglSurface_);
eglDestroyContext(eglDisplay_, eglContext_);
eglTerminate(eglDisplay_);
// 3. 释放 NativeImage
if (nativeImage_) {
OH_NativeImage_Destroy(nativeImage_);
nativeImage_ = nullptr;
}
// 4. 释放像素缓冲区
if (pixelBuffer_) {
free(pixelBuffer_);
pixelBuffer_ = nullptr;
}
// 5. 配对减引用(如果之前加过)
if (nativeWindow_) {
OH_NativeWindow_NativeObjectUnreference(nativeWindow_);
nativeWindow_ = nullptr;
}
}
2. surfaceDestroyed 和 aboutToDisappear 谁先执行
surfaceDestroyed 先于 aboutToDisappear 执行。
官方文档对 onSurfaceDestroyed 的描述是"XComponent 组件被销毁时触发"(自定义渲染 XComponent),aboutToDisappear 是"自定义组件析构销毁之前执行"(自定义组件生命周期)。XComponent 组件销毁的过程中,先触发 Surface 生命周期回调释放渲染资源,再触发组件自身的 aboutToDisappear。你可以加日志验证:
class MyController extends XComponentController {
onSurfaceDestroyed(surfaceId: string): void {
console.info('surfaceDestroyed called');
nativeRender.DestroySurface(BigInt(surfaceId));
}
}
@Component
struct XComponentPage {
aboutToDisappear(): void {
console.info('aboutToDisappear called');
}
}
日志顺序应该是 surfaceDestroyed → aboutToDisappear。
3. 哪些情况 surfaceDestroyed 不被调用
根据官方文档和已知场景,以下情况 surfaceDestroyed 不会触发:
组件未上树或 Surface 未创建成功。 surfaceCreated 没触发过,surfaceDestroyed 自然也不会触发。常见于 XComponent 宽高为 0、visibility 为 None、或被父组件 visibility 隐藏的情况。
Native 侧使用 OH_ArkUI_SurfaceHolder 且 autoInitialize = true,但组件未下树就退出了。 官方文档说明 OnSurfaceDestroyed 的触发条件是"组件下树且 autoInitialize=true"(自定义渲染 XComponent)。如果 XComponent 是通过 NavDestination 等方式加载的,页面被 replace 而非 pop 时,组件可能未走正常下树流程。
应用被系统强杀或 crash。 进程直接没了,什么回调都不会触发。
使用老写法 libraryname 但 Native 侧未注册回调。 设置了 libraryname 后需要在 C 侧通过 OH_NativeXComponent_RegisterCallback 注册 OnSurfaceDestroyedCB,否则不会触发。
条件渲染切换时 id 重复导致异常。 反复用 if 条件渲染销毁重建 XComponent,如果 id 和上一次一样,会导致异常甚至闪退,回调可能不触发。官方 FAQ 给的方案是给 id 加随机后缀(重新初始化XComponent导致闪退)。
如果你怀疑 surfaceDestroyed 没被调用,先用 hilog 搜 XComponent 关键日志,确认 onSurfaceCreated 是否成功触发过、组件是否正常销毁。也可以用 DevEco Profiler 的 Native Heap 工具定位泄漏调用栈,确认到底是哪块内存没释放(开发态快速定位Native泄漏)。
心系天下
lorin在页面切换或组件销毁时,XComponent 的 onSurfaceDestroyed(或 Native 侧的 OnSurfaceDestroyed)会先于 ArkTS 组件的 aboutToDisappear 执行。
- 执行顺序:当组件从组件树移除时,系统会先触发 XComponent 的 Surface 销毁流程,执行
onSurfaceDestroyed回调。在该回调执行完毕后,才继续执行 ArkTS 自定义组件的aboutToDisappear生命周期函数。 - 工程实践建议:由于
onSurfaceDestroyed是组件销毁时调用的最后一个回调,它的执行标志着组件生命周期结束。因此,强烈建议将 Native 侧资源的释放逻辑(如释放 NativeWindow、EGL 上下文、纹理、缓冲区等)统一放在OnSurfaceDestroyed回调中。如果在aboutToDisappear中释放,可能会因为 Surface 已失效而导致底层资源释放失败或引发崩溃。
心态
大雷神surfaceDestroyed 只表示 XComponent 的 Surface 生命周期结束,不会自动释放你在 NAPI/C++ 中创建的纹理、像素缓冲区、EGL/Vulkan 对象或线程。C++ 申请的资源仍需由开发者显式释放;如果只释放了 Surface 句柄,进程的 native heap 当然不会回落。
aboutToDisappear 和 surfaceDestroyed 属于两套生命周期,不能依赖固定的先后顺序。页面路由返回、页面缓存、窗口切换、Surface 重建和应用退后台都可能产生不同的回调组合。建议把释放逻辑做成幂等操作,同时从 UI 生命周期和 Surface 生命周期触发:
aboutToDisappear:停止提交新帧、取消 JS/NAPI 异步任务,标记页面不再使用渲染器。surfaceDestroyed:解除 EGL/Vulkan/NativeWindow 与 Surface 的绑定,停止渲染线程对该 Surface 的访问。- 页面彻底销毁或业务主动退出时:释放纹理、缓冲区、同步对象和渲染线程,再销毁渲染器。
- Surface 重新创建时重新绑定,不要复用已经失效的 NativeWindow 指针。
可以把资源拆成“Surface 资源”和“渲染器资源”两层,并让两个回调都调用同一个清理入口:
class Renderer {
public:
void OnSurfaceCreated(void* window) {
std::lock_guard<std::mutex> lock(mutex_);
if (disposed_) {
return;
}
window_ = window;
CreateOrRecreateSurfaceResources();
}
void OnSurfaceDestroyed() {
std::lock_guard<std::mutex> lock(mutex_);
// 先阻止提交,再等待渲染线程退出当前帧。
rendering_ = false;
WaitRenderThreadLocked();
DestroySurfaceResourcesLocked();
window_ = nullptr;
}
void Dispose() {
std::lock_guard<std::mutex> lock(mutex_);
if (disposed_) {
return;
}
disposed_ = true;
rendering_ = false;
WaitRenderThreadLocked();
DestroySurfaceResourcesLocked();
DestroyTextureAndBufferResourcesLocked();
window_ = nullptr;
}
private:
void DestroySurfaceResourcesLocked(); // EGLSurface/VkSurface/NativeWindow 引用
void DestroyTextureAndBufferResourcesLocked(); // 纹理、buffer、fence、映射内存
void WaitRenderThreadLocked();
std::mutex mutex_;
void* window_ = nullptr;
bool rendering_ = false;
bool disposed_ = false;
};NAPI 层还要提供一个显式的 dispose(),在 ArkTS 的 aboutToDisappear 或业务销毁逻辑中调用。不要只依赖 napi_add_finalizer:JS 包装对象被 GC 的时间不确定,不能作为纹理和 GPU 资源的及时释放点。异步渲染任务要在 dispose() 中取消,并在回调执行前检查 disposed_,避免释放后又被旧任务重新创建资源。
排查是否真泄漏时,至少记录以下计数,而不是只看进程总内存:
- 每次
surfaceCreated/surfaceDestroyed的次数和对应的 Surface 标识。 - 创建和销毁的纹理、buffer、fence、EGL/Vulkan 对象数量,要求在页面退出后归零。
- 渲染线程是否已经退出,是否仍持有
NativeWindow或napi_ref。 - JavaScript 包装对象数量与 native 资源数量是否一一对应。
- 连续进入/退出页面 30 次,分别观察 native heap、GPU memory 和线程数;单次退出后缓存未立即归还给系统不一定是泄漏,但对象计数持续增长就是问题。
如果 surfaceDestroyed 没有触发,先确认组件实例是否真的被销毁:路由缓存、条件渲染仍为 true、窗口只是隐藏、Surface 被宿主复用时,组件可能仍然存活。此时应在 aboutToDisappear 主动停止业务渲染,并在重新 surfaceCreated 时恢复;对于页面彻底销毁场景,再由显式 dispose() 做最终兜底。
参考:XComponent 组件。
匿名用户厉害2026-09-09 23:15 来自北京
阿家- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
HarmonyOS 开启自动画中画后Xcomponent会被自动销毁(API12+)
HarmonyOS XComponent退出UI界面后,未正常回调OnSurfaceDestroyed (API12+)
HarmonyOS XComponent在ArkTS层的onSurfaceCreated跟C++层的有什么区别?(API12+)
HarmonyOS 开启自动画中画后xcomponent会被自动销毁 (API12+)
HarmonyOS NativeComponent销毁后会触发自定义的onSurfaceDestroyed回调,偶现访问野指针闪退(API12+)
HarmonyOS 使用XComponent导致内存泄漏 (API12+)
HarmonyOS 将NodeContainer持有的node缓存后,用node恢复页面,FrameNode内的子Component会重建 (API12+)
HarmonyOS 开启缓存后,使用NodeContainer/NodeController 创建的组件在屏幕可见区域外无法触发aboutToAppear (API12+)




































苏公安网备 32011402010933号