できない.dev

React の useEffect が Strict Mode で 2 回実行される

React 18 以降の Strict Mode で useEffect が 2 回走るのは開発時だけの仕様で、本番では 1 回だけだ。
StrictMode は外さず、cleanup 関数で副作用を取り消すのが正しい対処である。

公開: 更新:

症状できない
node bad.js
…
tick
tick
resize
resize

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

要約

React 18 以降の Strict Mode は、開発ビルドでのみコンポーネントを意図的に 1 度アンマウント → 再マウントし、useEffect を 2 回走らせる。
これはクリーンアップ漏れによる副作用バグを早期検出するための仕様で、本番ビルドでは発生しない。
Strict Mode を外す代わりに、クリーンアップ関数で副作用を確実に取り消すのが正しい対処である。

実行例

jsdom 上で開発ビルドの StrictMode に載せると、クリーンアップを返さない effect が 2 回走り、tick も resize も倍の回数出力された。
本番ビルドでは effect が 1 回だけになって出力も半分に減り、clearInterval と removeEventListener をクリーンアップで返す版では開発ビルドでも「start → cleanup → start」の順になり、タイマーとリスナーが 1 本ずつに収まる。

$ node bad.js
effect: start
effect: start
tick
tick
tick
tick
resize
resize
$ NODE_ENV=production node bad.js
effect: start
tick
tick
resize
$ node good.js
effect: start
effect: cleanup
effect: start
tick
tick
resize
effect: cleanup

— 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 19.3.1

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

解決策

1. Strict Mode は外さず、クリーンアップを返す

クリーンアップが書かれていれば、開発時に 2 回走っても結果は冪等になる(公式ドキュメント(新しいタブで開く))。

useEffect(() => {
  const id = setInterval(() => console.log("tick"), 1000);
  return () => clearInterval(id);
}, []);

setInterval と clearInterval が対になっていれば、二重実行されてもタイマーは 1 本に収束する。

2. fetch は AbortController で中断する

useEffect(() => {
  const ctrl = new AbortController();
  fetch("/api/data", { signal: ctrl.signal })
    .then((r) => r.json())
    .then(setData)
    .catch((e) => {
      if (e.name !== "AbortError") throw e;
    });
  return () => ctrl.abort();
}, []);

開発時に最初のリクエストが中断され、再マウント後の 2 回目だけが state に反映される。
本番ではそのまま 1 回のみ実行される。

3. subscribe / addEventListener も対称に解除する

useEffect(() => {
  const onResize = () => setSize(window.innerWidth);
  window.addEventListener("resize", onResize);
  return () => window.removeEventListener("resize", onResize);
}, []);

登録時と解除時で同じ関数参照を使う点に注意する。

4. 本番挙動を確認するときは production build を使う

開発サーバの再マウントを止めたいだけなら <StrictMode> を外す前に npm run build → npm run preview 等で確認する。
StrictMode を外すと将来 React が同様の検査を再導入したときにバグを取りこぼす。

よくある原因

  1. <React.StrictMode> で囲まれた開発ビルドを実行している(CRA / Vite / Next.js のテンプレートはデフォルトで有効)
  2. useEffect で fetch / WebSocket / setInterval を起動しながら戻り値のクリーンアップ関数を返していない
  3. 副作用が二重に走ることをバグだと誤認している(production ビルドでは 1 回のみ)
  4. StrictMode が暗黙に有効化されていることを把握しておらず、<StrictMode> を main.tsx 内で探していない