---
title: "حل خطأ HTTP 499 واعرف من توقف عن الانتظار"
description: "HTTP 499 هو الرمز الذي يسجّله nginx عندما يغلق العميل الاتصال قبل وصول الرد. لا يراه العميل أبدًا، وفي اختبارنا أكمل الخادم الخلفي كل طلب."
canonical: "https://logbrew.co/ar/errors/http-499"
last_updated: "2026-11-21"
---

# حل خطأ HTTP 499 واعرف من توقف عن الانتظار

HTTP 499 هو الرمز الذي يسجّله nginx عندما يغلق العميل الاتصال قبل وصول الرد. لا يراه العميل أبدًا، وفي اختبارنا أكمل الخادم الخلفي كل طلب.

اختُبر في 21 نوفمبر 2026 باستخدام 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، ويبني LogBrew كل يوم باستخدام Claude Code وCodex.

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

## من توقف عن الانتظار، وماذا سجّل nginx

| من توقف عن الانتظار | وصل رد إلى العميل | سُجّل `499` |
| --- | --- | --- |
| لا أحد، أجاب الخادم الخلفي خلال 0.2 ث | `200` | `200` |
| العميل، بعد 2 ث | لا | `499` |
| العميل، بعد 0.3 ث | لا | `499` |
| nginx، بعد `proxy_read_timeout 3s` | `504` | `504` |
| العميل، وواصل nginx الانتظار | لا | `200` |

5 طلبات عبر nginx 1.31.8، أرسلها curl 8.7.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"
```

### سجّل كم انتظر كل طرف

أضف `$request_time` و`$upstream_status` و`$upstream_response_time` إلى `log_format` داخل الكتلة `http`، بجانب سجلك الافتراضي. ثم شغّل `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;
```

### اقرأ request_time في كل سطر 499

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

### ابحث عن قيمة واحدة تتكرر

كثرة أسطر 499 بقيمة `request_time` شبه متطابقة تشير إلى مهلة ثابتة قبل nginx، مثل مهلة العميل نفسه. أعطى 3 عملاء مع `--max-time 2` ثلاثة أسطر بين 2.008 و2.011 ث. قارن هذه القيمة بـ `upstream_response_time` في أسطر 200 للمسار نفسه. إن احتاج الخادم الخلفي غالبًا وقتًا أطول، فهو أبطأ من أن يناسب هذا العميل.

المخرجات

```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 للمسار نفسه وقتًا أطول، فسرّع نقطة النهاية هذه أو ارفع المهلة في العميل. أما `request_time` قصيرة مثل 0.301 لدينا، فتعني أن العميل ألغى الطلب بنفسه، مثلًا عندما يغادر المستخدم الصفحة.

### أوقف العمل الذي لا ينتظره أحد

سجّل خادمنا الخلفي 200 للطلبين اللذين سجّلهما nginx بالرمز 499. وأنهاهما بعد مغادرة العميل بـ 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` انتظر nginx الخادم الخلفي وسجّل `200` مع `request_time` قيمتها 5.006، رغم أن curl قطع الاتصال بعد 2 ث. اختفى 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 كسجل واحد. اضبط `LOGBREW_INGEST_KEY` على مفتاح `server` من مشروعك. أجابت واجهة LogBrew المحلية لدينا بـ `{}`، أي أنها قبلت كل سطر.

```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 لسطر الأوامر

كل سطر سجل واحد بالمستوى `warning`، ورسالته هي السطر كاملًا. ضع مسافة قبل 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]
```

## ما رأيناه عندما اختبرناه

شغّلنا nginx 1.31.8 على macOS 27.2 على العنوان `127.0.0.1:28499`، أمام خادم خلفي بلغة Python 3.13 ينتظر عدد الثواني المحدد في `?delay=` ثم يجيب بـ 200. أرسل curl 8.7.1 خمسة طلبات، 3 منها مع `--max-time`.

في سطري 499 كليهما طابقت `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` |

## لماذا يرى nginx وحده الرمز 499

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` بالمستوى `warning`. يحتفظ بالسطر كاملًا رسالةً ولا يقسّمه إلى حقول، لذا ابحث في النص.

تقرأ لوحة التحكم وواجهة سطر الأوامر وخادم MCP هذه السجلات مثل أي سجل آخر في LogBrew.

- `nginx`
  - `level`: `warning`
  - الرسالة: `… 499 0 request_time=0.301 …`
  - `trace`: `3ded5398edda96df764625b26d6274f2`

## أسئلة شائعة

### ماذا يعني رمز حالة HTTP 499؟

أغلق العميل الاتصال قبل أن يرسل nginx الرد، فسجّل nginx الرمز 499. هذه الحالة ليست جزءًا من HTTP، ولا يتلقاها العميل أبدًا.

### هل سبب خطأ 499 هو العميل أم الخادم؟

العميل هو من يغلق الاتصال، لكن السبب كثيرًا ما يكون خادمًا خلفيًا بطيئًا. قارن `request_time` في أسطر 499 بـ `upstream_response_time` في أسطر 200 للمسار نفسه.

### ما الفرق بين 499 و504؟

499 يعني أن العميل توقف عن الانتظار أولًا. و504 يعني أن nginx توقف عن الانتظار أولًا، بعد `proxy_read_timeout`، ويتلقى العميل 504.

### كيف أحل أخطاء 499 في nginx؟

اعثر على مهلة العميل في `request_time`، ثم اجعل الخادم الخلفي يجيب قبلها، أو ارفع هذه المهلة. أما `proxy_ignore_client_abort on` فيخفي 499 في السجل فقط.

### هل يعرف الخادم الخلفي أن العميل غادر؟

لم يعرف في اختبارنا. سجّل خادمنا الخلفي بلغة Python الرمز 200 للطلبين اللذين سجّلهما nginx بالرمز 499، وأنهى كلًا منهما بعد رحيل العميل.

## ابحث في كل أسطر 499 من مكان واحد

أرسل أسطر سجل nginx إلى LogBrew كسجلات OTLP، وابحث فيها من لوحة التحكم أو واجهة سطر الأوامر أو وكيل الذكاء الاصطناعي. ابدأ بخطة مجانية سخية دون بطاقة.

[ابدأ مجانًا](https://logbrew.co/ar)

## المصادر

- [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/ar/errors/script-error)
- [أصلح خطأ Failed to fetch وميّز بين أسبابه الـ3](https://logbrew.co/ar/errors/failed-to-fetch)
- [أصلح java.lang.NullPointerException في Kotlin وAndroid من رسالته](https://logbrew.co/ar/errors/nullpointerexception)
- [أصلح Minified React error #418 و#185 من الرسالة الكاملة وسطر كودك](https://logbrew.co/ar/errors/minified-react-error)
- [حل خطأ Cannot use import statement outside a module في المتصفح وفي Node.js](https://logbrew.co/ar/errors/cannot-use-import-statement-outside-a-module)
- [حل AxiosError Network Error واعرف أي سبب من أسبابه الـ 3 لديك](https://logbrew.co/ar/errors/axios-network-error)
- [أخطاء أعدنا إنتاجها، وكيف تصلح كلًا منها](https://logbrew.co/ar/errors)
