ReactでInvalid hook callが出る原因と直し方
React で Invalid hook call というエラーが出るのは、主に2つの場合です。1つは、useState などのフックを、イベントハンドラーのような普通の関数の中や、コンポーネントの外で呼んだときで、もう1つは、自作のコンポーネントライブラリ(別のフォルダーで作ったパッケージ)を入れるなどして、React が2つ入ってしまったときです。前者はフックを呼ぶ場所を直し、後者は React を1つにまとめると消えます。
私は検証環境でそれぞれの場合を起こし、コンソールに出たエラーメッセージと、直すと消えることを確かめました。
検証環境は 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)で動かして撮りました。Next.js などのフレームワーク、webpack などほかのバンドラー、Chromium 以外のブラウザーでの表示、ESLint の eslint-plugin-react-hooks、npm link のあとに開発サーバーで開くことは試していません。
コンソールに出るエラーの全文
開発サーバー(npm run dev と同じ vite)で、フックを呼ぶ場所をまちがえたページを開くと、DevTools のコンソールに次のエラーが出ました。
Uncaught Error: Invalid hook call. Hooks can only be called inside of the body of a function component. This could happen for one of the following reasons:
1. You might have mismatching versions of React and the renderer (such as React DOM)
2. You might be breaking the Rules of Hooks
3. You might have more than one copy of React in the same app
See https://react.dev/link/invalid-hook-call for tips about how to debug and fix this problem.
「フックは関数コンポーネントの本体の中でしか呼べない」という意味です。続けて、考えられる原因が3つ挙がっています。React と React DOM のバージョンが合っていない、フックのルールを破っている、同じアプリに React が2つ入っている、の3つです。この記事では、2つめと3つめを実際に起こしました。
イベントハンドラーの中で呼んだとき
次のコンポーネントは、ボタンを押したときに呼ばれる関数 handleClick の中で useState を呼んでいます。
import { useState } from 'react';
// まちがい:クリックで呼ばれる関数(イベントハンドラー)の中でフックを呼んでいる
export default function BadHandler() {
function handleClick() {
const [count, setCount] = useState(0);
setCount(count + 1);
}
return <button onClick={handleClick}>押す</button>;
}
このページは、開いただけではエラーになりません。ボタンは表示され、押した瞬間に、さきほどのエラーがコンソールに出ました。押すたびに1件ずつ出て、ボタンの表示は変わりません。

DevTools では、エラーの下に at handleClick (BadHandler.tsx:6:31) と出ていました。useState を呼んでいる関数の名前と、ファイルの行です。エラーの文だけでは場所が分からないので、まずこの行を見ます。
公式ドキュメントのフックのルールでは、フックを呼んでよいのは、関数コンポーネントかカスタムフックの本体の一番上だけです。イベントハンドラーの中で呼ぶことは、してはいけない例として挙がっています。直すには、useState をコンポーネントの本体に移し、ハンドラーでは set 関数だけを使います。
import { useState } from 'react';
// 直したもの:フックはコンポーネントの本体の一番上で呼び、ハンドラーでは set 関数だけを使う
export default function GoodHandler() {
const [count, setCount] = useState(0);
function handleClick() {
setCount(count + 1);
}
return <button onClick={handleClick}>押す({count}回)</button>;
}
直したページでは、ボタンを押してもエラーは出ず、表示が「押す(0回)」から「押す(1回)」「押す(2回)」と変わりました。
コンポーネントの外で呼んだとき
ファイルの一番上、どの関数にも入っていない場所でフックを呼んでも、同じ Invalid hook call. の文が出ます。
import { useState } from 'react';
// まちがい:コンポーネントの外(ファイルの一番上)でフックを呼んでいる
const [theme, setTheme] = useState('light');
export default function BadTopLevel() {
return <button onClick={() => setTheme('dark')}>テーマ: {theme}</button>;
}
こちらは、ファイルが読み込まれた時点で useState が呼ばれます。検証では、ページを開いただけでエラーになり、画面は真っ白でした(コンポーネントを入れる <div id="root"> の中が空)。
ただし、コンソールへの出方は、このファイルの読み込み方で変わりました。アプリの入り口のファイル(検証では main.tsx とは別に作った static-main.tsx)で import BadTopLevel from './BadTopLevel' と普通に import したときは、Invalid hook call. の文がエラーのログとして出て、続いて次のエラーが投げられました。
Uncaught TypeError: Cannot read properties of null (reading 'useState')
一方、ページごとのファイルを React の lazy で読み込んだときは、さきほどと同じ Uncaught Error: Invalid hook call. が投げられ、次の警告も出ました。
An error occurred in one of your React components.
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.
ふだんはこの警告に、エラーが起きたコンポーネントの名前が入ります。ここでは「one of your React components」となっていて、名前から場所をたどれません。どちらの読み込み方でも、エラーのスタックには BadTopLevel.tsx のファイル名と行が出ていたので、そこから探します。
直すには、useState をコンポーネントの中に移します。
import { useState } from 'react';
// 直したもの:コンポーネントの中に移す
export default function GoodTopLevel() {
const [theme, setTheme] = useState('light');
return <button onClick={() => setTheme('dark')}>テーマ: {theme}</button>;
}
直したページでは、エラーは出ず「テーマ: light」と表示され、ボタンを押すと「テーマ: dark」に変わりました。
レンダー中に呼ばれる普通の関数は、エラーにならない
フックを普通の関数の中で呼んでも、その関数がコンポーネントのレンダー中に呼ばれるなら、エラーは出ませんでした。次のコンポーネントは、画面に「こんにちは」と表示され、コンソールにもエラーは出ませんでした。
import { useState } from 'react';
// 名前が use で始まらない普通の関数の中でフックを呼び、それをレンダー中に呼んでいる
function getLabel() {
const [label] = useState('こんにちは');
return label;
}
export default function HelperInRender() {
return <p>{getLabel()}</p>;
}
ただし、これもフックのルールに反した書き方です。公式ドキュメントでは、フックを呼べるのは関数コンポーネントと、名前が use で始まるカスタムフックだけです。ほかの関数をカスタムフックにしたいなら、名前を useLabel のように変えます。中身はそのままで、表示も同じ「こんにちは」でした。
// 直したもの:名前を use で始めて、カスタムフックとして扱う
function useLabel() {
const [label] = useState('こんにちは');
return label;
}
export default function GoodHelper() {
const label = useLabel();
return <p>{label}</p>;
}
ブラウザーで開く前に、oxlint で見つけられる
ここまでの3つのまちがいは、どれも型としては正しいので、npx tsc -p tsconfig.app.json --noEmit ではエラーになりませんでした。一方、テンプレートに入っている lint ツールの oxlint は、3つとも見つけました。テンプレートの設定(.oxlintrc.json)で react/rules-of-hooks が error になっているためです。npx oxlint src を実行すると、次のように出ました。
src/BadTopLevel.tsx:4:27: error react-hooks(rules-of-hooks): React Hook "useState" cannot be called at the top level. React Hooks must be called in a React function component or a custom React Hook function.
src/BadHandler.tsx:6:31: error react-hooks(rules-of-hooks): React Hook "useState" is called in function "handleClick" that is neither a React function component nor a custom React Hook function. React component names must start with an uppercase letter. React Hook names must start with the word "use".
src/HelperInRender.tsx:5:19: error react-hooks(rules-of-hooks): React Hook "useState" is called in function "getLabel" that is neither a React function component nor a custom React Hook function. React component names must start with an uppercase letter. React Hook names must start with the word "use".
実行時にはエラーにならなかった getLabel も、ここで見つかります。ESLint を使っているプロジェクトなら、公式ドキュメントが案内している eslint-plugin-react-hooks で、同じルールを確かめられます。
React が2つ入っているとき
フックを正しく書いていても、React が2つ入っていると同じ種類のエラーになります。検証では、別のフォルダーに自作のパッケージ my-button を作り、アプリから npm i ../my-button で入れました。my-button は useState で押した回数を数えるボタンで、package.json の dependencies に react を書き、そのフォルダーでも npm i しています。
アプリのフォルダーで npm ls react を実行すると、my-button の下にもう1つ react がありました(パスは例示用の値に置き換えています)。
app@0.0.0 /path/to/app
+-- my-button@1.0.0 -> ./../my-button
| `-- react@19.3.1
+-- react-dom@19.3.1
| `-- react@19.3.1 deduped
`-- react@19.3.1
公式ドキュメントの Invalid hook call のページによると、フックが動くには、アプリのコードから import した react と、react-dom の中から import した react が、同じものである必要があります。この構成では、my-button の中の import { useState } from 'react' が、my-button 自身の node_modules にある、アプリとは別の react を指すことがあります。次のとおり、検証ではビルドしたときにそうなりました。
開発サーバーでは起きず、ビルドすると起きた
開発サーバーで開いたところ、ボタンは動き、エラーは出ませんでした。開発サーバーが my-button のファイルを変換した結果を見ると、react の import が、Vite が事前バンドルしたアプリ側の /node_modules/.vite/deps/react.js に書き換わっていました。開発サーバーでは、React が1つにまとまっていたことになります。
一方、npx vite build で本番用にビルドし、npx vite preview で開くと、画面は真っ白になり、エラーは次の1つだけでした。
Cannot read properties of null (reading 'useState')
本番用のビルドでは Invalid hook call の文が出ません。文を確かめるため、NODE_ENV=development npx vite build --mode development --minify false --outDir dist-dev で開発用にビルドして開くと、コンソールには次のように出ました(エラーは同じ文が2回出て、そのあとに TypeError が出ました)。
Invalid hook call. Hooks can only be called inside of the body of a function component. This could happen for one of the following reasons:
1. You might have mismatching versions of React and the renderer (such as React DOM)
2. You might be breaking the Rules of Hooks
3. You might have more than one copy of React in the same app
See https://react.dev/link/invalid-hook-call for tips about how to debug and fix this problem.
Uncaught TypeError: Cannot read properties of null (reading 'useState')
続く警告には An error occurred in the <CountButton> component. と、my-button のコンポーネントの名前が出ました。

エラーのログのあとに TypeError が投げられる点は、普通の import でファイルの一番上で呼んだときと同じで、イベントハンドラーで呼んだときとは違います。react 19.3.1 の開発用ビルドのコードを見ると、この文を出している箇所が2つあります。react の useState などは、react-dom がフックの処理を渡すための入れ物(ReactSharedInternals.H)を見て、これが null なら、この文をエラーのログに出して、そのまま先に進みます。そのあと null から useState を読もうとして TypeError になります。入れ物に react-dom の ContextOnlyDispatcher が入っているときは、そのフックの関数(useState なども throwInvalidHookError)が、この文のエラーを投げます。lazy で読み込んだファイルの一番上で呼んだときのスタックには、この throwInvalidHookError が出ていました。React が2つのときは、my-button が使うほうの react の入れ物が null のままだったので、TypeError になったのです。
ビルドした開発用のファイルの中を探すと、react.development.js が2か所に入っていました。
dist-dev/assets/UseMyButton-BNdzeMvA.js:2:// ../my-button/node_modules/react/cjs/react.development.js
dist-dev/assets/index-CTd_yjxt.js:33:// node_modules/react/cjs/react.development.js
Vite の resolve.dedupe で1つにまとめる
Vite を使っているなら、vite.config.ts に resolve.dedupe を書くと、指定したパッケージを、どこから import してもプロジェクトのルートにあるものに決められます。
import react from '@vitejs/plugin-react'
import { defineConfig } from 'vite'
// https://vite.dev/config/
export default defineConfig({
plugins: [react()],
resolve: {
// どこから import しても、プロジェクトのルートにある react を使う
dedupe: ['react', 'react-dom'],
},
})
この設定でビルドし直すと、開発用のビルドでは react.development.js が1か所だけになりました。本番用と開発用のどちらのビルドでもエラーは出ず、ボタンを押すと「押した回数: 1」「押した回数: 2」と増えました。

npm link でアプリの React を使わせる
公式ドキュメントでは、npm link などでライブラリをつないだときの直し方として、ライブラリのフォルダーから npm link ../myapp/node_modules/react を実行する方法を紹介しています。ライブラリが、アプリと同じ React を使うようになります。
vite.config.ts を元に戻し、my-button のフォルダーで npm link ../app/node_modules/react を実行すると、my-button/node_modules/react が、アプリの node_modules/react へのリンクに変わりました。開発用にビルドし直すと react.development.js は1か所になり、エラーは出ず、ボタンも押した回数を数えました。
公式ドキュメントは、ライブラリが react を peerDependencies ではなく dependencies に書いていることも、React が2つになる原因の例に挙げています。
本番のサイトで #321 が出ていたら
イベントハンドラーの中でフックを呼んだページを本番用にビルドして開くと、ボタンを押したときのエラーは次のように番号だけになりました。
Minified React error #321; visit https://react.dev/errors/321 for the full message or use the non-minified dev environment for full errors and additional helpful warnings.
React のリポジトリにあるエラー番号と文の対応表では、321 番がこの記事の Invalid hook call. の文です。公開中のサイトで #321 が出ていたら、フックを呼ぶ場所を確かめます。React が2つのときは、さきほどのとおり本番用のビルドでは Cannot read properties of null (reading 'useState') しか出なかったので、この形の TypeError が出ていたら npm ls react で React がいくつ入っているかを確かめます。





