---
title: "HTTP 499 エラーを解決し、どちらが待つのをやめたかを突き止める"
description: "HTTP 499 は、応答の前にクライアントが接続を閉じたときに nginx がログに残すステータスです。クライアントには届かず、私たちのテストではアップストリームはすべてのリクエストを最後まで処理しました。"
canonical: "https://logbrew.co/ja/errors/http-499"
last_updated: "2026-11-21"
---

# HTTP 499 エラーを解決し、どちらが待つのをやめたかを突き止める

HTTP 499 は、応答の前にクライアントが接続を閉じたときに nginx がログに残すステータスです。クライアントには届かず、私たちのテストではアップストリームはすべてのリクエストを最後まで処理しました。

2026年11月21日 に nginx 1.31.8、curl 8.7.1、Python 3.13.5、logbrew CLI 0.1.96 で検証

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

Canonical: https://logbrew.co/ja/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 件のリクエスト。最後の 1 件は `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 が待つのをやめると、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` で、nginx が応答ヘッダーを送る前に接続を閉じたクライアント用に、これを `NGX_HTTP_CLIENT_CLOSED_REQUEST` として定義しています。

クライアントの接続はすでに閉じているので、クライアントが 499 を受け取ることはありません。nginx はアップストリームへの接続も閉じ、アクセスログに `499` を書きます。

エラーログのデフォルトのレベル `error` では、nginx は 499 についてほかに何も書きません。レベル `info` では `client prematurely closed connection` と書きます。504 はレベル `error` で出ます。

1. クライアントが接続を閉じる
2. nginx がアップストリームへの接続を閉じる
3. nginx がアクセスログに 499 を書く

## LogBrew が記録する内容

LogBrew は、送った各行を `nginx` サービスのレベル `warning` の 1 件のログとして保存しました。行全体をメッセージとして保持し、フィールドには分けないので、テキストで検索します。

ダッシュボード、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 を隠すだけです。

### クライアントが去ったことをアップストリームは知っていますか？

私たちのテストでは知りませんでした。Python のアップストリームは、nginx が 499 と記録した 2 件のリクエストのどちらにも 200 を記録し、クライアントが去った後に処理を終えました。

## 499 の行をまとめて 1 か所で検索

nginx のログ行を OTLP のログとして LogBrew に送れば、ダッシュボード、CLI、AI エージェントから検索できます。余裕のある無料プランで始められます。クレジットカードは不要です。

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

## 出典

- [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/ja/errors/script-error)
- [Failed to fetch エラーを解決し、3 つの原因を見分ける](https://logbrew.co/ja/errors/failed-to-fetch)
- [Kotlin と Android の java.lang.NullPointerException をメッセージから解決する](https://logbrew.co/ja/errors/nullpointerexception)
- [Minified React error #418 と #185 を完全なメッセージと自分のコードの行から解決する](https://logbrew.co/ja/errors/minified-react-error)
- [Cannot use import statement outside a module をブラウザーと Node.js で解決する](https://logbrew.co/ja/errors/cannot-use-import-statement-outside-a-module)
- [AxiosError Network Error を解決し、3 つの原因のどれかを突き止める](https://logbrew.co/ja/errors/axios-network-error)
- [再現したエラーとそれぞれの解決方法](https://logbrew.co/ja/errors)
