---
title: "HTTP 499 오류를 해결하고 누가 먼저 기다리기를 멈췄는지 찾기"
description: "HTTP 499는 응답 전에 클라이언트가 연결을 닫으면 nginx가 기록하는 상태예요. 클라이언트는 이 상태를 보지 못하고, 저희 테스트에서 업스트림은 모든 요청을 끝까지 처리했어요."
canonical: "https://logbrew.co/ko/errors/http-499"
last_updated: "2026-11-21"
---

# HTTP 499 오류를 해결하고 누가 먼저 기다리기를 멈췄는지 찾기

HTTP 499는 응답 전에 클라이언트가 연결을 닫으면 nginx가 기록하는 상태예요. 클라이언트는 이 상태를 보지 못하고, 저희 테스트에서 업스트림은 모든 요청을 끝까지 처리했어요.

nginx 1.31.8, curl 8.7.1, Python 3.13.5 및 logbrew CLI 0.1.96 환경에서 2026년 11월 21일에 테스트

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

Canonical: https://logbrew.co/ko/errors/http-499

## 누가 먼저 기다리기를 멈췄고, nginx는 무엇을 기록했나

| 먼저 기다리기를 멈춘 쪽 | 클라이언트가 응답을 받음 | `499` 기록 |
| --- | --- | --- |
| 없음, 업스트림이 0.2초 만에 응답 | `200` | `200` |
| 클라이언트, 2초 후 | 아니요 | `499` |
| 클라이언트, 0.3초 후 | 아니요 | `499` |
| nginx, `proxy_read_timeout 3s` 후 | `504` | `504` |
| 클라이언트, nginx는 계속 대기 | 아니요 | `200` |

curl 8.7.1로 nginx 1.31.8을 거쳐 보낸 요청 5개. 마지막 요청은 `proxy_ignore_client_abort on`으로 실행.

## 누가 먼저 기다리기를 멈췄는지 찾기

### 액세스 로그에서 499 줄 찾기

nginx는 `499`를 액세스 로그에만 써요. 기본 `combined` 형식에서는 요청과 보낸 0바이트는 보이지만, 누가 얼마나 기다렸는지는 보이지 않아요.

출력

```text
127.0.0.1 - - [21/Nov/2026:17:09:07 +0300] "GET /api/report?delay=5 HTTP/1.1" 499 0 "-" "curl/8.7.1"
127.0.0.1 - - [21/Nov/2026:17:09:08 +0300] "GET /api/report?delay=1 HTTP/1.1" 499 0 "-" "curl/8.7.1"
```

### 양쪽이 기다린 시간 기록하기

`http` 블록에서 기본 로그 옆에 `log_format`을 추가하고 `$request_time`, `$upstream_status`, `$upstream_response_time`을 넣으세요. 그다음 `nginx -s reload`를 실행하세요.

```bash
log_format timing '$remote_addr "$request" $status $body_bytes_sent '
                  'request_time=$request_time '
                  'upstream_status=$upstream_status '
                  'upstream_response_time=$upstream_response_time';
access_log /var/log/nginx/timing.log timing;
```

### 499 줄마다 request_time 읽기

`request_time`은 클라이언트가 연결을 끊기 전까지 기다린 시간이에요. 저희 클라이언트는 2초와 0.3초 후에 포기했고, nginx는 2.006과 0.301을 기록했어요. 업스트림이 아직 응답하지 않았기 때문에 `upstream_status`는 `-`예요.

출력

```text
127.0.0.1 "GET /api/report?delay=5 HTTP/1.1" 499 0 request_time=2.006 upstream_status=- upstream_response_time=2.006
127.0.0.1 "GET /api/report?delay=1 HTTP/1.1" 499 0 request_time=0.301 upstream_status=- upstream_response_time=0.301
```

### 반복되는 값 하나 찾기

`request_time`이 거의 같은 499 줄이 많다면 nginx 앞에 고정된 타임아웃이 있다는 뜻이에요. 클라이언트 자체의 타임아웃이 그 예예요. `--max-time 2`를 쓴 클라이언트 3개에서 2.008~2.011초인 줄 3개가 나왔어요. 이 값을 같은 경로의 200 줄에 있는 `upstream_response_time`과 비교하세요. 업스트림이 이보다 오래 걸릴 때가 많다면 그 클라이언트에게는 너무 느린 거예요.

출력

```text
127.0.0.1 "GET /api/report?delay=4 HTTP/1.1" 499 0 request_time=2.011 upstream_status=- upstream_response_time=2.011
127.0.0.1 "GET /api/report?delay=4 HTTP/1.1" 499 0 request_time=2.011 upstream_status=- upstream_response_time=2.012
127.0.0.1 "GET /api/report?delay=4 HTTP/1.1" 499 0 request_time=2.008 upstream_status=- upstream_response_time=2.007
```

### 499와 504 구분하기

nginx가 먼저 기다리기를 멈추면 `504`를 기록하고, 클라이언트는 504 페이지를 받아요. 이때 `request_time`은 `proxy_read_timeout` 값(저희 테스트에서는 3초)이고, `upstream_status`는 `-`가 아니라 `504`예요. 오류 로그에는 `upstream timed out`이 남아요.

출력

```text
127.0.0.1 "GET /short/report?delay=5 HTTP/1.1" 504 167 request_time=3.001 upstream_status=504 upstream_response_time=3.001
2026/11/21 17:09:11 [error] 61151#0: *35 upstream timed out (60: Operation timed out) while reading response header from upstream, client: 127.0.0.1, server: , request: "GET /short/report?delay=5 HTTP/1.1", upstream: "http://127.0.0.1:28500/api/report?delay=5", host: "127.0.0.1:28499"
```

## 해결하기

### 클라이언트가 포기하기 전에 업스트림이 응답하게 하기

499 줄의 `request_time`이 같고 그 경로의 200 줄이 더 오래 걸린다면, 그 엔드포인트를 빠르게 만들거나 클라이언트의 타임아웃을 늘리세요. 저희의 0.301처럼 `request_time`이 짧다면 사용자가 페이지를 떠나는 등의 이유로 클라이언트가 직접 요청을 취소한 거예요.

### 아무도 기다리지 않는 작업 멈추기

nginx가 499로 기록한 요청 2개 모두에 대해 저희 업스트림은 200을 기록했어요. 클라이언트가 떠난 지 3초와 0.7초 뒤에 처리를 끝냈어요. nginx는 업스트림 연결을 닫았지만 업스트림은 알아차리지 못했어요. 오래 걸리는 핸들러에서 연결이 닫혔는지 확인하거나, 느린 작업을 백그라운드 작업으로 옮기세요.

출력

```text
14:09:05.796 upstream got /api/report?delay=5
14:09:07.822 upstream got /api/report?delay=1
14:09:08.827 upstream answered 200 after 1.0s
14:09:10.802 upstream answered 200 after 5.0s
```

### proxy_ignore_client_abort는 꺼 두기

`proxy_ignore_client_abort on`이면 curl이 2초 뒤에 연결을 끊었는데도 nginx는 업스트림을 기다렸고, `request_time`이 5.006인 `200`을 기록했어요. 로그에서 499가 사라진 거예요. 기본값은 `off`예요.

```bash
proxy_ignore_client_abort off;
```

출력

```text
127.0.0.1 "GET /keep/report?delay=5 HTTP/1.1" 200 12 request_time=5.006 upstream_status=200 upstream_response_time=5.006
```

### 499 줄을 LogBrew로 보내기

LogBrew에는 nginx 연동이 없지만 OTLP 로그는 받아요. 이 명령은 499와 504 줄을 하나씩 1개의 로그로 보내요. `LOGBREW_INGEST_KEY`에는 프로젝트의 `server` 키를 넣으세요. 로컬 LogBrew API가 `{}`를 반환했으니 모든 줄을 받은 거예요.

```bash
grep -E '" (499|504) ' /var/log/nginx/timing.log |
  jq -Rn '{resourceLogs: [{resource: {attributes: [{key: "service.name", value: {stringValue: "nginx"}}]}, scopeLogs: [{logRecords: [inputs | {severityText: "WARN", body: {stringValue: .}}]}]}]}' |
  curl -sS https://api.logbrew.co/v1/logs -H "x-logbrew-key: $LOGBREW_INGEST_KEY" \
    -H 'Content-Type: application/json' --data-binary @-
```

출력

```text
{}
```

### LogBrew CLI로 검색하기

각 줄은 레벨이 `warning`인 로그 1개가 되고, 메시지는 줄 전체예요. 경로나 시간 안의 499가 걸리지 않도록 검색할 때 499 앞뒤에 공백을 넣으세요.

```bash
logbrew read logs --project "<project_id>" --service nginx --search ' 499 ' --since 1h
```

출력

```text
Logs (2)
- warning 127.0.0.1 "GET /api/report?delay=1 HTTP/1.1" 499 0 request_time=0.301 upstream_status=- upstream_response_time=0.301 service=nginx trace=3ded5398edda96df764625b26d6274f2 [unversioned / production]
- warning 127.0.0.1 "GET /api/report?delay=5 HTTP/1.1" 499 0 request_time=2.006 upstream_status=- upstream_response_time=2.006 service=nginx trace=4ad4df7e9d1f37c7dc182a77a1e83012 [unversioned / production]
```

## 테스트에서 확인한 내용

macOS 27.2에서 nginx 1.31.8을 `127.0.0.1:28499`로 실행하고, 그 뒤에 Python 3.13 업스트림을 뒀어요. 업스트림은 `?delay=`에 적힌 초만큼 기다린 뒤 200으로 응답해요. curl 8.7.1로 요청 5개를 보냈고, 그중 3개에 `--max-time`을 붙였어요.

499 줄 2개 모두 `request_time`이 curl 타임아웃과 6 ms 이내로 맞았고, `upstream_status`는 `-`였어요. 504 줄에서는 `proxy_read_timeout`과 같았고, `upstream_status`는 `504`였어요.

|  | `$status` | `$request_time` | `$upstream_status` |
| --- | --- | --- | --- |
| 아무도 포기하지 않음 | `200` | 0.206초 | `200` |
| 클라이언트가 2초 후 포기 | `499` | 2.006초 | `-` |
| 클라이언트가 0.3초 후 포기 | `499` | 0.301초 | `-` |
| nginx가 3초 후 포기 | `504` | 3.001초 | `504` |
| 클라이언트는 포기, nginx는 계속 대기 | `200` | 5.006초 | `200` |

## 499가 nginx에서만 보이는 이유

499는 HTTP 상태 코드가 아니에요. RFC 9110이 정의한 4xx 코드에 499는 없어요. nginx는 `src/http/ngx_http_request.h`에서 이를 `NGX_HTTP_CLIENT_CLOSED_REQUEST`로 정의해요. nginx가 응답 헤더를 보내기 전에 연결을 닫은 클라이언트를 위한 값이에요.

클라이언트의 연결은 이미 닫혀 있으니 클라이언트가 499를 받는 일은 없어요. nginx는 업스트림 연결도 닫고, 액세스 로그에 `499`를 써요.

오류 로그의 기본 레벨인 `error`에서는 nginx가 499에 대해 다른 내용을 쓰지 않아요. 레벨 `info`에서는 `client prematurely closed connection`을 써요. 504는 레벨 `error`에서 보여요.

1. 클라이언트가 연결을 닫음
2. nginx가 업스트림 연결을 닫음
3. nginx가 액세스 로그에 499를 씀

## LogBrew가 기록하는 내용

LogBrew는 저희가 보낸 각 줄을 `nginx` 서비스의 로그 1개로, 레벨 `warning`으로 저장했어요. 줄 전체를 메시지로 두고 필드로 나누지 않으니, 텍스트로 검색하세요.

대시보드, CLI, MCP 서버는 이 로그를 다른 LogBrew 로그와 똑같이 읽어요.

- `nginx`
  - `level`: `warning`
  - 메시지: `… 499 0 request_time=0.301 …`
  - `trace`: `3ded5398edda96df764625b26d6274f2`

## 자주 묻는 질문

### HTTP 상태 코드 499는 무슨 뜻인가요?

nginx가 응답을 보내기 전에 클라이언트가 연결을 닫았고, nginx가 499를 기록했다는 뜻이에요. 이 상태는 HTTP에 속하지 않고, 클라이언트가 받는 일도 없어요.

### 499 오류는 클라이언트 탓인가요, 서버 탓인가요?

연결을 닫는 쪽은 클라이언트지만, 이유는 느린 업스트림인 경우가 많아요. 499 줄의 `request_time`을 같은 경로 200 줄의 `upstream_response_time`과 비교하세요.

### 499와 504는 어떻게 다른가요?

499는 클라이언트가 먼저 기다리기를 멈췄다는 뜻이에요. 504는 `proxy_read_timeout` 후에 nginx가 먼저 기다리기를 멈췄다는 뜻이고, 클라이언트는 504를 받아요.

### nginx에서 499 오류는 어떻게 해결하나요?

`request_time`에서 클라이언트의 타임아웃을 찾고, 업스트림이 그 전에 응답하게 하거나 그 타임아웃을 늘리세요. `proxy_ignore_client_abort on`은 로그에서 499를 숨길 뿐이에요.

### 업스트림은 클라이언트가 떠난 걸 아나요?

저희 테스트에서는 몰랐어요. nginx가 499로 기록한 요청 2개 모두에 대해 Python 업스트림은 200을 기록했고, 클라이언트가 떠난 뒤에 처리를 끝냈어요.

## 모든 499 줄을 1곳에서 검색

nginx 로그 줄을 OTLP 로그로 LogBrew에 보내고 대시보드, CLI, AI 에이전트에서 검색하세요. 넉넉한 무료 요금제로 시작하세요. 카드 등록은 필요 없어요.

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

## 출처

- [RFC 9110, HTTP Semantics, 15.5 Client Error 4xx](https://www.rfc-editor.org/rfc/rfc9110#section-15.5)
- [MDN, 504 Gateway Timeout](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/504)
- [LogBrew docs, Send OpenTelemetry data to LogBrew with OTLP](https://docs.logbrew.co/guides/opentelemetry)
- [LogBrewCo/docs, guides/opentelemetry.mdx](https://github.com/LogBrewCo/docs/blob/main/guides/opentelemetry.mdx)

## 오류 해결법 더 보기

- [메시지와 파일, 줄을 숨기는 스크립트 오류 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)
- [Minified React error #418과 #185를 전체 메시지와 내 코드 줄로 해결하기](https://logbrew.co/ko/errors/minified-react-error)
- [Cannot use import statement outside a module을 브라우저와 Node.js에서 해결하기](https://logbrew.co/ko/errors/cannot-use-import-statement-outside-a-module)
- [AxiosError Network Error 해결하고 3가지 원인 중 어느 것인지 찾기](https://logbrew.co/ko/errors/axios-network-error)
- [직접 재현한 오류와 각각의 해결법](https://logbrew.co/ko/errors)
