できない.dev

React の useEffect で無限ループが止められない

useEffect の無限ループは、依存配列をプリミティブに絞り、useMemo / useCallback で参照を安定させれば止まる。
Effect 内で更新する state は関数型 setState で依存から外す。

公開: 更新:

症状できない
node bad_object_dep.js
500ms 後: fetch 27195 回 / 描画 27196 回

2026-10-19 に node:20(React 19.3.1 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細

要約

useEffect の無限ループは 依存配列に毎レンダリングで参照が変わる値が含まれている か、Effect 内で setState した値そのものを依存に入れている のが主な原因である。
プリミティブに絞る、useMemo / useCallback で参照を安定化する、関数型 setState で依存を切る、の 3 手で大半は止まる。

実行例

node:20 のコンテナで jsdom 上に描画し、500 ミリ秒のあいだに fetch が何回呼ばれるかを数えた。
依存配列に毎回新しいオブジェクトを入れた版は 27195 回、依存配列を省略した版は 29102 回呼ばれて止まらなかった。
依存を id のようなプリミティブにした版と useMemo で参照を安定させた版は、どちらも 1 回で、描画は 2 回で落ち着いた。

$ node bad_object_dep.js
500ms 後: fetch 27195 回 / 描画 27196 回
$ node bad_no_deps.js
500ms 後: fetch 29102 回 / 描画 29103 回
$ node solve_primitive.js
500ms 後: fetch 1 回 / 描画 2 回
$ node solve_memo.js
500ms 後: fetch 1 回 / 描画 2 回

— 2026-10-19 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-10-19 検証(ほか 2 件)
検証日
実行環境
node:20 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 20.20.2
  • npm 10.8.2
  • Python 3.11.2
  • Git 2.39.5
  • React 19.3.1

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. プリミティブに分解する

// NG
useEffect(() => {
  fetchUser(user);
}, [user]); // user は毎回新しいオブジェクト
 
// OK
useEffect(() => {
  fetchUser({ id: userId });
}, [userId]); // 文字列で安定

公式の useEffect リファレンス(新しいタブで開く) でも、依存にはプリミティブを使うよう勧めている。

2. useMemo / useCallback で参照を安定化

const options = useMemo(() => ({ a, b }), [a, b]);
const handleClick = useCallback(() => doIt(id), [id]);
useEffect(() => {
  subscribe(options, handleClick);
}, [options, handleClick]);

3. 関数型 setState で依存を切る

// NG: count を依存に入れる必要が出てしまう
useEffect(() => {
  const t = setInterval(() => setCount(count + 1), 1000);
  return () => clearInterval(t);
}, [count]);
 
// OK: 関数型なら count が依存から外せる
useEffect(() => {
  const t = setInterval(() => setCount(c => c + 1), 1000);
  return () => clearInterval(t);
}, []);

4. Strict Mode の二重実行と切り分ける

開発モードでは <React.StrictMode>(新しいタブで開く) 配下の Effect が、仕様としてマウント時に 2 回走る。
これは無限ではないので、コンソール出力が「初回 2 回だけ」なら別問題と判断する。

よくある原因

  1. オブジェクト・配列・関数リテラルを依存に入れている。
    useEffect(() => {...}, [{ id: 1 }]) のような書き方は毎レンダリングで新しい参照になり、必ず再実行される。
  2. setState した値を依存にしている。
    Effect 内で setCount(count + 1) のように更新し、[count] を依存に置くと自己再起ループする。
  3. 依存配列を渡し忘れている。
    useEffect(() => {...}) と書くと毎レンダリングで実行されるので、中で state を更新すれば即無限ループになる。
  4. 親から渡る props の参照が毎回新しい。
    親が <Child options={{ a: 1 }} /> のようにレンダリングのたびに新しいオブジェクトを渡してくる。