できない.dev

React「Maximum update depth exceeded」の原因と直し方

Maximum update depth exceeded は、Effect などで更新した state が次の更新を呼び続けると出る。
useEffect なら関数型 setState にして依存から state を外せば止まる。

公開: 更新:

症状できない
node bad_effect.js
console.error: Maximum update depth exceeded. This can happen when a component calls setState inside useEffect, but useEffect either doesn't have a dependency array, or one of the dependencies changes on every render.
1 秒後: 描画 51831 回 / 画面 "51830"
  同じエラーが 996 回: Maximum update depth exceeded. This can …

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

要約

Maximum update depth exceeded は、state の更新が次の更新を呼び、その連鎖が止まらないときに React が出すメッセージである。
React 19 のソース(ReactFiberWorkLoop.js)には次の 2 種類がある。

  • ... This can happen when a component calls setState inside useEffect, but useEffect either doesn't have a dependency array, or one of the dependencies changes on every render.: useEffect の中の更新が連鎖したときに出る警告である。
    開発ビルドでだけ console.error で出て、描画そのものは止まらない(下の実行例では 1 秒で 4 万回以上描画された)。
  • ... This can happen when a component repeatedly calls setState inside componentWillUpdate or componentDidUpdate.: コミット直後に同期で走る更新(componentDidUpdate など)が入れ子で続いたときのエラーである。
    こちらは例外として投げられ、描画が止まる。

似たメッセージの Too many re-renders. React limits the number of renders to prevent an infinite loop. は別のエラーである。
onClick={setOpen(true)} のようなハンドラの即時呼び出しや、コンポーネント本体(レンダー中)での setState で出るのはこちらで、対処は「Too many re-renders」の記事にまとめている。

実行例

node:20 のコンテナの jsdom 上で、依存配列に count を入れた Effect は 1 秒で 51831 回描画され、Maximum update depth exceeded. を出し続けた。
関数型の setState にすると描画は 2 回で止まり、onClick に関数を渡すとクリックした後にだけ表示が opened に変わる。

$ node bad_effect.js
console.error: Maximum update depth exceeded. This can happen when a component calls setState inside useEffect, but useEffect either doesn't have a dependency array, or one of the dependencies changes on every render.
1 秒後: 描画 51831 回 / 画面 "51830"
  同じエラーが 996 回: Maximum update depth exceeded. This can …
$ echo $?
0
$ node solve_effect.js
1 秒後: 描画 2 回 / 画面 "1"
$ echo $?
0
$ node bad_handler.js
console.error: Too many re-renders. React limits the number of renders to prevent an infinite loop.
An error occurred in the <Modal> component.
 
Consider adding an error boundary to your tree to customize error handling behavior.
Visit https://react.dev/link/error-boundaries to learn more about error boundaries.
 
1 秒後: 描画 52 回 / 画面 ""
  同じエラーが 1 回: Too many re-renders. React limits the nu…
$ echo $?
0
$ node solve_handler.js
クリック前: 描画 1 回 / 画面 "open"
1 秒後: 描画 2 回 / 画面 "opened"
$ echo $?
0

— 2026-10-31 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-10-31 検証(ほか 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. useEffect の依存から自分が更新する state を外す

// NG: count を依存に入れると更新で再実行が連鎖
useEffect(() => {
  setCount(count + 1);
}, [count]);
 
// OK: 関数型にして count を依存から外す
useEffect(() => {
  setCount(c => c + 1);
}, []);

そもそも Effect で state を更新する必要があるかも見直す。
外部のシステムと同期していないなら、Effect をやめて描画中の計算やイベントハンドラに移せることが多い。

2. 依存に入るオブジェクト・関数を安定させる

// NG: options は描画のたびに新しいオブジェクトになる
const options = { roomId };
useEffect(() => {
  setConfig(build(options));
}, [options]);
 
// OK: Effect の中で作り、プリミティブな値だけを依存にする
useEffect(() => {
  const options = { roomId };
  setConfig(build(options));
}, [roomId]);

Effect の外で作る必要があるなら useMemo / useCallback で参照を固定する。
考え方は Removing Effect Dependencies(新しいタブで開く) にある。

3. componentDidUpdate の setState は条件で囲む

componentDidUpdate(prevProps) {
  // OK: 値が変わったときだけ更新する
  if (this.props.roomId !== prevProps.roomId) {
    this.setState({ messages: [] });
  }
}

公式リファレンスも、componentDidUpdate の処理は prevProps / prevState と比べる条件で囲まないと無限ループになりうると書いている(Component – React(新しいタブで開く))。
useLayoutEffect で setState するときも、前回と値が違うときだけ更新する。

4. 「Too many re-renders」が出ている場合

コンソールのメッセージが Too many re-renders なら、原因はレンダー中の更新である。
ハンドラは呼び出した結果ではなく関数を渡す。

// NG: レンダーのたびに setOpen(true) が実行される
<button onClick={setOpen(true)}>open</button>
 
// OK: 関数を渡す
<button onClick={() => setOpen(true)}>open</button>

コンポーネント本体で直接 setState している場合も同じエラーになる。
詳しくは「Too many re-renders」の記事と useState のトラブルシューティング(新しいタブで開く)を参照する。

よくある原因

  1. useEffect が自分の更新で再実行され続けている。
    Effect の中で更新する state を依存配列に入れている。
    更新 → 再描画 → 依存が変わる → Effect が再実行、が繰り返される。
    依存配列を書いていない Effect で setState しても同じことが起きる。
  2. 依存が毎回変わる。
    依存配列に、描画のたびに新しく作られるオブジェクトや関数が入っている。
    中身が同じでも参照が変わるので、Effect が毎回走って setState する。
  3. コミット直後に無条件で更新している。
    クラスコンポーネントの componentDidUpdate(や useLayoutEffect)で条件なしに setState している。
    更新のたびに再びこの処理が走り、入れ子の更新が上限を超える。

公式ドキュメントも、Effect が無限に再実行されるのは「Effect が state を更新し、その再描画で Effect の依存が変わる」ときだと説明している(useEffect – React(新しいタブで開く))。