できない.dev

React「Too many re-renders」の原因と直し方

Too many re-renders は、レンダリング中に state を無条件で更新すると出る。
onClick={handleClick()} のような即時実行をやめ、更新はイベントハンドラか useEffect に移せば直る。

公開: 更新:

症状できない · exit 1
node bad.js
…
    throw fatalError;
    ^
Error: Too many re-renders. React limits the number of renders to prevent an infinite loop.
解決後できた · exit 0
node solve_guard.js
<p>x</p>

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

要約

Too many re-renders. React limits the number of renders to prevent an infinite loop. は、レンダリングの最中に state を無条件で更新しているサインだ。

更新がレンダーを呼び、そのレンダーがまた更新を呼ぶ――この往復が止まらず、React が安全装置として打ち切っている。

もっとも多いのは、イベントハンドラの渡し方ミスだ。

実行例

レンダー中に条件なしで setState を呼ぶコンポーネントは、サーバー側のレンダリングでも Too many re-renders. React limits the number of renders to prevent an infinite loop. で停止し、スタックの先頭が dispatchAction になる。
派生値をレンダー中に計算する形と、更新前に値を比べてから呼ぶ形は、いずれも終了コード 0 で HTML を出力する。

$ node bad.js
/tmp/tmp.d9ULxaF6yT/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6995
    throw fatalError;
    ^
 
Error: Too many re-renders. React limits the number of renders to prevent an infinite loop.
    at dispatchAction (/tmp/tmp.d9ULxaF6yT/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:5169:11)
    at App (/tmp/tmp.d9ULxaF6yT/bad.js:7:3)
    at finishHooks (/tmp/tmp.d9ULxaF6yT/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:4964:16)
    at renderWithHooks (/tmp/tmp.d9ULxaF6yT/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:5663:10)
    at renderIndeterminateComponent (/tmp/tmp.d9ULxaF6yT/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:5736:15)
    at renderElement (/tmp/tmp.d9ULxaF6yT/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:5961:7)
    at renderNodeDestructiveImpl (/tmp/tmp.d9ULxaF6yT/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6119:11)
    at renderNodeDestructive (/tmp/tmp.d9ULxaF6yT/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6091:14)
    at retryTask (/tmp/tmp.d9ULxaF6yT/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6543:5)
    at performWork (/tmp/tmp.d9ULxaF6yT/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6591:7)
 
Node.js v20.20.2
$ echo $?
1
$ node solve_derive.js
<p>0</p>
$ echo $?
0
$ node solve_guard.js
<p>x</p>
$ echo $?
0

— 2026-11-03 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-11-03 検証(ほか 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 18.3.1

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

解決策

1. ハンドラは「関数参照」で渡す

呼び出しの丸括弧を外し、引数が必要ならアロー関数で包む。

// NG: レンダー中に実行されてしまう
<button onClick={handleClick()}>送信</button>
 
// OK: 関数そのものを渡す
<button onClick={handleClick}>送信</button>
 
// OK: 引数つきはアローで包む
<button onClick={() => handleClick(id)}>送信</button>

2. レンダー中に setState しない

状態更新はイベントハンドラか useEffect の中だけで行う。
レンダー本体は「描く」だけに保つ。

3. 派生値は計算で求める

ほかの state から導ける値は、新しい state にせず毎回計算する。
重いときだけ useMemo を挟む。

const fullName = `${first} ${last}`; // setState しない

どうしてもレンダー中に更新が要る稀なケースは、if (prev !== next) のように条件で囲み、ループを断ち切る。

よくある原因

  1. onClick={handleClick()} のように関数を即時実行で渡している。
    返り値(多くは undefined)がハンドラになり、レンダーのたびに handleClick が走る。
  2. コンポーネント本体で条件なしに setState を呼んでいる。
  3. 表示用の派生値を作るためにレンダー中で setState している。
  4. useEffect の依存配列を付け忘れ、毎レンダーで state を更新している。