---
title: "Minified React error #418과 #185를 전체 메시지와 내 코드 줄로 해결하기"
description: "Minified React error는 더 긴 메시지를 대신하는 번호예요. 출력된 react.dev/errors 링크를 열면 전체 메시지를 읽을 수 있어요. Next.js 16에서 #418과 #185를 직접 일으키고 둘 다 고쳤어요."
canonical: "https://logbrew.co/ko/errors/minified-react-error"
last_updated: "2026-11-20"
---

# Minified React error #418과 #185를 전체 메시지와 내 코드 줄로 해결하기

Minified React error는 더 긴 메시지를 대신하는 번호예요. 출력된 `react.dev/errors` 링크를 열면 전체 메시지를 읽을 수 있어요. Next.js 16에서 #418과 #185를 직접 일으키고 둘 다 고쳤어요.

Next.js 16.4.6, React 19.2.7, Chrome 157 및 @logbrew/next 0.1.18 환경에서 2026년 11월 20일에 테스트

글 [Furkan Erday](https://github.com/furkanerday). LogBrew 창업자 Furkan Erday. 매일 Claude Code와 Codex로 LogBrew를 만들어요.

Canonical: https://logbrew.co/ko/errors/minified-react-error

## error boundary가 잡은 React 오류

| 오류를 던진 위치 | boundary가 잡음 | 브라우저에 실제 메시지 |
| --- | --- | --- |
| 클라이언트 컴포넌트 렌더링 | 네 | 네 |
| `useEffect` | 네 | 네 |
| `onClick` 핸들러 | 아니요 | 네 |
| `setTimeout` 콜백 | 아니요 | 네 |
| async 핸들러의 `await` 뒤 | 아니요 | 네 |
| Server Component | 네 | 아니요, `#441`과 digest |

React 19.2.7을 쓰는 Next.js 16.4.6 프로덕션 빌드 1개에서 낸 오류 6개.

## 전체 메시지를 읽고 해당 줄 찾기

### 메시지에 있는 링크 열기

프로덕션 React는 메시지 본문을 번들에 넣지 않고 대신 번호와 링크를 출력해요. 그 링크를 여세요. `react.dev/errors` 페이지가 전체 메시지를 보여 주고 URL의 각 `args[]` 값을 채워 넣어요. `next dev`가 쓰는 개발 빌드는 전체 메시지를 바로 출력해요.

```bash
"use client";
export function RenderedAt() {
  return <p>Rendered at {Date.now()}</p>;
}
```

출력

```text
Error: Minified React error #418; visit https://react.dev/errors/418?args[]=text&args[]= for the full message or use the non-minified dev environment for full errors and additional helpful warnings.
```

### #418은 서버 HTML이 첫 렌더링과 맞지 않았다는 뜻

디코더는 #418을 `Hydration failed because the server rendered text didn't match the client`로 읽어요. `args[]=text`는 위의 `Date.now()` 예처럼 텍스트 노드가 달랐다는 뜻이에요. `args[]=HTML`은 요소가 달랐다는 뜻이에요. `<p>` 안에 `<div>`를 넣으면 `HTML`이 나왔는데, 브라우저가 `<div>` 앞에서 `<p>`를 닫기 때문이에요. 두 번의 실행 모두 React는 브라우저 쪽 내용을 렌더링했고 페이지는 계속 동작했어요.

```bash
export default function Page() { return <p>Order total <div>12 USD</div></p>; }
```

출력

```text
Error: Minified React error #418; visit https://react.dev/errors/418?args[]=HTML&args[]= for the full message or use the non-minified dev environment for full errors and additional helpful warnings.
```

### React 19.2에서는 #423이 나오지 않음

디코더는 #423을 `There was an error while hydrating but React was able to recover by instead client rendering the entire root.`로 읽어요. React 19.2.7에서 불일치를 3가지 만들었고 그중 1가지는 `<Suspense>` 안이었는데, React는 매번 #418을 출력했고 #423은 한 번도 나오지 않았어요. 로그에 #423이 있다면 #418과 같은 원인을 찾아보세요.

### #185는 렌더링할 때마다 state를 바꾸는 layout effect에서 생김

디코더는 #185를 `Maximum update depth exceeded`로 읽어요. 의존성 배열이 없는 `useLayoutEffect`가 렌더링할 때마다 state를 바꿨고, React는 #185로 루프를 멈췄고, Next.js는 페이지를 `This page couldn’t load`로 바꿨어요. 같은 코드를 `useEffect`에 넣으면 오류가 전혀 출력되지 않았어요. 2번 실행하는 동안 페이지를 읽은 시점의 카운터는 228,936과 231,224였어요.

```bash
"use client";
import { useLayoutEffect, useState } from "react";

export default function Page() {
  const [count, setCount] = useState(0);
  useLayoutEffect(() => {
    setCount(count + 1);
  });
  return <p>{count}</p>;
}
```

출력

```text
Error: Minified React error #185; visit https://react.dev/errors/185 for the full message or use the non-minified dev environment for full errors and additional helpful warnings.
```

### 소스 맵으로 스택을 내 파일까지 따라가기

`next.config`에 `productionBrowserSourceMaps: true`를 설정하고 다시 빌드하세요. Turbopack은 맵마다 고유한 해시 이름을 붙이기 때문에, `resolve.mjs`는 청크의 마지막 줄에서 이름을 읽은 뒤 Node에 내장된 `SourceMap` 클래스로 위치를 찾아요. #185 스택에서 React 밖에 있는 유일한 프레임 `2-5_qr0vv7do_.js:1:254`를 넣었더니 페이지 7번째 줄의 `setCount`를 가리켰어요.

```bash
// node resolve.mjs <chunk.js> <line> <column>
import { readFileSync } from "node:fs";
import { SourceMap } from "node:module";
import { dirname, join } from "node:path";

const [chunk, line, column] = process.argv.slice(2);
const mapName = readFileSync(chunk, "utf8").match(/sourceMappingURL=(\S+)\s*$/)[1];
const map = new SourceMap(JSON.parse(readFileSync(join(dirname(chunk), mapName), "utf8")));
const { originalSource, originalLine, originalColumn, name } = map.findEntry(line - 1, column - 1);
console.log(`${name ?? "?"} ${originalSource}:${originalLine + 1}:${originalColumn + 1}`);
```

출력

```text
setCount turbopack:///[project]/app/loop-layout-effect/page.tsx:7:5
```

## 원인을 고치고 나머지는 잡기

### #418은 서버와 첫 로드에서 같은 결과를 렌더링해서 고치기

`Date.now()`, `window`, `localStorage`처럼 브라우저에만 있는 값은 `useEffect` 안에서 읽으세요. 이 effect는 하이드레이션 후 브라우저에서만 실행되므로 첫 렌더링이 서버 HTML과 일치하고, 저희 실행에서는 #418이 사라졌어요. `<p>` 안의 `<div>`는 2개 태그 중 1개를 바꾸세요. `<p>` 안에 `<span>`을 넣었을 때는 오류가 나지 않았어요.

```bash
"use client";
import { useEffect, useState } from "react";

export function RenderedAt() {
  const [renderedAt, setRenderedAt] = useState<number | null>(null);
  useEffect(() => setRenderedAt(Date.now()), []);
  return <p>Rendered at {renderedAt ?? "…"}</p>;
}
```

### `suppressHydrationWarning`은 맞출 수 없는 값 1개에만 쓰기

`suppressHydrationWarning`으로 저희 실행의 #418은 멈췄지만, 페이지는 서버 쪽 텍스트를 그대로 유지했어요. 브라우저 시각이 아니라 빌드 시각이 표시됐어요. 1단계 깊이에만 적용되고, React는 이를 비상 탈출구라고 불러요.

```bash
"use client";
export function RenderedAt() {
  return <p suppressHydrationWarning>Rendered at {Date.now()}</p>;
}
```

### #185는 effect에 의존성 배열을 줘서 고치기

`[]`를 주자 layout effect가 한 번만 실행됐고 페이지는 오류 없이 1을 표시했어요. effect가 읽는 값을 배열에 넣고, 그중 하나가 바뀌었을 때만 state를 바꾸세요.

```bash
"use client";
import { useLayoutEffect, useState } from "react";

export default function Page() {
  const [count, setCount] = useState(0);
  useLayoutEffect(() => {
    setCount(count + 1);
  }, []);
  return <p>{count}</p>;
}
```

### 렌더링 오류는 error boundary로 잡기

error boundary는 클래스 컴포넌트예요. `getDerivedStateFromError`가 대체 화면으로 전환하고, `componentDidCatch`가 오류를 보고해요. 저희 boundary는 렌더링 중 `taps.map`에서 난 `TypeError`와 `useEffect`에서 던진 오류를 잡았어요. `onClick` 핸들러, `setTimeout` 콜백, async 핸들러의 `await` 뒤에서 던진 오류는 놓쳤어요. 이 오류들은 잡히지 않은 오류로 window에 도달했으니, 오류를 던지는 곳에서 잡으세요.

```bash
"use client";
import { Component, type ReactNode } from "react";

export class ErrorBoundary extends Component<{ children: ReactNode }, { error: Error | null }> {
  state: { error: Error | null } = { error: null };

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

  componentDidCatch(error: Error) {
    console.error("ErrorBoundary caught:", error.message);
  }

  render() {
    if (this.state.error) return <p>This part of the page failed to load.</p>;
    return this.props.children;
  }
}
```

출력

```text
ErrorBoundary caught: Cannot read properties of undefined (reading 'map')
```

### Next.js에서는 `error.tsx`를 추가하고 오류를 LogBrew로 보내기

Next.js는 각 라우트 세그먼트를 `error.tsx`를 렌더링하는 error boundary로 감싸요. 저희 `error.tsx`가 같은 렌더링 오류를 잡았고, `@logbrew/next`의 `captureNextClientError()`가 이를 이슈 1개로 보냈어요. 데모는 기록용 transport를 넘겨요. `transport`를 빼면 클라이언트가 `fetch`로 LogBrew에 보내요.

```bash
// app/next-error.tsx
"use client";
import { useEffect } from "react";
import { captureNextClientError, createLogBrewNextBrowserClient } from "@logbrew/next/client";
import { RecordingTransport } from "@logbrew/sdk";

const transport = RecordingTransport.alwaysAccept();
const logbrew = createLogBrewNextBrowserClient({
  clientKey: process.env.NEXT_PUBLIC_LOGBREW_CLIENT_KEY,
  transport
});

export function ReportError({ error, route }: { error: Error & { digest?: string }; route: string }) {
  useEffect(() => {
    void captureNextClientError(logbrew, error, { routeTemplate: route }).then((response) => {
      console.log(JSON.stringify(response));
      console.log(transport.lastBody());
    });
  }, [error, route]);
  return <p>This page failed to load.</p>;
}

// app/next-boundary/error.tsx
"use client";
import { ReportError } from "../next-error";

export default function Error({ error }: { error: Error & { digest?: string } }) {
  return <ReportError error={error} route="/next-boundary" />;
}
```

출력

```text
{"statusCode":202,"attempts":1,"batches":1}
```

## 직접 테스트해 보니

React 19.2.7을 쓰는 Next.js 16.4.6 앱 1개를 Turbopack과 `next build`로 빌드하고, `next start`로 띄운 뒤, 각 페이지를 헤드리스 Chrome 157에서 열었어요. 하이드레이션 불일치 3가지, 업데이트 루프 2가지, 여러 위치의 오류 6가지를 만든 다음, 같은 빌드에서 각 수정 방법을 실행했어요.

하이드레이션 불일치는 모두 #418을 출력했고 #423은 한 번도 나오지 않았어요. #185를 출력한 건 layout effect 루프뿐이었어요. error boundary는 오류 6개 중 3개를 잡았고, 브라우저는 그중 5개에서 실제 메시지를 받았어요.

Server Component 오류는 예외예요. 페이지는 500으로 응답했고, 브라우저는 저희 메시지 대신 `digest`가 `1331393307`인 `Minified React error #441`을 받았어요. 서버 로그에는 같은 digest와 함께 `Orders database is down`이 출력됐으니, digest를 따라가면 실제 오류를 찾을 수 있어요.

출력

```text
⨯ Error: Orders database is down
    at b (.next/server/chunks/ssr/[root-of-the-server]__0e6swfn4zoar-._.js:1:1281) {
  digest: '1331393307'
}
```

## 프로덕션 React가 메시지 대신 번호를 출력하는 이유

React 프로덕션 빌드는 보내는 바이트를 줄이려고 각 오류의 코드만 남겨요. 본문은 React 저장소의 `scripts/error-codes/codes.json`에 있고, 디코더 페이지가 URL에서 인수를 채워 넣어요. #441은 달라요. React는 프로덕션 빌드에서 Server Component의 메시지를 일부러 빼서, 서버의 세부 정보가 브라우저에 전달되지 않게 해요.

스택도 압축돼 있어요. #418에는 소스 맵이 별로 도움이 되지 않아요. 저희 #418 스택의 모든 프레임은 `react-dom-client.production.js`를 가리켰고, 저희 코드를 가리킨 프레임은 없었어요. `args[]` 값과 마지막으로 바꾼 컴포넌트가 원인을 더 빨리 알려 줘요.

vercel/next.js#50245를 보면 해독한 메시지가 왜 중요한지 알 수 있어요. 이 이슈는 2023년 5월에 프로덕션에서만 나는 Minified React error를 보고했어요. 한 메인테이너는 스레드에 있는 사람들이 같은 메시지 뒤에서 아마 서로 다른 문제를 겪고 있을 거라고 썼고, 이슈는 재현 없이 2024년 8월에 닫혔어요. 해독한 메시지와 소스 줄이 있으면 이런 경우를 구분할 수 있어요.

## LogBrew가 기록하는 것

`captureNextClientError()`는 레벨 `error`, 제목 `TypeError`인 이슈 1개를 메시지, 메커니즘 `nextjs.error_boundary`, `handled: false`와 함께 보냈어요. 스택 프레임 10개를 저장했고, 각 프레임에는 파일, 줄, 열, 함수가 들어 있었어요. 첫 프레임은 `19k2sxe-2yvvy.js`의 1번째 줄 220번째 열이었고, 소스 맵으로 바꾸니 페이지 5번째 줄의 `taps.map`이었어요.

LogBrew는 오류 타입과 이 첫 프레임으로 반복되는 오류를 묶어요. 키는 `nextjs.error_boundary:TypeError:` 뒤에 청크 URL이 붙은 형태예요. 이슈에는 메시지 본문이 남았고, 원인 체인 항목은 메시지를 `redacted`로 표시했어요.

Server Component 오류의 이슈에는 #441 메시지와 `errorDigest` `1331393307`이 담겼고, 서버 로그와 같은 값이었어요. 브라우저가 서버 스택을 받은 적이 없어서 체인에는 `stackFramesState: "not_captured"`가 기록됐어요.

## 자주 묻는 질문

### Minified React error는 무엇인가요?

React 프로덕션 빌드에서 나는 오류예요. React는 메시지를 번호와 `react.dev/errors` 링크로 바꾸고, 그 페이지가 전체 메시지를 보여 줘요. 개발 빌드는 전체 메시지를 바로 출력해요.

### Minified React error #418은 무슨 뜻인가요?

하이드레이션이 실패했다는 뜻이에요. 서버에서 온 HTML이 브라우저의 첫 렌더링과 맞지 않았어요. `args[]=text`는 텍스트 노드를, `args[]=HTML`은 요소를 가리켜요. `Date.now()`, `typeof window` 검사, 사용자 로케일로 표시한 날짜, `<p>` 안의 `<div>`가 원인이 돼요.

### Next.js 레이아웃의 하이드레이션 오류는 어떻게 고치나요?

다른 컴포넌트처럼 그 레이아웃에서 서버와 브라우저 사이에 무엇이 다른지 찾으세요. 루트 레이아웃에서는 React가 로드되기 전에 `<html>`이나 `<body>`를 바꾸는 테마 스크립트나 브라우저 확장 프로그램도 원인이 돼요. 그 요소에 `suppressHydrationWarning`을 달면 1단계 깊이까지 오류를 숨겨요.

### Minified React error #185는 무슨 뜻인가요?

최대 업데이트 깊이를 넘었다는 뜻이에요. React가 업데이트를 적용하는 동안 컴포넌트가 state를 계속 바꿨어요. 저희 실행에서는 의존성 배열이 없는 `useLayoutEffect`가 원인이었어요. 의존성 배열을 추가하거나, 값이 바뀌었을 때만 state를 바꾸세요.

### error boundary가 잡지 못하는 오류는 무엇인가요?

저희 실행에서는 `onClick` 핸들러, `setTimeout` 콜백, `await` 뒤에서 던진 오류를 놓쳤어요. 렌더링, `useEffect`, Server Component의 오류는 잡았지만, 마지막 오류는 메시지 없이 #441로 도착했어요.

### ChatGPT나 다른 웹사이트에서 Minified React error가 보이는 이유는 무엇인가요?

그 사이트가 React 프로덕션 빌드를 쓰고 있고, 코드에서 오류가 났기 때문이에요. 그 코드는 사이트 개발자만 고칠 수 있어요. React가 로드되기 전에 페이지를 바꾸는 브라우저 확장 프로그램도 #418을 일으킬 수 있으니, 확장 프로그램을 끈 시크릿 창에서 열어 보세요.

## 프로덕션의 모든 React 오류 잡기

LogBrew Next.js SDK는 error.tsx에 도달한 오류마다 스택 프레임과 서버 digest를 함께 보내고, LogBrew는 반복되는 오류를 이슈 1개로 모아요. 넉넉한 무료 요금제로 시작하세요. 카드 등록은 필요 없어요.

[무료로 시작](https://logbrew.co/ko)

## 출처

- [React docs, Error decoder](https://react.dev/errors)
- [React docs, Catching rendering errors with an error boundary](https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary)
- [React docs, Common props (suppressHydrationWarning)](https://react.dev/reference/react-dom/components/common#common-props)
- [Next.js docs, Text content does not match server-rendered HTML](https://nextjs.org/docs/messages/react-hydration-error)
- [Next.js docs, error.js](https://nextjs.org/docs/app/api-reference/file-conventions/error)
- [Next.js docs, productionBrowserSourceMaps](https://nextjs.org/docs/app/api-reference/config/next-config-js/productionBrowserSourceMaps)
- [vercel/next.js#50245](https://github.com/vercel/next.js/issues/50245)

## 오류 해결법 더 보기

- [메시지와 파일, 줄을 숨기는 스크립트 오류 Script error 해결하기](https://logbrew.co/ko/errors/script-error)
- [Failed to fetch 오류를 고치고 원인 3가지를 구분하는 방법](https://logbrew.co/ko/errors/failed-to-fetch)
- [Kotlin과 Android의 java.lang.NullPointerException을 메시지로 해결하기](https://logbrew.co/ko/errors/nullpointerexception)
- [직접 재현한 오류와 각각의 해결법](https://logbrew.co/ko/errors)
