ReactでRendered more hooksが出る原因と直し方

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

React で Rendered more hooks than during the previous render. というエラーが出るよくある原因は、コンポーネントの途中で条件によって早めに return していて、その return より後ろに useState などのフックを書いていることです。ログインの前後や、データの読み込み中と読み込み後のように、表示を切り替えた瞬間に画面が消えます。フックをすべて return より前に移すと、エラーは消えます。

私は検証環境でこのエラーをわざと起こし、ブラウザーのコンソールに出た文と、直したあとに消えることを確かめました。

補足

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

ログインした瞬間にエラーになるコンポーネント

次の BadProfile は、ログインしていない(user が null の)ときは早めに return し、ログインしているときだけ「いいね」の数を useState で持ちます。2つ目の useState が return の後ろにあるのが間違いです。

tsx
import { useState } from 'react';

type User = { name: string };

// まちがい:早めの return のあとに useState を書いている
export default function BadProfile({ user }: { user: User | null }) {
  const [showMail, setShowMail] = useState(false);
  if (user === null) {
    return <p>ログインしていません</p>;
  }
  const [likes, setLikes] = useState(0);
  return (
    <div>
      <p>{user.name} さん</p>
      <button onClick={() => setShowMail(!showMail)}>メールを表示</button>
      <button onClick={() => setLikes(likes + 1)}>いいね {likes}</button>
    </div>
  );
}

親のコンポーネントには「ログイン」ボタンを置き、押すと user を null から { name: 'ねこ' } に変えるようにしました。開発サーバー(npm run dev と同じ vite)で開くと、最初は「ログインしていません」と表示され、エラーは出ません。「ログイン」ボタンを押した瞬間に、ボタンも含めて画面が真っ白になりました。

コンソールに出たメッセージ

ボタンを押したとき、DevTools のコンソールには、エラーが2件と警告が1件出ました。メインのエラーは次の文です。

text
Uncaught Error: Rendered more hooks than during the previous render.

その前に、フックを呼ぶ順番が前回のレンダーと変わったことを知らせるエラーが出ます。DevTools では次のように表示されます。

text
React has detected a change in the order of Hooks called by BadProfile. This will lead to bugs and errors if not fixed. For more information, read the Rules of Hooks: https://react.dev/link/rules-of-hooks

   Previous render            Next render
   ------------------------------------------------------
1. useState                   useState
2. undefined                  useState
   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

最後に、エラーが起きたコンポーネントの名前が入った警告が出ます。

text
An error occurred in the <BadProfile> 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 のコンソールに、赤い行で「React has detected a change in the order of Hooks called by BadProfile.」と「Uncaught Error: Rendered more hooks than during the previous render.」、黄色い行で「An error occurred in the <BadProfile> component.」が出ている。上のページの部分は何も表示されていない
まちがった書き方で「ログイン」ボタンを押したところ。ページは真っ白で、コンソールにエラー2件と警告1件が出た

DevTools では、Uncaught Error の行の下に at BadProfile (BadProfile.tsx:11:29) と出ていました。11行目は、return の後ろにある useState(0) の行です。どこを直せばよいかは、この表示から分かります。

前回よりフックが多いと、React が state と対応させられない

React は、1つのコンポーネントの中のフックを、呼ばれた順番で見分けています。公式ドキュメントの state を説明したページには、React がどの state を返すかを決める仕組みの補足があります。そこでは、フックは同じコンポーネントのどのレンダーでも同じ順番で呼ばれることを前提にしている、と説明しています。

BadProfile では、ログインしていないときのレンダーで呼ばれるフックは useState(false) の1つだけです。ログインしたあとのレンダーでは、return を通り過ぎるので、2つ目の useState(0) も呼ばれます。コンソールの表にある 2. undefined と useState は、前回のレンダーには2番目のフックがなく、今回は2番目に useState が呼ばれたことを示しています。前回の記録にない2番目のフックが呼ばれたところで、React はこのエラーを投げます。

フックのルールには、フックはコンポーネントのトップレベルで、早めの return より前に呼ぶこと、条件付きの return のあとでフックを呼ばないことが書かれています。

フックを return より前に移すと、エラーが消える

直すには、2つ目の useState を if より前に移し、フックをすべて早めの return より前で呼ぶようにします。

tsx
// import と type User は BadProfile と同じ
// 直したもの:フックをすべて、早めの return より前に書く
export default function GoodProfile({ user }: { user: User | null }) {
  const [showMail, setShowMail] = useState(false);
  const [likes, setLikes] = useState(0);
  if (user === null) {
    return <p>ログインしていません</p>;
  }
  return (
    <div>
      <p>{user.name} さん</p>
      <button onClick={() => setShowMail(!showMail)}>メールを表示</button>
      <button onClick={() => setLikes(likes + 1)}>いいね {likes}</button>
    </div>
  );
}

直したコンポーネントで「ログイン」ボタンを押すと、コンソールにエラーも警告も出ず、「ねこ さん」と2つのボタンが表示されました。「いいね」を押すと いいね 1 に変わり、そのあと「ログアウト」を押しても、エラーは出ませんでした。

直したページで「ログイン」ボタンを押したあと、「ログアウト」ボタン、「ねこ さん」、「メールを表示」と「いいね 0」のボタンが表示されている。下の DevTools のコンソールには、React DevTools の案内の1行だけが出ている
直した書き方で「ログイン」ボタンを押したところ。エラーは出ていない

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

ログインしていないときには使わない state でも、useState は毎回呼びます。使うかどうかの分岐(if (user === null) の return)は、フックをすべて呼んだあとに置きます。

return のあとの部分を、別のコンポーネントに分けてもよい

ログインしているときにしか使わない state なら、その部分を別のコンポーネントに切り出す方法もあります。次の SplitProfile では、「いいね」のボタンを LikeButton に分け、useState(0) を LikeButton の中に移しました。

tsx
// import と type User は BadProfile と同じ
// 直したもの:早めの return のあとの部分を、別のコンポーネントに分ける
export default function SplitProfile({ user }: { user: User | null }) {
  const [showMail, setShowMail] = useState(false);
  if (user === null) {
    return <p>ログインしていません</p>;
  }
  return (
    <div>
      <p>{user.name} さん</p>
      <button onClick={() => setShowMail(!showMail)}>メールを表示</button>
      <LikeButton />
    </div>
  );
}

function LikeButton() {
  const [likes, setLikes] = useState(0);
  return <button onClick={() => setLikes(likes + 1)}>いいね {likes}</button>;
}

LikeButton の中では、フックはいつも同じ順番で呼ばれます。検証では、ログイン、「いいね」、ログアウトの順に押しても、エラーは出ませんでした。

ログアウトのときは Rendered fewer hooks になる

同じ BadProfile を、最初はログインした状態で表示し、「ログアウト」ボタンを押すと、今度は別の文のエラーになりました。画面が真っ白になるのは同じです。

text
Uncaught Error: Rendered fewer hooks than expected. This may be caused by an accidental early return statement.

こちらは、前回のレンダーより呼ばれたフックが少なかったときのエラーです。文の中にあるとおり、早めの return が原因になっていることがあります。直し方は同じで、フックを return より前に移すと、ログアウトしてもエラーは出なくなりました。

return より前にフックがないと、エラーにならないこともある

検証では、早めの return より前にフックが1つもなく、return のあとにだけ useState があるコンポーネントも試しました。

tsx
// import と type User は BadProfile と同じ
// まちがい:早めの return の前にフックが1つもなく、return のあとにだけ useState がある
export default function BadNoHookBefore({ user }: { user: User | null }) {
  if (user === null) {
    return <p>ログインしていません</p>;
  }
  const [likes, setLikes] = useState(0);
  return (
    <div>
      <p>{user.name} さん</p>
      <button onClick={() => setLikes(likes + 1)}>いいね {likes}</button>
    </div>
  );
}

このコンポーネントでは、ログインしても、ログアウトしても、コンソールにエラーは出ませんでした。ただし、フックのルールに反した書き方であることは変わりません。エラーが出ないからといって、この書き方を残さないようにします。次の節の lint では、この書き方もエラーになりました。

開く前に lint で見つけられる

TypeScript の型チェックでは、この間違いは見つかりません。検証用のプロジェクトで npx tsc -p tsconfig.app.json --noEmit を実行しても、エラーは出ませんでした。

一方、テンプレートに入っている lint ツールの oxlint は、設定に "react/rules-of-hooks": "error" が入っていて、この間違いを見つけます。npx oxlint src を実行すると、まちがった2つのファイルの両方にエラーが出ました。

text
src/BadProfile.tsx:11:29: error react-hooks(rules-of-hooks): React Hook "useState" is called conditionally. React Hooks must be called in the exact same order in every component render. help: Move the Hook call before the condition, or call it unconditionally and branch inside the Hook/effect instead.
src/BadNoHookBefore.tsx:10:29: error react-hooks(rules-of-hooks): React Hook "useState" is called conditionally. React Hooks must be called in the exact same order in every component render. help: Move the Hook call before the condition, or call it unconditionally and branch inside the Hook/effect instead.

ESLint を使っているプロジェクトなら、フックのルールのページで紹介されている eslint-plugin-react-hooks が、同じ役目をします。

本番用のビルドでは #310 と #300 になる

npx vite build で本番用にビルドし、npx vite preview で開いて同じ操作をすると、コンソールに出るエラーは次のように変わりました。

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

ログアウトのほうは #300 でした。

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

React のリポジトリにある、エラー番号と文の対応表では、310 番が Rendered more hooks than during the previous render.、300 番が Rendered fewer hooks than expected. This may be caused by an accidental early return statement. です。公開中のサイトでこの番号が出ていたら、どこかのコンポーネントで、早めの return などのせいでフックの数が変わっています。開発サーバーで同じ操作をすると、どのコンポーネントの何行目かが分かります。

​Posted by 86