---
title: "Sửa lỗi HTTP 499 và tìm xem ai đã ngừng chờ"
description: "HTTP 499 là status nginx ghi log khi client đóng kết nối trước khi có phản hồi. Client không bao giờ thấy nó, và trong thử nghiệm của chúng tôi upstream vẫn xử lý xong mọi request."
canonical: "https://logbrew.co/vi/errors/http-499"
last_updated: "2026-11-21"
---

# Sửa lỗi HTTP 499 và tìm xem ai đã ngừng chờ

HTTP 499 là status nginx ghi log khi client đóng kết nối trước khi có phản hồi. Client không bao giờ thấy nó, và trong thử nghiệm của chúng tôi upstream vẫn xử lý xong mọi request.

Đã thử nghiệm ngày 21 tháng 11, 2026 với nginx 1.31.8, curl 8.7.1, Python 3.13.5 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/errors/http-499

## Ai ngừng chờ trước, và nginx ghi log gì

| Ai ngừng chờ trước | Client nhận được phản hồi | Ghi log `499` |
| --- | --- | --- |
| Không ai, upstream trả lời sau 0,2 giây | `200` | `200` |
| Client, sau 2 giây | Không | `499` |
| Client, sau 0,3 giây | Không | `499` |
| nginx, sau `proxy_read_timeout 3s` | `504` | `504` |
| Client, nginx vẫn chờ | Không | `200` |

5 request qua nginx 1.31.8, gửi bằng curl 8.7.1. Request cuối dùng `proxy_ignore_client_abort on`.

## Tìm xem ai đã ngừng chờ

### Tìm các dòng 499 trong access log

nginx ghi `499` vào access log, và chỉ ở đó. Với định dạng mặc định `combined`, dòng log cho thấy request và 0 byte đã gửi, nhưng không cho biết mỗi bên đã chờ bao lâu.

Kết quả

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

### Ghi log thời gian chờ của mỗi bên

Thêm `$request_time`, `$upstream_status` và `$upstream_response_time` vào một `log_format` trong khối `http`, bên cạnh log mặc định. Sau đó chạy `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;
```

### Đọc request_time trên mỗi dòng 499

`request_time` là thời gian client chờ trước khi ngắt kết nối. Client của chúng tôi bỏ cuộc sau 2 giây và 0,3 giây, và nginx ghi 2,006 và 0,301. `upstream_status` là `-` vì upstream chưa trả lời.

Kết quả

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

### Tìm 1 giá trị lặp lại

Nhiều dòng 499 có `request_time` gần như giống nhau cho thấy có một timeout cố định đứng trước nginx, ví dụ timeout của chính client. 3 client dùng `--max-time 2` cho ra 3 dòng từ 2,008 đến 2,011 giây. So sánh giá trị đó với `upstream_response_time` trên các dòng 200 của cùng path. Nếu upstream thường cần lâu hơn, nó quá chậm với client đó.

Kết quả

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

### Phân biệt 499 với 504

Khi nginx ngừng chờ trước, nó ghi `504`, và client nhận một trang 504. Lúc đó `request_time` chính là `proxy_read_timeout` của bạn, 3 giây trong thử nghiệm của chúng tôi, và `upstream_status` là `504`, không phải `-`. Error log ghi `upstream timed out`.

Kết quả

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

## Cách sửa

### Để upstream trả lời trước khi client bỏ cuộc

Nếu các dòng 499 có cùng một `request_time` và các dòng 200 của path đó mất lâu hơn, hãy tăng tốc endpoint đó hoặc tăng timeout ở client. `request_time` ngắn, như 0,301 của chúng tôi, nghĩa là chính client đã hủy request, ví dụ khi người dùng rời trang.

### Dừng việc không ai còn chờ

Upstream của chúng tôi ghi 200 cho cả hai request mà nginx ghi là 499. Nó xử lý xong chúng 3 giây và 0,7 giây sau khi client đã rời đi. nginx đóng kết nối tới upstream, nhưng upstream không biết. Hãy kiểm tra kết nối đã đóng trong các handler chạy lâu, hoặc chuyển việc chậm sang background job.

Kết quả

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

### Giữ proxy_ignore_client_abort ở trạng thái tắt

Với `proxy_ignore_client_abort on`, nginx chờ upstream và ghi `200` với `request_time` là 5,006, dù curl đã ngắt kết nối sau 2 giây. 499 biến mất khỏi log. Giá trị mặc định là `off`.

```bash
proxy_ignore_client_abort off;
```

Kết quả

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

### Gửi các dòng 499 tới LogBrew

LogBrew chưa có tích hợp nginx, nhưng nhận log OTLP. Lệnh này gửi mỗi dòng 499 và 504 thành 1 log. Đặt `LOGBREW_INGEST_KEY` bằng một key `server` của dự án. API LogBrew chạy local của chúng tôi trả về `{}`, nghĩa là đã nhận mọi dòng.

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

Kết quả

```text
{}
```

### Tìm chúng bằng CLI của LogBrew

Mỗi dòng là 1 log có level `warning`, và message là cả dòng. Đặt dấu cách quanh 499 khi tìm, để 499 nằm trong path hay trong thời gian không bị khớp.

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

Kết quả

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

## Những gì chúng tôi thấy khi thử nghiệm

Chúng tôi chạy nginx 1.31.8 trên macOS 27.2 tại `127.0.0.1:28499`, phía trước một upstream Python 3.13 chờ số giây trong `?delay=` rồi trả lời 200. curl 8.7.1 gửi 5 request, 3 trong số đó dùng `--max-time`.

Ở cả hai dòng 499, `request_time` lệch timeout của curl không quá 6 ms, và `upstream_status` là `-`. Ở dòng 504, nó khớp với `proxy_read_timeout`, và `upstream_status` là `504`.

|  | `$status` | `$request_time` | `$upstream_status` |
| --- | --- | --- | --- |
| Không ai bỏ cuộc | `200` | 0,206 giây | `200` |
| Client bỏ cuộc sau 2 giây | `499` | 2,006 giây | `-` |
| Client bỏ cuộc sau 0,3 giây | `499` | 0,301 giây | `-` |
| nginx bỏ cuộc sau 3 giây | `504` | 3,001 giây | `504` |
| Client bỏ cuộc, nginx vẫn chờ | `200` | 5,006 giây | `200` |

## Vì sao chỉ nginx thấy 499

499 không phải status code HTTP. RFC 9110 định nghĩa các mã 4xx, và 499 không nằm trong số đó. nginx định nghĩa nó trong `src/http/ngx_http_request.h` là `NGX_HTTP_CLIENT_CLOSED_REQUEST`, dành cho client đóng kết nối trước khi nginx gửi header phản hồi.

Client không bao giờ nhận 499, vì kết nối của nó đã đóng. nginx cũng đóng kết nối tới upstream và ghi `499` vào access log.

Ở level mặc định của error log là `error`, nginx không ghi gì thêm về 499. Ở level `info`, nó ghi `client prematurely closed connection`. Lỗi 504 xuất hiện ở level `error`.

1. Client đóng kết nối
2. nginx đóng kết nối tới upstream
3. nginx ghi 499 vào access log

## LogBrew ghi nhận gì

LogBrew lưu mỗi dòng chúng tôi gửi thành 1 log của service `nginx`, với level `warning`. Nó giữ cả dòng làm message và không tách thành field, nên hãy tìm theo văn bản.

Dashboard, CLI và máy chủ MCP đọc các log này như mọi log LogBrew khác.

- `nginx`
  - `level`: `warning`
  - Thông điệp: `… 499 0 request_time=0.301 …`
  - `trace`: `3ded5398edda96df764625b26d6274f2`

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

### HTTP status code 499 nghĩa là gì?

Client đã đóng kết nối trước khi nginx gửi phản hồi, và nginx ghi 499. Status này không thuộc HTTP, và client không bao giờ nhận được nó.

### Lỗi 499 do client hay do server?

Client đóng kết nối, nhưng nguyên nhân thường là upstream chậm. So sánh `request_time` trên các dòng 499 với `upstream_response_time` trên các dòng 200 của cùng path.

### 499 và 504 khác nhau thế nào?

499 nghĩa là client ngừng chờ trước. 504 nghĩa là nginx ngừng chờ trước, sau `proxy_read_timeout`, và client nhận 504.

### Làm sao sửa lỗi 499 trong nginx?

Tìm timeout của client trong `request_time`, rồi để upstream trả lời trước mốc đó, hoặc tăng timeout đó. `proxy_ignore_client_abort on` chỉ giấu 499 trong log.

### Upstream có biết client đã rời đi không?

Trong thử nghiệm của chúng tôi thì không. Upstream Python của chúng tôi ghi 200 cho cả hai request mà nginx ghi là 499, và xử lý xong từng request khi client đã rời đi.

## Tìm mọi dòng 499 ở 1 nơi

Gửi các dòng log nginx tới LogBrew dưới dạng log OTLP, rồi tìm chúng từ dashboard, CLI hoặc AI agent của bạ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

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

## Thêm cách sửa lỗi

- [Sửa lỗi Script error khiến thông điệp, file và số dòng bị ẩn](https://logbrew.co/vi/errors/script-error)
- [Sửa lỗi Failed to fetch và phân biệt 3 nguyên nhân](https://logbrew.co/vi/errors/failed-to-fetch)
- [Sửa java.lang.NullPointerException trong Kotlin và Android từ thông điệp của nó](https://logbrew.co/vi/errors/nullpointerexception)
- [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)
- [Sửa lỗi Cannot use import statement outside a module trong trình duyệt và Node.js](https://logbrew.co/vi/errors/cannot-use-import-statement-outside-a-module)
- [Sửa AxiosError Network Error và tìm xem bạn gặp nguyên nhân nào trong 3](https://logbrew.co/vi/errors/axios-network-error)
- [Những lỗi chúng tôi đã tái hiện, và cách sửa từng lỗi](https://logbrew.co/vi/errors)
