フレームワーク
React
Meta が開発する宣言的な UI ライブラリ。コンポーネントと Hooks(useState / useEffect 等)で状態と副作用を管理し、Next.js など多くのフレームワークの基盤になっている。
バージョン移行
メジャーバージョンを上げたときに動かなくなることを、旧版と新版で同じコマンドを打ち比べて確かめた。
React 18 → 19・変更点 9 つ
React を 18 から 19 に上げると動かなくなること
問題一覧(17)
React Context の値が更新されない
Context の更新が consumer に伝わらない事象は、value の参照が変わっていないか、Provider 自体が毎レンダーで再マウントしているのが典型。useState / useReducer を経由して値を渡し、複合オブジェクトは useMemo で参照を安定させる。
更新: 2026-10-14、タグ: context、provider、state
React で controlled / uncontrolled input 警告が消せない
changing an uncontrolled input to be controlled 警告は、value に初期値を与えれば消える。value が undefined から値へ変わると出るので、初期値は空文字にする。
更新: 2026-10-30、タグ: input、form、controlled
React Error Boundary で非同期 / イベントハンドラのエラーがキャッチできない
Error Boundary は子ツリーのレンダリング中・ライフサイクル・コンストラクタで投げられた例外しか捕まえない。イベントハンドラや非同期 / setTimeout のエラーは別途 try/catch して setState で再投入する必要がある。
更新: 2026-10-14、タグ: error-boundary、async、event-handler
React のハイドレーションエラー(Hydration mismatch)の原因と直し方
React の Hydration mismatch は、SSR の HTML とクライアントの初回描画が食い違うと出る。初回はサーバーと同じ内容を描画し、時刻・乱数・window 依存の値は useEffect の後で反映すれば直る。
更新: 2026-10-31、タグ: hydration、ssr、nextjs
React「Invalid hook call」の原因と直し方
Invalid hook call は、Hook をトップレベル以外で呼んだときか react が二重に読み込まれたときに出る。Hook は関数の先頭で呼び、react と react-dom の版を揃えれば直る。
更新: 2026-10-31、タグ: hooks、rules-of-hooks、invalid-hook-call
React で「Each child in a list should have a unique key prop」警告が消せない
Each child in a list should have a unique key prop は、map の各要素に一意な key を渡せば消える。key にはデータ由来の ID を使い、インデックスは並び替えの無いリストに限る。
更新: 2026-10-31、タグ: key、list、rendering
React「Maximum update depth exceeded」の原因と直し方
Maximum update depth exceeded は、Effect などで更新した state が次の更新を呼び続けると出る。useEffect なら関数型 setState にして依存から state を外せば止まる。
更新: 2026-10-31、タグ: setstate、useeffect、infinite-loop
React「Objects are not valid as a React child」の原因と直し方
Objects are not valid as a React child は、JSX の {} にオブジェクトや Promise を直接置くと出る。文字列や数値を取り出すか、配列は map で要素に変換すれば直る。
更新: 2026-11-02、タグ: jsx、rendering、error
React useRef の current が null で参照できない
useRef の current が null なら、DOM へのアクセスを useEffect の中へ移せば直る。レンダリング中はまだマウント前で null だ。子へ ref を通すなら React 18 以前は forwardRef を使う。
更新: 2026-10-06、タグ: useRef、ref、null
React「Rendered more hooks than during the previous render」の原因と直し方
Rendered more hooks than during the previous render は、フックを早期 return や if の後で呼ぶと出る。すべてのフックをコンポーネントの先頭で無条件に呼べば直る。
更新: 2026-11-02、タグ: hooks、rules-of-hooks、conditional
React で setState しても画面が更新されない
state は同一参照のオブジェクト / 配列を渡しても再レンダリングされない。スプレッドで新しい参照を作るか、関数型 setState で前回値から派生させる。クロージャ越しの古い state も典型的な原因。
更新: 2026-11-03、タグ: state、hooks、immutability
React の useEffect が Strict Mode で 2 回実行される
React 18 以降の Strict Mode で useEffect が 2 回走るのは開発時だけの仕様で、本番では 1 回だけだ。StrictMode は外さず、cleanup 関数で副作用を取り消すのが正しい対処である。
更新: 2026-11-03、タグ: strict-mode、useEffect、react18
React「Too many re-renders」の原因と直し方
Too many re-renders は、レンダリング中に state を無条件で更新すると出る。onClick={handleClick()} のような即時実行をやめ、更新はイベントハンドラか useEffect に移せば直る。
更新: 2026-11-12、タグ: rerender、infinite-loop、hooks
React「Cannot update a component while rendering a different component」の原因と直し方
Cannot update a component while rendering 警告は、set 関数を render の外で呼べば消える。別コンポーネントの state はイベントハンドラか useEffect で更新する。
更新: 2026-11-03、タグ: setstate、render、warning
React useEffect の cleanup が期待通り呼ばれない
useEffect の cleanup が呼ばれないときは、依存配列を正しく宣言し、解除に登録時と同じ関数参照を渡せば直る。cleanup はアンマウント時と次の effect 実行直前に走る。
更新: 2026-10-06、タグ: useeffect、cleanup、strict-mode
React の useEffect で無限ループが止められない
useEffect の無限ループは、依存配列をプリミティブに絞り、useMemo / useCallback で参照を安定させれば止まる。Effect 内で更新する state は関数型 setState で依存から外す。
更新: 2026-10-19、タグ: useeffect、hooks、infinite-loop
React の useMemo がメモ化されず毎回再計算される
useMemo は依存配列の値を Object.is で比較する。オブジェクトや関数を依存に入れると参照が毎回変わり再計算される。依存はプリミティブに絞り、参照は親側で useMemo / useCallback により安定化させる。
更新: 2026-11-07、タグ: usememo、memoization、dependency-array