document.writeln('');

在開發 next.js 應用程序時,與 firestore 數據庫交互是常見需求。然而,開發者有時會遇到一個困擾:即使代碼邏輯旨在獲取單個 firestore 文檔,實際的數據庫讀取次數卻遠超預期,這不僅可能增加 firestore 的計費成本,還可能影響應用性能。本教程將剖析這一現象背后的原因,并提供一套系統的解決方案和最佳實踐。
首先,我們需要明確一個關鍵概念:在 Firestore 中,“獲取一個文檔”并不等同于“一次讀取計費”。Firestore 的計費模型更為復雜,涉及多個內部操作。例如,當您請求一個文檔時,Firestore 可能需要執行以下步驟,每個步驟都可能計入讀取次數:
因此,即使在理想情況下,一次邏輯上的“文檔獲取”也可能轉化為 Firestore 計費系統中的多次操作。當出現多次讀取時,問題往往出在數據獲取函數被重復調用。
在 Next.js 應用中,導致 Firestore 數據獲取函數(如 getVehicle)被重復調用的主要原因有以下幾點:
在 Next.js 的開發模式下,為了提供更好的開發體驗,會啟用一些特性,可能導致組件被多次渲染或掛載:
當數據獲取邏輯直接放置在組件內部或在每次渲染時都被調用時,這些機制就會導致 getVehicle() 被多次執行。
Next.js 13 及更高版本引入了 generateMetadata 函數,用于在服務器端生成頁面的 <head> 標簽內容(如標題、描述等)。這個函數與頁面的主組件是獨立執行的。
考慮以下代碼結構:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 |
|
在上述示例中,getVehicle(vehicleid) 在 generateMetadata 函數中被調用一次,又在 VehicleGroup 組件中被調用一次。這意味著即使是同一個頁面,同一個文檔,也會被請求兩次,導致兩次 Firestore 讀取。
為了減少不必要的 Firestore 讀取,我們可以采取以下優化策略:

使用 Google Admin SDK API 管理 Google Workspace 用戶、群組、域名、設備及管理員目錄數據。當用戶需要列出并管理這些資源時,可使用此技能。
對于 Next.js 13+ 的服務器組件,Next.js 提供了內置的請求去重機制,但它主要針對原生的 fetch API。對于 firebase/firestore 這樣的第三方庫,我們需要手動實現去重或緩存。
自定義內存緩存:可以實現一個簡單的內存緩存,在單個請求生命周期內存儲已獲取的數據。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 |
|
注意: 這種簡單的 Map 緩存只在服務器端運行,并且在每次請求開始時應該被清除(或者使用更復雜的 LRU 緩存策略)。在 Next.js 的 App Router 中,每個請求都會有一個獨立的模塊實例(或者在同一個請求中,模塊級別的變量會共享),因此這種簡單 Map 可以在單個請求的生命周期內有效去重。
使用 React Query 或 SWR:對于客戶端組件的數據獲取,使用像 React Query 或 SWR 這樣的數據獲取庫可以提供強大的緩存、去重、重試和后臺更新功能,極大地簡化數據管理。
如果同一個數據需要在頁面的不同部分(如主組件和元數據)使用,最佳實踐是在一個地方獲取數據,然后將其傳遞下去。
在布局組件中獲取:如果數據對整個頁面布局都重要,可以在父級 layout.js 中獲取數據,并通過 props 或 context 傳遞給子組件和 generateMetadata。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
|
注意: 在 generateMetadata 和 VehicleLayout 中都調用 getVehicle,但如果 getVehicle 內部實現了請求去重(如上述的 cachedGetter),那么實際的 Firestore 讀取仍然只會發生一次。
如果數據獲取發生在客戶端組件中,確保它只在必要時運行:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
|
在服務器組件中,直接 await 異步函數即可,Next.js 會處理好渲染和數據流。
如果問題仍然存在,以下調試技巧可能會有所幫助:
Firestore 的計費模型和 Next.js 的渲染機制共同構成了數據獲取的復雜性。要有效管理 Firestore 讀取次數,關鍵在于:
通過采納這些策略,您將能夠更有效地管理 Firestore 讀取,優化 Next.js 應用的性能,并降低云服務成本。