---
title: "Thêm error boundary cho React và ghi log những lỗi mà nó bỏ lọt"
description: "Error boundary của React bắt lỗi trong lúc render và hiện fallback. Đây là class, những lỗi nó bỏ lọt và cách gửi từng lỗi đến LogBrew, đã thử trên React 19.3."
canonical: "https://logbrew.co/vi/guides/react-error-boundary"
last_updated: "2026-11-21"
---

# Thêm error boundary cho React và ghi log những lỗi mà nó bỏ lọt

Error boundary của React bắt lỗi trong lúc render và hiện fallback. Đây là class, những lỗi nó bỏ lọt và cách gửi từng lỗi đến LogBrew, đã thử trên React 19.3.

Đã thử nghiệm ngày 21 tháng 11, 2026 với React 19.3.1, Vite 8.3.8, Chrome 156, @logbrew/react 0.1.6, @logbrew/sdk 0.1.47 và logbrew CLI 0.1.96

Tác giả [Furkan Erday](https://github.com/furkanerday). Furkan Erday là nhà sáng lập LogBrew. Anh xây dựng LogBrew bằng Claude Code và Codex mỗi ngày.

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

## Lỗi React nào hiện fallback và đến được LogBrew

| Nơi lỗi bị ném | Hiện fallback | Vấn đề trong LogBrew |
| --- | --- | --- |
| Render, bên trong `LogBrewErrorBoundary` | Có | Có |
| `useEffect`, bên trong boundary | Có | Có |
| Render, không có boundary | Không, root trống | Có, từ các tùy chọn root |
| Handler `onClick` | Không | Không |
| Handler async, sau `await` | Không | Không |
| `onClick` với `captureReactError()` | Không | Có |

6 lỗi trong 1 bản build production của Vite với React 19.3.1 và @logbrew/react 0.1.6.

## Viết một error boundary

### Viết boundary dưới dạng class component

React không có hook cho việc này, nên error boundary là một class. `getDerivedStateFromError` chuyển nó sang fallback ở lần render kế tiếp. `componentDidCatch` nhận lỗi và `info.componentStack`, tức danh sách component phía trên component đã ném lỗi.

```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;
  }
}
```

### Bọc phần trang có thể hỏng

`TapList` đọc `taps.map` khi thiếu `taps`, nên nó ném lỗi trong lúc render. Boundary hiện `Could not load the taps.`, và tiêu đề `Taproom` vẫn còn. Khi phát triển, React cũng in lỗi kèm `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>
  );
}
```

Kết quả

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

### Lỗi trong trình xử lý sự kiện đi vòng qua boundary

React gọi `onClick` bên ngoài render, nên boundary không bao giờ nhận được lỗi. Nút vẫn còn trên trang, và trình duyệt in một lỗi chưa được bắt. Lỗi sau `await` cũng vậy.

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

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

Kết quả

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

### Chuyển lỗi của handler cho boundary qua state

Bắt lỗi trong handler, lưu nó bằng `setError` và ném nó ở lần render kế tiếp. Khi đó boundary hiện fallback và nhận lỗi trong `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>;
}
```

Kết quả

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

### Không có boundary, React gỡ cả cây

Khi không boundary nào bắt lỗi render, React 19 gỡ root. Phần tử `root` trống, và tiêu đề cũng mất. React in lỗi và một cảnh báo đề nghị thêm error boundary.

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

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

Kết quả

```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.
```

## Gửi lỗi React đến LogBrew

### Cài các gói

`@logbrew/react` cung cấp provider, error boundary và các tùy chọn root. Dùng một khóa trình duyệt của dự án LogBrew của bạn làm `clientKey`.

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

### Tạo client và một transport

Client giữ các sự kiện trong hàng đợi cho đến khi bạn gọi `client.flush(transport)`. Transport phải trả về `{ statusCode }`. Khi transport của chúng tôi trả về phản hồi `fetch`, flush thất bại với `invalid transport response`. Đặt `VITE_LOGBREW_ENDPOINT` thành `https://api.logbrew.co/v1/events`. Chúng tôi gửi đến một server LogBrew cục bộ.

```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)));
}
```

### Đặt LogBrewErrorBoundary bên trong LogBrewProvider

`LogBrewErrorBoundary` lấy client từ `LogBrewProvider`. Khi không có provider, nó hiện fallback nhưng không gửi gì, và `onCaptureError` nhận `captureReactError requires a client`. `onError` chạy sau khi bắt lỗi, nên hãy 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>
  );
}
```

Kết quả

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

### Bắt những lỗi mà không boundary nào bắt

`createLogBrewReactRootOptions()` cung cấp các callback lỗi cho `createRoot`. Nó đã ghi lại lỗi render không có boundary. Nó bỏ qua những lỗi mà `LogBrewErrorBoundary` đã gửi, nên mỗi lỗi chỉ đến 1 lần.

```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 />);
```

Kết quả

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

### Báo lỗi của handler bằng captureReactError()

Cả boundary lẫn callback của root đều không nhận lỗi từ handler, nên hãy bắt lỗi đó và truyền vào `captureReactError()`. `metadata` bạn truyền vào sẽ nằm trên vấn đề.

```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>;
}
```

Kết quả

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

### Đọc lại các vấn đề

Chúng tôi đọc dự án bằng một khóa đọc. Lỗi render trong boundary và cùng lỗi đó khi không có boundary đều đến từ `TapList.jsx`, nên chúng thành 1 vấn đề với 2 lần xảy ra. Lỗi của handler thành một vấn đề riêng.

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

Kết quả

```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]
```

## Kết quả khi chúng tôi thử nghiệm

Chúng tôi tạo 1 ứng dụng Vite với React 19.3.1 và @logbrew/react 0.1.6, rồi chạy từng trường hợp trong Chrome với một server LogBrew cục bộ. Các output ở trên đến từ dev server của Vite. Chúng tôi chạy lại các trường hợp đó trên bản build production, và kết quả giống nhau.

Chỉ lỗi trong lúc render và trong `useEffect` mới đến được boundary. Lỗi trong `onClick` và sau `await` không đến boundary nào và không đến callback nào của root. Chỉ `captureReactError()` gửi được chúng.

|  | `LogBrewErrorBoundary` | `onUncaughtError` |
| --- | --- | --- |
| Lỗi render bên trong boundary | Có | Không |
| Lỗi render không có boundary | Không | Có |
| Lỗi trong trình xử lý sự kiện | Không | Không |

## Đặt lại boundary và thử lại

Fallback của `LogBrewErrorBoundary` nhận `resetError`, hàm này render lại các component con. Nếu component con lại ném lỗi, boundary lại hiện fallback và gửi thêm 1 sự kiện.

Vì vậy hãy sửa nguyên nhân trước khi thử lại, ví dụ tải lại dữ liệu. Trong lần chạy của chúng tôi, lần thử lại đã render danh sách khi dữ liệu có sẵn.

|  | Fallback được hiện | Sự kiện được gửi |
| --- | --- | --- |
| Lỗi render đầu tiên | Có | Có |
| `Try Again`, component con lại ném lỗi | Có | Có |
| `Try Again`, component con render được | Không | Không |

## LogBrew ghi lại những gì

Mỗi lỗi React thành một vấn đề có tiêu đề `React error:` và thông điệp của lỗi. Boundary ghi cơ chế `react.error_boundary` với `handled: true`. Các tùy chọn root ghi `react.uncaught_error` với `handled: false`.

LogBrew nhóm lỗi React theo loại lỗi và file của stack frame đầu tiên. Trong bản build production của chúng tôi, 5 sự kiện `Error` với thông điệp khác nhau, như `keg sensor offline` và `tap list not loaded`, đến từ 1 file bundle và thành 1 vấn đề. Khi phát triển, mỗi component là một file riêng, nên các vấn đề vẫn tách rời.

- `LogBrewErrorBoundary`
  - `mechanism`: `react.error_boundary`
  - `handled`: `true`
  - Vấn đề: `React error: Cannot read properties of undefined (reading 'map')`
- `createLogBrewReactRootOptions()`
  - `mechanism`: `react.uncaught_error`
  - `handled`: `false`
  - Stack frame: 10
- `captureReactError()`
  - Vấn đề: `React error: payment declined`
  - `metadata.action`: `pay`
  - Khóa gom nhóm: `react.error:Error:…/HandlerButton.jsx`

## Câu hỏi thường gặp

### Error boundary trong React là gì?

Một class component có `getDerivedStateFromError` hoặc `componentDidCatch`. Khi một component con ném lỗi trong lúc render, React hiện fallback của boundary và giữ phần còn lại của trang.

### Có thể viết error boundary bằng hook không?

Không. React không có hook cho việc này, nên boundary là một class. Viết nó 1 lần, hoặc dùng `LogBrewErrorBoundary`, rồi đặt nó bao quanh các function component.

### Vì sao error boundary của tôi không bắt được lỗi?

Lỗi bị ném bên ngoài render, thường là trong trình xử lý sự kiện hoặc sau `await`. Bắt lỗi ở đó và báo nó bằng `captureReactError()`, hoặc lưu nó vào state rồi ném trong lúc render.

### Nên đặt error boundary ở đâu?

Bao quanh từng phần của trang có thể hỏng riêng, như một danh sách tải dữ liệu, để phần còn lại của trang vẫn chạy. Đặt thêm 1 cái gần root, vì một lỗi không boundary nào bắt sẽ gỡ cả cây.

### Làm sao ghi log lỗi từ error boundary?

Gửi chúng từ `componentDidCatch`, hoặc dùng `LogBrewErrorBoundary` bên trong `LogBrewProvider`. Thêm `createLogBrewReactRootOptions()` vào `createRoot` cho những lỗi mà không boundary nào bắt.

## Xem mọi lỗi React cùng component stack của nó

LogBrew ghi mỗi lỗi render của React kèm component stack, và gộp các lần lặp lại thành 1 vấn đề. Bắt đầu với gói miễn phí rộng rãi, không cần thẻ.

[Bắt đầu miễn phí](https://logbrew.co/vi)

## Nguồn

- [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)

## Thêm hướng dẫn cho agent, Python, Node.js và React

- [Thêm máy chủ MCP vào Claude Code và Codex](https://logbrew.co/vi/guides/mcp-server-claude-code-codex)
- [Dùng AGENTS.md trong Claude Code và Codex](https://logbrew.co/vi/guides/agents-md)
- [Khắc phục lỗi Claude overloaded 529 và lỗi rate limit 429](https://logbrew.co/vi/guides/claude-overloaded-rate-limit-error)
- [Thiết lập Python logging với đúng mức log và bắt ngoại lệ kèm traceback](https://logbrew.co/vi/guides/python-logging)
- [Structured logging với định dạng log và mức log bạn tìm được theo trường](https://logbrew.co/vi/guides/structured-logging)
- [Thiết lập log cho Node.js với Pino hoặc Winston mà không mất lỗi nào](https://logbrew.co/vi/guides/node-logging)
- [Thiết lập logging Django và giữ traceback của mọi lỗi 500](https://logbrew.co/vi/guides/django-logging)
- [Thiết lập logging FastAPI và xử lý lỗi mà không mất traceback](https://logbrew.co/vi/guides/fastapi-logging)
- [Trace ID và span ID, giải mã từ một header traceparent thật](https://logbrew.co/vi/guides/trace-id)
- [Sửa Minified React error #418 và #185 từ thông điệp đầy đủ và dòng mã của bạn](https://logbrew.co/vi/errors/minified-react-error)
- [Hướng dẫn về lỗi, log, trace, chỉ số và bản phát hành](https://logbrew.co/vi/guides)
