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 pipe | HTML 模板綁定 | 框架層級自動管理訂閱與退訂 | 僅適用於模板渲染,無法用於純 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();
}
}

圖: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);
});
}
}

圖: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 是不同的規則。
發佈留言