紀錄工作經驗、相關知識,解決技術相關問題。

Javascript, 網站優化

RxJS memory leak unsubscribe takeUntil 記憶體流失排查與生命週期管理實務

RxJS memory leak unsubscribe takeUntil 記憶體流失排查與生命週期管理實務 特色圖片

RxJS memory leak unsubscribe takeUntil 是 RxJS 專案常見的排查主題。

在前端專案中引入響應式程式設計(Reactive Programming)時,非同步資料流帶來的靈活性往往伴隨著潛在的記憶體流失 (Memory Leak) 風險。

當開發者在元件、服務或全域事件監聽中建立 Observable 訂閱(Subscription)卻未在適當的生命週期進行清理時,底層的記憶體配置將無法被垃圾回收機制(Garbage Collection)釋放。

這不僅會造成瀏覽器效能漸進式下降,還會引發 DOM 節點殘留、重複觸發回呼函式(Callback)以及非預期的記憶體耗盡。

想了解 Observable 訂閱的基礎原理可前往 RxJS Observable vs Promise 差異:非同步資料流與單次請求的抉擇 觀看。

本文將剖析記憶體流失的核心成因,並提供現代前端專案中的標準生命週期管理架構。

一、 核心速查與常見瓶頸對照

在處理非同步串流時,若未妥善管理訂閱狀態,將導致嚴重的記憶體耗損。以下為常見的錯誤寫法與解法對照。

1. 常見錯誤寫法的工程瓶頸

  • 元件銷毀未退訂:在 ngOnInit 或 useEffect 中直接執行 subscribe() 卻未保留 Subscription 實例,當元件從畫面上卸載時,事件監聽器與記憶體參考依然存在。
  • Hot Observable 持續發送:連接至全域服務(Service)或 WebSocket 的串流若未主動中斷,會持續佔用記憶體並造成記憶體流失。
  • 巢狀訂閱未清理:在內部訂閱中又包覆另一層 subscribe(),導致多重參考無法釋放,增加記憶體洩漏的排查難度。

2. 核心機制規格對照表

清理策略適用場景優點限制與注意事項
手動 unsubscribe簡單元件、獨立函式邏輯直觀、控制精準需要維護多個 Subscription 變數或陣列,程式碼較為繁瑣
takeUntil + Subject傳統 Angular / 複合元件生命週期結束時自動攔截takeUntil 應放在 pipe 的最後一個位置,並確認 Subject 的觸發時機
takeUntilDestroyed現代 Angular 16+自動注入生命週期,免手動維護依賴 Injection Context,非建構子使用需傳入 DestroyRef
async pipeHTML 模板綁定框架層級自動管理訂閱與退訂僅適用於模板渲染,無法用於純 TypeScript 邏輯處理

二、 關鍵機制解析:底層規範與注意事項

當 Observable 執行 subscribe() 時,資料來源會建立一個針對該訂閱者的參考(Reference)。若該串流屬於無限序列(例如 interval、fromEvent 或自定義的 Subject),只要沒有觸發 complete 或執行 unsubscribe(),JavaScript 引擎的垃圾回收器便無法回收該作用域中的變數與閉包(Closure)。

在大型應用程式中,這種狀況會隨著使用者在不同頁面與元件之間切換而累積,最終導致記憶體佔用持續攀升。因此,掌握事件生命週期的終止點是維持系統穩定性的關鍵。

水龍頭持續注水到水盆,比喻未退訂的無限序列持續佔用記憶體

圖:以水龍頭未關比喻無限序列未退訂,示意圖。


三、 實作範本:生產環境完整程式碼

以下提供兩個在生產環境中常見的標準實作範本,分別對應傳統手動生命週期管理與現代框架的自動化串流清理。

範本一:使用 takeUntil 結合 Subject 進行元件銷毀清理

import { Component, OnInit, OnDestroy } from '@angular/core';
import { Subject, interval, takeUntil } from 'rxjs';

@Component({
  selector: 'app-data-stream',
  template: `<div>資料串流監控中...</div>`
})
export class DataStreamComponent implements OnInit, OnDestroy {
  // 元件銷毀時發出訊號的通知用 Subject
  private destroy$ = new Subject<void>();

  ngOnInit(): void {
    interval(1000)
      .pipe(
        takeUntil(this.destroy$)
      )
      .subscribe({
        next: (value) => console.log('收到資料:', value),
        error: (err) => console.error('發生錯誤:', err)
      });
  }

  ngOnDestroy(): void {
    // 發送完成訊號並關閉 Subject
    this.destroy$.next();
    this.destroy$.complete();
  }
}
Node.js 22 執行 takeUntil 範本邏輯的終端輸出:銷毀後筆數維持 3,未退訂對照持續增加至 7

圖:Windows 11、Node.js 22、rxjs 7.8.2 的終端輸出;此為範本一的 interval 與 takeUntil 邏輯,元件裝飾器以純類別代替。

範本二:使用現代 Angular 的 takeUntilDestroyed 與 DestroyRef

import { Component, DestroyRef, inject, OnInit } from '@angular/core';
import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
import { interval } from 'rxjs';

@Component({
  selector: 'app-modern-stream',
  template: `<div>現代響應式串流管理</div>`
})
export class ModernStreamComponent implements OnInit {
  private destroyRef = inject(DestroyRef);

  ngOnInit(): void {
    interval(1000)
      .pipe(
        // 在非建構子階段使用時,明確傳入 destroyRef
        takeUntilDestroyed(this.destroyRef)
      )
      .subscribe((value) => {
        console.log('自動退訂數值:', value);
      });
  }
}
Node.js 22 執行 takeUntilDestroyed 與 DestroyRef 的終端輸出,含注入情境外未傳 destroyRef 的 NG0203 錯誤

圖:Windows 11、Node.js 22、@angular/core 21.2.26、rxjs 7.8.2 的終端輸出;以 createEnvironmentInjector 取得 DestroyRef,env.destroy() 後串流停止。


四、 常見問題與排錯(Q&A)

Q1:為什麼長期執行的 Observable 就算元件已經被銷毀仍會保留在記憶體中?

  • 問題原因:當 Observable 開始執行時,訂閱者(Observer)與發行者(Producer)之間會建立強參考。如果該串流未在元件銷毀時呼叫 unsubscribe() 或觸發 complete(),訂閱的回呼函式與閉包仍被串流持有,可能一路連到該元件的執行實例,導致記憶體流失。
  • 解法:在元件生命週期結束時(例如 ngOnDestroy 或 React 的 useEffect 清理函式),呼叫對應的 unsubscribe() 或使用操作符自動中斷串流。

Q2:takeUntil 搭配 ngOnDestroy 時,應該放在 pipe 的哪個位置?

  • 問題原因:takeUntil 之後如果還接了其他運算子(例如 switchMap),這些運算子產生的內部串流不會被 takeUntil 中斷,仍可能殘留訂閱。eslint-plugin-rxjs 的 no-unsafe-takeuntil 規則,就是用來禁止在 takeUntil 之後再套用運算子。
  • 解法:把 takeUntil(this.destroy$) 放在 pipe 的最後一個位置,並在 ngOnDestroy 中先呼叫 next() 再呼叫 complete()。

Q3:使用 take(1) 或 first() 操作符是否能完全取代顯式 unsubscribe 以防堵記憶體流失?

  • 問題原因:針對只會發送一次資料便自動完成的請求(例如 HTTP 請求),take(1) 或 first() 會在收到第一筆資料後自動發送 complete,這確實能防止記憶體流失。但若串流在發出第一筆資料前元件就被銷毀,或串流本身屬於無限序列且條件未達成,則依然會造成記憶體洩漏。
  • 解法:針對單次請求可安全使用 take(1);但若為持續性事件流,仍必須搭配 takeUntil 或明確的生命週期管理。

Q4:現代 Angular 注入情境下,takeUntilDestroyed 如何在非建構子(Constructor)階段正確運作?

  • 問題原因:takeUntilDestroyed() 預設需要依賴當前的 Injection Context(例如在建構子或欄位初始化階段)。如果在 ngOnInit 或非注入上下文中直接呼叫,會拋出找不到注入環境的錯誤。
  • 解法:在類別層級宣告 private destroyRef = inject(DestroyRef);,並在需要的位置明確傳入該參考:takeUntilDestroyed(this.destroyRef)。

Q5:為什麼在 HTML 模板中使用 async pipe 可以自動避免 RxJS 訂閱造成的記憶體流失?

  • 問題原因:手動在程式碼中寫 subscribe() 會建立需要開發者自行維護的訂閱實例。
  • 解法:async pipe 在內部封裝了訂閱與退訂的邏輯。當模板被渲染時,它會自動呼叫 subscribe();當元件被銷毀或模板被移除時,async pipe 會自動執行 unsubscribe(),從根本上避免了手動處理可能帶來的疏漏。

Q6:如何在大型企業級專案中透過 ESLint 規則自動檢測未退訂的 RxJS 串流?

  • 問題原因:大型團隊開發中,人工檢視 Code Review 難以完全杜絕人為疏忽所導致的未退訂問題。
  • 解法:在專案中引入 eslint-plugin-rxjs 外掛,並啟用 rxjs/no-unsafe-takeuntil(禁止在 takeUntil 之後套用運算子)與 rxjs/no-ignored-subscription(禁止忽略 subscribe 回傳的 Subscription)等規則,透過靜態程式碼分析在編譯或 CI/CD 階段自動攔截未處理的訂閱。

補充說明:no-ignored-subscribe 檢查的是呼叫 subscribe 時有沒有傳入參數,和是否保留 Subscription 是不同的規則。


參考資料與延伸閱讀

發佈留言