ReactでToo many re-rendersが出る原因と直し方

​​React​TypeScript,useState,Vite,トラブルシュート

React で Too many re-renders というエラーが出るのは、レンダーの途中で state を変えているためです。よくある原因は onClick={setCount(1)} のように、クリックで呼ぶはずの関数を、その場で呼んでしまう書き方です。onClick={() => setCount(1)} と関数を渡す形に直すと、エラーは消えます。

私は検証環境でこのエラーをわざと起こし、ブラウザーのコンソールに出た文と、直したあとに消えることを確かめました。検証環境では、ボタンを押していないのに、ページを開いただけで画面が真っ白になりました。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4 です。npm create vite@latest の react-ts テンプレートで作ったプロジェクト(react / react-dom 19.3.1、Vite 8.3.7、TypeScript 7.0.2、oxlint 1.93.0)で、コンポーネントを StrictMode で囲んで試しました。ページは Chromium 153 を Playwright 1.63.0 で操作して開き、DevTools の画面は、画面ありの Chromium を仮想ディスプレイ(Xvfb)で動かして撮りました。Next.js などのフレームワークの開発サーバーや、Chromium 以外のブラウザーでの表示は試していません。

開発中のコンソールに出たメッセージ

次のコンポーネントを開発サーバー(npm run dev と同じ vite)で開くと、ボタンを押す前にエラーになりました。

tsx
import { useState } from 'react';

// まちがい:setCount(1) を「呼んだ結果」を onClick に渡している
export default function BadOnClick() {
  const [count, setCount] = useState(0);
  return (
    <div>
      <p>count: {count}</p>
      <button onClick={setCount(1)}>1にする</button>
    </div>
  );
}

コンソールには、React DevTools の案内のほかに、エラーと警告が1件ずつ出ました。DevTools のコンソールでは、エラーは次のように表示されます。

text
Uncaught Error: Too many re-renders. React limits the number of renders to prevent an infinite loop.

続く警告は次の文です。エラーが起きたコンポーネントの名前(ここでは <BadOnClick>)が入っています。

text
An error occurred in the <BadOnClick> 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.
DevTools のコンソールに、赤い行で「Uncaught Error: Too many re-renders.」、黄色い行で「An error occurred in the <BadOnClick> component.」が出ている。上のページの部分は何も表示されていない
まちがった書き方のページを開いたところ。ページは真っ白で、コンソールにエラーと警告が1件ずつ出た

ページのほうには、エラーの文は出ませんでした。コンポーネントを入れる <div id="root"> の中が空になり、画面は真っ白です。エラーの文を見るには、DevTools のコンソールを開く必要があります。

onClick に setCount(1) と書くと、レンダーのたびに呼ばれる

onClick={setCount(1)} の { } の中は、JSX を組み立てるとき、つまりレンダーのたびにその場で実行されます。そのため、ボタンを押していなくても setCount(1) が呼ばれます。onClick に渡るのは関数ではなく、setCount を呼んだ戻り値です。公式ドキュメントのイベントハンドラーの節でも、関数は「渡す」もので「呼ぶ」ものではない、と注意しています。

レンダーの途中で state を変えると、React はそのレンダーの結果を捨てて、すぐにレンダーし直します(useState のリファレンスにある、set 関数の注意点)。レンダーし直してもまた setCount(1) が呼ばれるので、レンダーと state の更新が終わりなく続きます。useState のリファレンスのトラブルシューティングは、このエラーが出るのは多くの場合、レンダーの途中で条件なしに state を変えているときだと説明しています。

React はこの再レンダーの回数に上限を設けています。react-dom 19.3.1 の開発用ビルドのコードでは、上限の RE_RENDER_LIMIT は 25 です。1つのコンポーネントのレンダーをやり直すたびに回数を数え、25 に達するとこのエラーを投げます。

関数を渡す形に直すと、エラーが消える

直すには、「押されたときに setCount(1) を呼ぶ関数」を onClick に渡します。

tsx
<button onClick={() => setCount(1)}>1にする</button>

直したページを同じ開発サーバーで開くと、コンソールにはエラーも警告も出ませんでした。画面には count: 0 とボタンが表示され、ボタンを1回押すと count: 1 に変わりました。

直したページで、ボタンを押したあと「count: 1」と表示されている。下の DevTools のコンソールには、React DevTools の案内の1行だけが出ている
直した書き方のページで、ボタンを1回押したところ。エラーは出ていない

コンソールに残っている1行は、React DevTools の案内です。エラーとは関係なく、直す前のページにも出ていました。

コンポーネントの本体で set 関数を呼んでも同じエラーになる

onClick 以外でも、コンポーネントの関数の本体で毎回 set 関数を呼ぶと、同じエラーになります。次のコンポーネントも、開発サーバーで開いたところ、さきほどと同じ文のエラーが出ました(警告のコンポーネント名は <BadBody>)。

tsx
import { useState } from 'react';

// まちがい:レンダーの途中(関数の本体)で、毎回 state を変えている
export default function BadBody({ price }: { price: number }) {
  const [total, setTotal] = useState(0);
  setTotal(price * 1.1);
  return <p>税込み: {total}円</p>;
}

このように props から計算できる値なら、state にする必要はありません。レンダーの中で計算すれば済みます。公式ドキュメントにある、props や state から計算できる値についての節でも、この書き方が勧められています。

tsx
// 直したもの:props から計算できる値は state にせず、レンダーの中で計算する
export default function GoodBody({ price }: { price: number }) {
  const total = price * 1.1;
  return <p>税込み: {total}円</p>;
}

price に 1000 を渡して開くと、エラーは出ず、税込み: 1100円 と表示されました。

開く前に、型チェックと lint で見つけられる

TypeScript で書いていれば、onClick の書き間違いは型チェックの段階で見つかります。検証用のプロジェクトで npx tsc -p tsconfig.app.json --noEmit を実行すると、次のエラーが出ました。

text
src/BadOnClick.tsx(9,15): error TS2322: Type 'void' is not assignable to type 'MouseEventHandler<HTMLButtonElement> | undefined'.

onClick には関数を渡す決まりなのに、setCount(1) の戻り値の型(void)が渡っている、という意味です。テンプレートの npm run build は最初に tsc を実行するので、このまま本番用のビルドに進むこともありません。ただし、Vite のドキュメントにあるとおり、開発サーバーは型チェックをしないため、さきほどのようにそのまま画面を開けてしまいます。

一方、コンポーネントの本体で setTotal を呼ぶほうは、型としては正しいので、tsc ではエラーになりませんでした。こちらは、テンプレートに入っている lint ツールの oxlint が見つけました。設定はテンプレートのままで、npx oxlint src を実行すると、2つのファイルのどちらにも警告が出ました。

text
src/BadOnClick.tsx:9:24: warning react(set-state-in-render): Cannot call setState during render help: Calling setState during render may trigger an infinite loop. * To reset state when other state/props change, store the previous value in state and update conditionally. * To derive data from other state/props, compute the derived data during render without using state
src/BadBody.tsx:6:3: warning react(set-state-in-render): Cannot call setState during render help: Calling setState during render may trigger an infinite loop. * To reset state when other state/props change, store the previous value in state and update conditionally. * To derive data from other state/props, compute the derived data during render without using state

本番用のビルドでは、番号だけのエラーになる

型チェックを飛ばして npx vite build だけで本番用にビルドし、npx vite preview で開くと、DevTools のコンソールに出るエラーは次のように変わりました。ページが真っ白になるのは開発中と同じで、警告は出ませんでした。

text
Uncaught Error: Minified React error #301; visit https://react.dev/errors/301 for the full message or use the non-minified dev environment for full errors and additional helpful warnings.

本番用のビルドでは、エラーの文の代わりに、番号と URL が出ます。React のリポジトリにある、番号と文の対応表では、301 番は Too many re-renders. React limits the number of renders to prevent an infinite loop. です。公開中のサイトで #301 が出ていたら、このエラーと同じものです。

原因の set 関数の呼び出しがどこにあるか分からないときは、useState のリファレンスが、開発中のコンソールでエラーの横の矢印を開き、スタックを見ていく方法を紹介しています。検証では、続けて出る警告にコンポーネントの名前(<BadOnClick>)が入っていました。まずそのコンポーネントの onClick などに () 付きで関数を書いていないか、本体で set 関数を呼んでいないかを確かめます。

​Posted by 86