文档开发者中心
我的
|

HarmonyOS

XComponent 切换页面销毁后,NAPI 创建的纹理、缓冲区内存没有释放,咋回事

我在 XComponent 的 surfaceCreated 里面通过 NAPI 创建了外部纹理和像素缓冲区,当退出页面触发 surfaceDestroyed 回调。内存观测发现这部分原生内存并没有回落,我怀疑资源泄漏。

XComponent 的 surfaceDestroyed 回调触发时机和组件 aboutToDisappear 谁先执行?

哪些情况会出现 surfaceDestroyed 不被调用?

点赞
1
收藏
回复
10
分享
举报
浏览109 发布于2026-09-09 15:05北京
全部评论
最多点赞
最新发布
最早发布
|
技术支持
OnSurfaceDestroyed回调的触发时刻:组件下树且autoInitialize=true 或者调用OH_ArkUI_XComponent_Finalize后触发。aboutToDisappear在自定义组件析构销毁之前执行。组件销毁的流程是:先执行 aboutToDisappear(自定义组件销毁前回调)→ 组件开始从组件树卸载(下树)→ 下树过程中 XComponent 的 Surface 被销毁并触发 surfaceDestroyed。
surfaceDestroyed 不被调用的情况有:
1.页面/组件未真正销毁
2.应用切后台/熄屏
3.Surface没有被成功创建
11楼回复于2026-09-11 07:35 来自广东

这通常不是 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 是否仍有引用。

9楼回复于2026-09-10 01:47 来自广东

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 不立刻下降还不能证明泄漏。

10楼回复于2026-09-10 04:06 来自四川

内存不回落大概率不是泄漏,是没在回调里主动释放 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泄漏)。

展开全部
8楼回复于2026-09-10 01:16 来自四川
一、surfaceDestroyed vs aboutToDisappear 执行顺序
aboutToDisappear 先执行,surfaceDestroyed 后执行。 时序为:
aboutToDisappear → surfaceDestroyed → 组件析构
所以如果你把释放逻辑只放在  surfaceDestroyed ,而  aboutToDisappear  里不做清理,一旦  surfaceDestroyed  不被触发,就泄漏。
二、surfaceDestroyed 不被调用的场景
场景原因页面路由动效未结束就退出 NavPathStack.pop()  时转场动画未完成,Surface 未销毁但组件已回收XComponent 被动态移除用  if/else  条件渲染移除 XComponent,不经正常销毁流程进程被强杀系统回收进程,回调根本不会触发异常退出(crash/JS异常)ArkTS 帧循环中断,回调链断裂窗口隐藏而非销毁应用退后台( onBackground ),Surface 隐藏但不销毁, surfaceDestroyed  不触发
三、为什么你观测到原生内存没回落
你只依赖  surfaceDestroyed  释放纹理/缓冲区,但:
1.  surfaceDestroyed  不一定被调用(上表情况)。
2. 即使调了,NAPI 侧  napi_create_external  创建的纹理或 native 缓冲区如果没正确解绑( EGLImage  /  OH_NativeBuffer  引用没释放),native 资源不会被 OS 回收。
3. XComponent 的 Surface 和 NAPI 创建的资源是两套生命周期:Surface 销毁 ≠ NAPI 资源自动释放。
四、正确释放策略(三保险)
aboutToDisappear → 主清理 (第一道防线)
surfaceDestroyed → 二次兜底 (第二道防线)
napi_finalize → 最终兜底 (第三道防线, NAPI 对象被GC时)
具体做法:
1.  aboutToDisappear  中主动调用 NAPI 释放接口( napi_call_function  调 native  Release() ),不等待  surfaceDestroyed 。
2.  surfaceDestroyed  中做二次判断:如果资源还没释放,再尝试释放。
3. NAPI 侧用  napi_create_external  时绑定  finalize_cb ,作为最后兜底——即使 JS 层没调释放,GC 回收 NAPI 包装对象时也能释放 native 资源。
4. 释放顺序:先解绑纹理绑定 → 再释放 PixelMap/NativeBuffer → 最后销毁 EGL Context 相关资源。
别只依赖  surfaceDestroyed ,以  aboutToDisappear  作为主释放时机,NAPI 的 finalize 做最终兜底,三保险才不会漏。
展开全部
6楼回复于2026-09-10 00:12 来自陕西

在页面切换或组件销毁时,XComponent 的 onSurfaceDestroyed(或 Native 侧的 OnSurfaceDestroyed)会先于 ArkTS 组件的 aboutToDisappear 执行。

  • 执行顺序:当组件从组件树移除时,系统会先触发 XComponent 的 Surface 销毁流程,执行 onSurfaceDestroyed 回调。在该回调执行完毕后,才继续执行 ArkTS 自定义组件的 aboutToDisappear 生命周期函数。
  • 工程实践建议:由于 onSurfaceDestroyed 是组件销毁时调用的最后一个回调,它的执行标志着组件生命周期结束。因此,强烈建议将 Native 侧资源的释放逻辑(如释放 NativeWindow、EGL 上下文、纹理、缓冲区等)统一放在 OnSurfaceDestroyed 回调中。如果在 aboutToDisappear 中释放,可能会因为 Surface 已失效而导致底层资源释放失败或引发崩溃。
5楼回复于2026-09-10 00:00 来自广东
哦
3楼回复于2026-09-09 19:47 来自山东

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_,避免释放后又被旧任务重新创建资源。

排查是否真泄漏时,至少记录以下计数,而不是只看进程总内存:

  1. 每次 surfaceCreated/surfaceDestroyed 的次数和对应的 Surface 标识。
  2. 创建和销毁的纹理、buffer、fence、EGL/Vulkan 对象数量,要求在页面退出后归零。
  3. 渲染线程是否已经退出,是否仍持有 NativeWindow 或 napi_ref。
  4. JavaScript 包装对象数量与 native 资源数量是否一一对应。
  5. 连续进入/退出页面 30 次,分别观察 native heap、GPU memory 和线程数;单次退出后缓存未立即归还给系统不一定是泄漏,但对象计数持续增长就是问题。

如果 surfaceDestroyed 没有触发,先确认组件实例是否真的被销毁:路由缓存、条件渲染仍为 true、窗口只是隐藏、Surface 被宿主复用时,组件可能仍然存活。此时应在 aboutToDisappear 主动停止业务渲染,并在重新 surfaceCreated 时恢复;对于页面彻底销毁场景,再由显式 dispose() 做最终兜底。

参考:XComponent 组件。

展开全部
1
2楼回复于2026-09-09 15:56 来自湖北
  • 匿名用户匿名用户
    厉害
    2026-09-09 23:15 来自北京
C++申请的内存,开发者管理释放
1楼回复于2026-09-09 15:07 来自北京
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。