HarmonyOS鸿蒙Next中内存泄漏排查—事件监听未注销、闭包持有this

import { preferences } from '@kit.ArkData';

// 伪代码：优雅的缓存管理器

export class UserConfigManager {
  private static instance: UserConfigManager;
  // 内存轻量级缓存
  private memoryCache: Map<string, object> = new Map();

  public static getInstance(): UserConfigManager {
    if (!UserConfigManager.instance) {
      UserConfigManager.instance = new UserConfigManager();
    }
    return UserConfigManager.instance;
  }

  // 获取数据：内存有读内存，没有则读闪存并回填
  async getConfig(key: string): Promise<object | undefined> {
    if (this.memoryCache.has(key)) {
      return this.memoryCache.get(key);
    }
    // 伪代码：从 Preferences 闪存中读取
    let value = await this.readFromDisk(key);
    if (value) {
      // 限制内存缓存大小，超过阈值可以做 LRU 淘汰
      if (this.memoryCache.size > 20) {
        let firstKey = this.memoryCache.keys().next().value;
        this.memoryCache.delete(firstKey); // 淘汰最旧的
      }
      this.memoryCache.set(key, value);
    }
    return value;
  }

  // 内存水位过高或收到系统低内存通知时，清空内存缓存（闪存里依然有）
  clearMemory() {
    this.memoryCache.clear();
  }

  private async readFromDisk(key: string): Promise<object> { /* ... */ return {}; }
}

我觉得不要把清理逻辑放在 ApplicationStage.onTerminate()。

原因很简单，HarmonyOS 下应用被系统回收、异常退出或者后台被杀时，onTerminate() 并不一定会执行，所以它更适合作为兜底，而不是核心清理方案。

实际项目里一般会这样处理：

• AppStorage 只存全局状态
  • 用户信息
  • 登录态
  • 主题配置
  • 应用配置
• 大对象尽量不要长期挂在 AppStorage
  • 大列表数据
  • 图片缓存
  • 大型 Map
  • 页面临时数据

这些数据通常放到对应 Store 或单例管理类里。

页面退出时主动释放：

aboutToDisappear() {
  this.list = [];
  this.cacheMap.clear();
  this.listener?.off();
}

另外从你描述的现象：

• 长时间使用越来越卡
• HeapSnapshot 持续增长

经验上更应该优先排查：

• emitter/on 监听未 off
• commonEvent 订阅未取消
• setInterval 未 clear
• WebView 持有页面引用
• Promise 回调闭包持有 this
• 单例对象持有页面实例

这些问题比 AppStorage 导致内存泄漏的概率高得多。

建议你先用 HeapSnapshot 看看增长最多的是哪类对象：

• 如果大量是页面实例、组件实例、ObservedV2 对象，基本是引用链没断开。
• 如果大量是 Array、Map、Object，才重点检查缓存和 AppStorage。

我的经验是：

AppStorage 放用户信息、配置这种全局对象没什么问题，但不要把几十 MB 的业务数据长期塞进去，更不要指望在 onTerminate 里统一清理。

希望能帮到你~~~