---
title: "React にエラーバウンダリを追加してそれが見逃すエラーも記録する"
description: "React のエラーバウンダリは、レンダー中のエラーを捕捉してフォールバックを表示します。クラスの書き方、見逃すエラー、各エラーを LogBrew に送る方法を、React 19.3 で検証してまとめました。"
canonical: "https://logbrew.co/ja/guides/react-error-boundary"
last_updated: "2026-11-21"
---

# React にエラーバウンダリを追加してそれが見逃すエラーも記録する

React のエラーバウンダリは、レンダー中のエラーを捕捉してフォールバックを表示します。クラスの書き方、見逃すエラー、各エラーを LogBrew に送る方法を、React 19.3 で検証してまとめました。

2026年11月21日 に React 19.3.1、Vite 8.3.8、Chrome 156、@logbrew/react 0.1.6、@logbrew/sdk 0.1.47、logbrew CLI 0.1.96 で検証

執筆 [Furkan Erday](https://github.com/furkanerday). Furkan Erday は LogBrew の創業者です。毎日 Claude Code と Codex を使って LogBrew を開発しています。

Canonical: https://logbrew.co/ja/guides/react-error-boundary

## フォールバックを表示し LogBrew に届く React のエラー

| エラーが投げられた場所 | フォールバック表示 | LogBrew の問題 |
| --- | --- | --- |
| レンダー、`LogBrewErrorBoundary` の中 | はい | はい |
| `useEffect`、バウンダリの中 | はい | はい |
| レンダー、バウンダリなし | いいえ、ルートが空 | はい、ルート用のオプションから |
| `onClick` ハンドラー | いいえ | いいえ |
| 非同期ハンドラー、`await` の後 | いいえ | いいえ |
| `captureReactError()` を使う `onClick` | いいえ | はい |

React 19.3.1 と @logbrew/react 0.1.6 を使った Vite の本番ビルド 1 つで起こした 6 つのエラー。

## エラーバウンダリを書く

### バウンダリをクラスコンポーネントとして書く

React にはこのためのフックがないので、エラーバウンダリはクラスになります。`getDerivedStateFromError` が次のレンダーでフォールバックに切り替えます。`componentDidCatch` はエラーと `info.componentStack` を受け取ります。これは、エラーを投げたコンポーネントより上にあるコンポーネントの一覧です。

```bash
import { Component } from "react";

export class ErrorBoundary extends Component {
  state = { error: null };

  static getDerivedStateFromError(error) {
    return { error };
  }

  componentDidCatch(error, info) {
    console.log("caught:", error.message);
    console.log("in:", info.componentStack.split("\n")[1].trim());
  }

  render() {
    if (this.state.error) return <p role="alert">Could not load the taps.</p>;
    return this.props.children;
  }
}
```

### 失敗しうるページの一部を囲む

`TapList` は `taps` がないときに `taps.map` を読むので、レンダー中にエラーを投げます。バウンダリは `Could not load the taps.` を表示し、`Taproom` の見出しは残りました。開発中は、React が `The above error occurred in the <TapList> component` とともにエラーも出力しました。

```bash
// TapList.jsx
export function TapList({ taps }) {
  return <ul>{taps.map((tap) => <li key={tap}>{tap}</li>)}</ul>;
}

// App.jsx
import { ErrorBoundary } from "./ErrorBoundary.jsx";
import { TapList } from "./TapList.jsx";

export function App() {
  return (
    <main>
      <h1>Taproom</h1>
      <ErrorBoundary>
        <TapList />
      </ErrorBoundary>
    </main>
  );
}
```

出力

```text
caught: Cannot read properties of undefined (reading 'map')
in: at TapList (http://127.0.0.1:25174/guide/TapList.jsx:3:27)
```

### イベントハンドラーのエラーはバウンダリを素通りする

React は `onClick` をレンダーの外で呼ぶので、バウンダリはエラーを受け取りませんでした。ボタンはページに残り、ブラウザーは捕捉されないエラーを出力しました。`await` の後のエラーも同じでした。

```bash
export function PourButton() {
  return (
    <button onClick={() => { throw new Error("pour failed"); }}>Pour</button>
  );
}

// main.jsx
createRoot(document.getElementById("root")).render(
  <ErrorBoundary>
    <PourButton />
  </ErrorBoundary>
);
```

出力

```text
Uncaught Error: pour failed
    at onClick (http://127.0.0.1:25174/guide/PourButton.jsx:6:10)
```

### ハンドラーのエラーを state 経由でバウンダリに渡す

ハンドラーでエラーを捕捉し、`setError` で保存して、次のレンダーで投げます。するとバウンダリがフォールバックを表示し、`componentDidCatch` でエラーを受け取ります。

```bash
import { useState } from "react";

export function SafePourButton() {
  const [error, setError] = useState(null);
  if (error) throw error;

  function pour() {
    try {
      throw new Error("pour failed");
    } catch (caught) {
      setError(caught);
    }
  }

  return <button onClick={pour}>Pour</button>;
}
```

出力

```text
caught: pour failed
in: at SafePourButton (http://127.0.0.1:25174/guide/SafePourButton.jsx:7:28)
```

### バウンダリがないと、React はツリー全体を消す

どのバウンダリもレンダーエラーを捕捉しないと、React 19 はルートをアンマウントします。`root` 要素は空になり、見出しも消えました。React はエラーと、エラーバウンダリの追加を求める警告を出力しました。

```bash
import { createRoot } from "react-dom/client";
import { TapList } from "./TapList.jsx";

createRoot(document.getElementById("root")).render(
  <main>
    <h1>Taproom</h1>
    <TapList />
  </main>
);
```

出力

```text
Uncaught TypeError: Cannot read properties of undefined (reading 'map')
An error occurred in the <TapList> 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.
```

## React のエラーを LogBrew に送る

### パッケージをインストールする

`@logbrew/react` にはプロバイダー、エラーバウンダリ、ルート用のオプションが入っています。LogBrew プロジェクトのブラウザーキーを `clientKey` として使います。

```bash
npm install @logbrew/sdk @logbrew/react react
```

### クライアントと transport を作る

クライアントは、`client.flush(transport)` を呼ぶまでイベントをキューに保持します。transport は `{ statusCode }` を返す必要があります。私たちの transport が `fetch` のレスポンスをそのまま返したときは、flush が `invalid transport response` で失敗しました。`VITE_LOGBREW_ENDPOINT` には `https://api.logbrew.co/v1/events` を設定します。私たちはローカルの LogBrew サーバーに送りました。

```bash
import { createLogBrewReactClient } from "@logbrew/react";

export const client = createLogBrewReactClient({
  clientKey: import.meta.env.VITE_LOGBREW_CLIENT_KEY
});

export const transport = {
  async send(apiKey, body) {
    const response = await fetch(import.meta.env.VITE_LOGBREW_ENDPOINT, {
      method: "POST",
      headers: {
        authorization: `Bearer ${apiKey}`,
        "content-type": "application/json",
      },
      body
    });
    return { statusCode: response.status };
  }
};

export function send() {
  return client
    .flush(transport)
    .then((result) => console.log("sent", JSON.stringify(result)));
}
```

### LogBrewErrorBoundary を LogBrewProvider の中に置く

`LogBrewErrorBoundary` はクライアントを `LogBrewProvider` から受け取ります。プロバイダーがないと、フォールバックは表示しましたが何も送らず、`onCaptureError` は `captureReactError requires a client` を受け取りました。`onError` は捕捉の後に実行されるので、そこで flush します。

```bash
import { LogBrewErrorBoundary, LogBrewProvider } from "@logbrew/react";
import { client, send } from "./logbrew.js";
import { TapList } from "./TapList.jsx";

export function App() {
  return (
    <LogBrewProvider client={client}>
      <LogBrewErrorBoundary
        fallback={({ error, resetError }) => (
          <div role="alert">
            <p>Could not load the taps: {error.message}</p>
            <button onClick={resetError}>Try Again</button>
          </div>
        )}
        onError={send}
      >
        <TapList />
      </LogBrewErrorBoundary>
    </LogBrewProvider>
  );
}
```

出力

```text
sent {"statusCode":200,"attempts":1,"batches":1}
```

### どのバウンダリも捕捉しなかったエラーを捕捉する

`createLogBrewReactRootOptions()` は `createRoot` にエラー用のコールバックを渡します。バウンダリのないレンダーエラーもこれで記録されました。`LogBrewErrorBoundary` が送信済みのエラーは飛ばすので、各エラーは 1 回だけ届きます。

```bash
import { createRoot } from "react-dom/client";
import { createLogBrewReactRootOptions } from "@logbrew/react";
import { client, send } from "./logbrew.js";
import { TapList } from "./TapList.jsx";

createRoot(
  document.getElementById("root"),
  createLogBrewReactRootOptions(client, { onUncaughtError: send })
).render(<TapList />);
```

出力

```text
sent {"statusCode":200,"attempts":1,"batches":1}
```

### ハンドラーのエラーを captureReactError() で報告する

ハンドラーのエラーは、バウンダリにもルートのコールバックにも届きません。そこで捕捉して `captureReactError()` に渡します。渡した `metadata` は問題に残ります。

```bash
import { captureReactError } from "@logbrew/react";
import { client, send } from "./logbrew.js";

export function PayButton() {
  async function pay() {
    try {
      await Promise.resolve();
      throw new Error("payment declined");
    } catch (error) {
      captureReactError(client, error, { metadata: { action: "pay" } });
      send();
    }
  }

  return <button onClick={pay}>Pay</button>;
}
```

出力

```text
sent {"statusCode":200,"attempts":1,"batches":1}
```

### 問題を読み戻す

読み取りキーでプロジェクトを読みました。バウンダリ内のレンダーエラーと、バウンダリなしの同じエラーはどちらも `TapList.jsx` から来たので、発生 2 回の 1 件の問題になりました。ハンドラーのエラーは別の問題になりました。

```bash
logbrew issues --since 3h
```

出力

```text
Issues (2)
- 1613a62e-31a3-5045-a144-c9c593760bff unresolved error priority=medium React error: payment declined occurrences=1 users=unknown last_seen=2026-11-21T06:35:49.154Z service=unknown_service trace=2ca253b519dfa2866268889760e5f2a0 assignee=unassigned [unversioned / production]
- f9eb7448-fab2-5d52-82f3-592a3b680a08 unresolved error priority=medium React error: Cannot read properties of undefined (reading 'map') occurrences=2 users=unknown last_seen=2026-11-21T06:35:43.870Z service=unknown_service trace=225e883023acc9c768da676fedd8e2c1 assignee=unassigned [unversioned / production]
```

## 実際に試して確認したこと

React 19.3.1 と @logbrew/react 0.1.6 で Vite のアプリを 1 つ作り、ローカルの LogBrew サーバーを使って Chrome で各ケースを実行しました。上の出力は Vite の開発サーバーのものです。本番ビルドでも同じケースを実行し、同じ結果になりました。

バウンダリに届いたのは、レンダー中と `useEffect` の中のエラーだけでした。`onClick` の中と `await` の後のエラーは、どのバウンダリにもルートのコールバックにも届きませんでした。それらを送れたのは `captureReactError()` だけでした。

|  | `LogBrewErrorBoundary` | `onUncaughtError` |
| --- | --- | --- |
| バウンダリ内のレンダーエラー | はい | いいえ |
| バウンダリなしのレンダーエラー | いいえ | はい |
| イベントハンドラーのエラー | いいえ | いいえ |

## バウンダリをリセットして再試行する

`LogBrewErrorBoundary` のフォールバックは `resetError` を受け取り、これで子コンポーネントをもう一度レンダーします。子がまたエラーを投げると、バウンダリはフォールバックを再表示し、イベントをもう 1 件送ります。

そのため、再試行の前に原因を直します。たとえばデータを読み込み直します。私たちのテストでは、データがそろっていれば再試行でリストがレンダーされました。

|  | フォールバック表示 | イベント送信 |
| --- | --- | --- |
| 最初のレンダーエラー | はい | はい |
| `Try Again`、子がまたエラーを投げる | はい | はい |
| `Try Again`、子がレンダーされる | いいえ | いいえ |

## LogBrew が記録する内容

React の各エラーは、`React error:` とメッセージをタイトルにした問題になります。バウンダリはメカニズム `react.error_boundary` を `handled: true` で記録します。ルート用のオプションは `react.uncaught_error` を `handled: false` で記録します。

LogBrew は React のエラーを、エラーの型と最初のスタックフレームのファイルでまとめます。私たちの本番ビルドでは、`keg sensor offline` や `tap list not loaded` のようにメッセージの違う 5 件の `Error` イベントが 1 つのバンドルファイルから来て、1 件の問題になりました。開発中はコンポーネントごとに別ファイルなので、問題も別々のままでした。

- `LogBrewErrorBoundary`
  - `mechanism`: `react.error_boundary`
  - `handled`: `true`
  - 問題: `React error: Cannot read properties of undefined (reading 'map')`
- `createLogBrewReactRootOptions()`
  - `mechanism`: `react.uncaught_error`
  - `handled`: `false`
  - スタックフレーム: 10
- `captureReactError()`
  - 問題: `React error: payment declined`
  - `metadata.action`: `pay`
  - グループ化キー: `react.error:Error:…/HandlerButton.jsx`

## よくある質問

### React のエラーバウンダリとは何ですか？

`getDerivedStateFromError` か `componentDidCatch` を持つクラスコンポーネントです。子がレンダー中にエラーを投げると、React はバウンダリのフォールバックを表示し、ページの残りを保ちます。

### エラーバウンダリはフックで書けますか？

書けません。React にはこのためのフックがないので、バウンダリはクラスになります。1 回だけ書くか `LogBrewErrorBoundary` を使い、関数コンポーネントを囲みます。

### エラーバウンダリがエラーを捕捉しないのはなぜですか？

エラーがレンダーの外で投げられたためです。多くはイベントハンドラーの中か `await` の後です。その場で捕捉して `captureReactError()` で報告するか、state に保存してレンダー中に投げます。

### エラーバウンダリはどこに置けばよいですか？

データを読み込むリストのように、単独で失敗しうるページの各部分を囲みます。そうすればページの残りは動き続けます。ルートの近くにも 1 つ置きます。どのバウンダリも捕捉しないエラーはツリー全体を消すためです。

### エラーバウンダリのエラーを記録するにはどうしますか？

`componentDidCatch` から送るか、`LogBrewProvider` の中で `LogBrewErrorBoundary` を使います。どのバウンダリも捕捉しなかったエラーのために、`createRoot` に `createLogBrewReactRootOptions()` を追加します。

## React の各エラーをコンポーネントスタックつきで確認する

LogBrew は React の各レンダーエラーをコンポーネントスタックつきで記録し、繰り返し起きたものを 1 件の問題にまとめます。十分な無料プランで始められ、カードは不要です。

[無料で始める](https://logbrew.co/ja)

## 出典

- [React docs, Catching rendering errors with an Error Boundary](https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary)
- [React docs, createRoot parameters](https://react.dev/reference/react-dom/client/createRoot#parameters)
- [reactjs/react.dev#8157](https://github.com/reactjs/react.dev/issues/8157)

## エージェント、Python、Node.js、React のその他のガイド

- [Claude Code と Codex に MCP サーバーを追加する](https://logbrew.co/ja/guides/mcp-server-claude-code-codex)
- [Claude Code と Codex で AGENTS.md を使う](https://logbrew.co/ja/guides/agents-md)
- [Claude の overloaded エラー 529 とレート制限エラー 429 を解決する](https://logbrew.co/ja/guides/claude-overloaded-rate-limit-error)
- [Python logging を正しいログレベルと例外の記録つきで設定する](https://logbrew.co/ja/guides/python-logging)
- [構造化ログ（structured logging）でフィールドから検索できるログの書式とログレベルを整える](https://logbrew.co/ja/guides/structured-logging)
- [Node.js のログを Pino か Winston でエラーを失わずに設定する](https://logbrew.co/ja/guides/node-logging)
- [Django のログを設定してすべての 500 エラーのトレースバックを残す](https://logbrew.co/ja/guides/django-logging)
- [FastAPI のログを設定してトレースバックを失わずにエラーを処理する](https://logbrew.co/ja/guides/fastapi-logging)
- [トレース ID とスパン ID の違いを実際の traceparent ヘッダーで解読](https://logbrew.co/ja/guides/trace-id)
- [Minified React error #418 と #185 を完全なメッセージと自分のコードの行から解決する](https://logbrew.co/ja/errors/minified-react-error)
- [エラー、ログ、トレース、メトリクス、リリースのガイド](https://logbrew.co/ja/guides)
