できない.dev

React で setState しても画面が更新されない

state は同一参照のオブジェクト / 配列を渡しても再レンダリングされない。
スプレッドで新しい参照を作るか、関数型 setState で前回値から派生させる。
クロージャ越しの古い state も典型的な原因。

公開: 更新:

症状できない
node bad_mutate.js
before click: renders=1 screen="a"
after click : renders=1 screen="a"

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

要約

setState を呼んでも画面が更新されないとき、原因は概ね 同一参照を渡している か 古い state をクロージャ経由で読んでいる かの 2 系統に分かれる。
前者は新しいオブジェクトを作って渡せば直る。
後者は関数型 setCount(c => c + 1) で前回値から派生させると解決する。

実行例

ボタンを 1 回クリックして描画回数と画面の文字を見ると、配列を push で書き換えて同じ参照を渡した場合は描画回数が 1 のままで、画面も a から変わらなかった。
スプレッドで新しい配列を作ると a,b に更新された。
setCount(count + 1) を 2 回呼ぶと 0 から 1 にしか進まず、関数型の setCount(c => c + 1) にすると 2 まで進んだ。

$ node bad_mutate.js
before click: renders=1 screen="a"
after click : renders=1 screen="a"
$ node good_spread.js
before click: renders=1 screen="a"
after click : renders=2 screen="a,b"
$ node bad_stale.js
before click: renders=1 screen="0"
after click : renders=2 screen="1"
$ node good_functional.js
before click: renders=1 screen="0"
after click : renders=2 screen="2"

— 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. 新しい参照を作って渡す

// NG: 同じ配列を返している
setItems(items => {
  items.push(newItem);
  return items;
});
 
// OK: 新しい配列を作る
setItems(items => [...items, newItem]);

オブジェクトも同様にスプレッドで複製する。

2. 関数型 setState

// NG: count が stale closure
const handle = () => {
  setCount(count + 1);
  setCount(count + 1); // 結果は +1 だけ
};
 
// OK: 前回値から派生
const handle = () => {
  setCount(c => c + 1);
  setCount(c => c + 1); // +2 進む
};

公式の Queueing a Series of State Updates(新しいタブで開く) でも、連続更新には関数型を使うよう勧めている。

3. 最新値が必要なら useRef

const latestRef = useRef(count);
latestRef.current = count;
 
const onClick = () => {
  setTimeout(() => {
    console.log(latestRef.current); // 常に最新
  }, 1000);
};

state は描画用、ref は最新値の読み取り用と役割を分ける。

4. レンダリング中に setState しない

// NG: 無限ループ
function App() {
  const [n, setN] = useState(0);
  setN(n + 1); // 毎レンダリングで呼ばれる
  return <div>{n}</div>;
}

副作用は useEffect(新しいタブで開く) の中に閉じ込める。

よくある原因

  1. state を mutate して同じ参照を渡している。
    state.items.push(x); setState(state) のように既存配列を書き換えても、React は Object.is で参照比較するため再レンダリングしない。
  2. stale closure が起きている。
    イベントハンドラやタイマー内の count が古いレンダリングの値を掴んでいると、続けて setCount(count + 1) を呼んでも 1 しか進まない。
  3. 自動バッチングで更新がまとめられている。
    React 18 以降は Promise や setTimeout 内も含めて自動でバッチされるので、複数の setCount(count + 1) が同じ値で潰れる。
  4. render 中に更新している。
    render 中に setState を呼ぶと無視される(または無限ループ警告になる)。