fetchとTanStack Queryの使い分け

同じ機能をシンプルな fetch と TanStack Query の両方で書いたので、ここでどちらをどう選べばよいかを整理します。片方が万能というわけではなく、規模や画面数によって答えが変わります。

まず判断軸ごとの向き不向きを表にまとめます。

判断軸 シンプルな fetch が向く TanStack Query が向く
画面数 1〜2画面のシンプルなアプリケーションで完結する 複数画面で同じデータを共有する必要がある
データの更新頻度 初回1回だけ取得すれば十分な静的データを扱う 頻繁に更新され、他ユーザの変更も反映したい
キャッシュの必要性 毎回サーバに問い合わせても問題ない 同じデータの再取得を減らして体感速度を上げたい
コード量 1画面あたり数十行で収まる 状態管理コードを繰り返し書きたくない
チーム開発 個人プロジェクトや学習用途で使う 複数人が共通の書き方でデータ取得を書きたい

Next.js特有の視点も加えておきます。App RouterではServer Componentから直接データを取得できるため、SEOに載せたい・初期表示を速くしたい画面はServer Component側で fetch するのが第一選択になります。一方で、ボタン操作で更新が走るような 画面内の対話 は、どうしてもClient Componentで扱う場面が多くなり、そこでは TanStack Query が効きやすくなります。

まとめると、以下のような使い分けの目安になります。

  • 最初に扱うときはシンプルな fetch で仕組みを掴む
  • 画面や機能が増えて「同じ取得コードを何度も書いている」「更新後の再取得ロジックが散らばっている」と感じ始めたら TanStack Query に切り替える
  • Server Componentで賄える画面はまずServer Componentで書き、対話が必要な部分だけClient Component + TanStack Query に切り出す

「先にすべて TanStack Query で書く」よりも、シンプルな fetch で書き始めて痛みが出てから乗り換える方が、TanStack Query が解決している課題も体感でき、書き方の違いも身につきます。