Bir müşteri, aylık satış raporunun "dönüp duruyor, hiç açılmıyor" olduğunu yazıyor. Ortada hata sayfası yok, uygulamanın hata kaydında da bir şey yok. nginx'in erişim kaydında (access log) o isteğin satırı ise hiçbir tarayıcıda görmeyeceğiniz bir durum koduyla bitiyor: 499, gönderilen sıfır bayt ve tam 30 saniyelik bir istek süresi. Sunucu çökmemiş. Birisi beklemekten vazgeçmiş.
Bu yazıda 499 kodunun ne anlama geldiğini ve kimin görebildiğini, sık görülen nedenlerini, kayıtlarda nasıl okunacağını, sunucu tarafında nasıl düzeltileceğini, Cloudflare'in ve yük dengeleyicilerin ne kaydettiğini ve vazgeçen istemci proxy üzerinden çalışan kendi betiğiniz olduğunda nelere bakmanız gerektiğini anlatıyoruz.
HTTP 499 ne anlama gelir?
HTTP 499, istemcinin sunucu yanıt vermeden istekten vazgeçtiğini gösterir. İstemci, bağlantıyı açan taraftır: bir tarayıcı, bir mobil uygulama, bir betik ya da yük dengeleyici gibi başka bir sunucu. Kod, isteğin geçerli olup olmadığı ya da yanıtın doğru olup olmayacağı hakkında hiçbir şey söylemez.
Adı nginx'in kaynak kodundan gelir. Durum kodlarını tanımlayan dosyada nginx geliştiricileri, istek işlenirken bağlantıyı kapatan bir istemci için HTTP'de bir kod bulunmadığını, bu yüzden kendi kodlarını, 499 numaralı NGX_HTTP_CLIENT_CLOSED_REQUEST'i tanımladıklarını açıklar. Aynı açıklama kodu, nginx yanıt başlığını göndermeyi denemeden önce ayrılan istemcilerle sınırlar.
499 resmî bir HTTP durum kodu mu?
Hayır. HTTP standardının dayandığı resmî liste olan IANA HTTP durum kodu kaydında 452'den 499'a kadar bütün aralık atanmamış görünür. 499, nginx'in kendi kayıtları için tuttuğu küçük bir grubun parçasıdır: 494 (istek başlığı çok büyük), 495 ve 496 (istemci sertifikası sorunları) ve 497 (HTTPS portuna gönderilen düz HTTP). 404 ya da 429 gibi gerçek bir 4xx kodundan farkı, bir yanıt değil, bir kayıt satırı olmasıdır: hiçbir istemci onu almaz.
499 hatasını kim görür?
Yalnız sunucuyu işleten kişi görür: erişim kaydında ya da kayıtlardan üretilen analizlerde. Aynı anı her taraf kendi biçiminde kaydeder:
| Kim | Ne görür | Nerede |
|---|---|---|
| Tarayıcı kullanıcısı | Duran bir yükleme simgesi ya da hiçbir şey | Sayfanın kendisi |
| curl | curl: (28) Operation timed out | Terminal, çıkış kodu 28 |
| Python Requests | ReadTimeout hatası | Betik çıktısı |
| nginx işletmecisi | 499 durumu, çoğu zaman 0 bayt | Erişim kaydı |
Bunu test makinemizde, her isteğe beş saniye sonra yanıt veren ve yalnız 127.0.0.1'de dinleyen küçük bir Node.js sunucusuyla yeniden ürettik. curl --max-time 2 "Operation timed out after 2007 milliseconds with 0 bytes received" mesajı ve libcurl'ün zaman aşımı olarak tanımladığı 28 çıkış koduyla vazgeçti; aynı anda sunucu, istemcinin bağlantıyı yanıttan önce kapattığını kaydetti. nginx bu olayı 499 olarak yazar. --max-time 8 ile aynı istek 5,0 saniye sonra 200 döndü.
499 adım adım nasıl oluşur?
- İstemci isteği gönderir ve kendi sayacını başlatır: tarayıcı kullanıcı ne kadar beklerse o kadar, betik zaman aşımı ne kadar izin verirse o kadar bekler.
- nginx isteği alır ve arkasındaki uygulamaya iletir.
- Yanıt, istemcinin bekleyeceğinden uzun sürer: ağır bir veritabanı sorgusu, soğuk bir önbellek, yavaş bir dış servis.
- İstemci bağlantıyı kapatır. Kullanıcı başka sayfaya geçer, betiğin zaman aşımı dolar ya da öndeki yük dengeleyici isteği keser.
- nginx kapanan bağlantıyı fark eder, varsayılan ayarla uygulamaya giden bağlantısını da kapatır ve isteği 499 durumuyla kaydeder.
Uygulamanın 5. adımda durup durmayacağı uygulamaya bağlıdır. Birçok framework kapanan bağlantıyı ancak yanıtı yazmaya çalıştığında fark eder; pahalı sorgu sonuna kadar çalışabilir ve sonucu çöpe gider.
HTTP 499'a ne sebep olur?
499'ların neredeyse tamamı bir zaman aşımı uyumsuzluğundan ya da beklemekten vazgeçen bir insandan doğar. Nedenleri kabaca şu sırayla kontrol edin:
- Sunucunun yanıt süresinden kısa bir istemci zaman aşımı. 12 saniye gereken bir endpoint'i (uç nokta) 10 saniye bekleyen bir uygulama sürekli 499 üretir.
- Sayfadan ayrılan kullanıcılar: sekmeyi kapatmak, yüklemeyi durdurmak, sayfa açılmadan başka bir bağlantıya tıklamak.
- nginx'in önünde, daha kısa zaman aşımıyla çalışan bir yük dengeleyici, CDN ya da proxy. Bu durumda nginx istemci olarak aradaki katmanın adresini kaydeder.
- Mobil ağlar. Wi-Fi'dan mobil veriye geçen bir telefon, bağlantıyı isteğin ortasında düşürür.
- Sağlık kontrolleri ve izleme servisleri: üç saniyede açılan bir sayfayı iki saniye bekleyen bir kontrol.
- Zaman aşımı sıkı ayarlanmış betikler ve crawler'lar, proxy üzerinden çalışan kendi işleriniz de dahil.
- Uygulamanın kendisinin iptal etmesi. Bir arama kutusu, kullanıcı bir sonraki harfi yazdığında önceki isteği iptal eder.
499'un 408, 502 ve 504'ten farkı nedir?
Fark, kimin vazgeçtiğinde ve bir yanıt gönderilip gönderilmediğindedir. Bu gruptaki kodlardan kimseye ulaşmayan tek kod 499'dur:
| Kod | Kim vazgeçti | İstemciye gider mi? | Tipik çözüm |
|---|---|---|---|
499 | İstemci | Hayır, yalnız kayıt | Daha hızlı uygulama, daha uzun istemci zaman aşımı |
408 | İsteği bekleyen sunucu | Evet | İstemci daha hızlı göndermeli |
502 | Hatalı yanıt alan ağ geçidi | Evet | Çöken uygulamayı düzeltin |
504 | Çok bekleyen ağ geçidi | Evet | Daha hızlı uygulama, daha uzun ağ geçidi zaman aşımı |
499 ile 504'ün kökü çoğu zaman aynıdır, yavaş bir uygulama: önce istemcinin sayacı dolarsa 499 görürsünüz, nginx'inki dolarsa istemciye 504 gider. Uygulamadan bozuk bir yanıt gelmesi ise 502'dir; o tarafı 502 Bad Gateway Hatası Nedir, Nasıl Çözülür? yazısında anlattık.
nginx kayıtlarında 499 nasıl okunur?
Erişim kaydına süre alanları ekleyin, sonra her 499'dan önce istemcinin ne kadar beklediğine bakın. nginx'in varsayılan combined biçimi durumu yazar ama süreyi yazmaz; bu yüzden işe özel bir biçimle başlayın:
log_format timed '$remote_addr - [$time_local] "$request" $status $body_bytes_sent '
'rt=$request_time urt=$upstream_response_time us=$upstream_status '
'"$http_user_agent"';
access_log /var/log/nginx/access.log timed;$request_time, nginx'in istemciden ilk baytı okuduğu andan kayıt satırını yazdığı ana kadar geçen süredir; saniye cinsinden, milisaniye hassasiyetiyle. $upstream_response_time yanıtı uygulamadan almak için harcanan süre, $upstream_status ise uygulamanın döndürdüğü durumdur. Bu biçimde bir 499 satırı şöyle görünebilir (örnek değerler):
203.0.113.7 - [19/Nov/2026:10:42:13 +0000] "GET /reports/monthly HTTP/1.1" 499 0 rt=30.001 urt=30.000 us=- "ExampleApp/2.1"Üç okuma soruların çoğunu cevaplar:
- 499'lar tek bir değerde mi toplanıyor? Yüzlerce satırda
rtdeğeri30.001,30.002ve29.999gösteriyorsa bir yerde 30 saniyelik zaman aşımına sahip bir istemci vardır. Dağınık değerler sayfadan ayrılan kullanıcıları gösterir. - İstemci kim? Adres ve kullanıcı aracısı (user agent), tarayıcıyı mobil uygulamadan, kendi yük dengeleyicinizden ya da bir izleme servisinden ayırır.
- Endpoint normalde ne kadar sürüyor? Aynı adresin başarılı isteklerinde
urt'ye bakın. Bunlar sık sık toplanan 499 değerinden uzun sürüyorsa endpoint o istemci için fazla yavaştır. 499 satırındakius=-, istemci ayrıldığında uygulamanın henüz bir durum göndermediğini gösterir.
Bir yük dengeleyicinin arkasında $remote_addr her satırda dengeleyicinin adresidir; iletilen istemci adresini de kaydedin, yoksa bütün 499'lar tek bir makineden gelmiş gibi görünür.
Sunucu tarafında HTTP 499 nasıl çözülür?
Önce yavaş isteği, sonra zaman aşımlarını düzeltin; daha uzun bir zaman aşımı beklemeyi yalnız başka bir yere taşır.
- Bağlantıyı kimin kapattığını bulun. Yukarıdaki alanları kullanın. Yük dengeleyicinizden gelen ve tek değerde toplanan 499'lar bir yapılandırma sorunudur; tarayıcılardan gelen dağınık değerler ise bir hız sorunudur.
- Yavaş endpoint'i hızlandırın: sonucu önbelleğe alın, eksik indeksi ekleyin, çok büyük bir yanıtı sayfalara bölün.
- Uzun işleri arka plan işine çevirin. Hemen bir iş numarasıyla yanıt verin (202 Accepted durumu bunun için vardır), rapor hazır olduğunda istemci yeniden sorsun.
- Zaman aşımlarını dıştan içe sıralayın. Her katman arkasındakinden biraz daha uzun beklemeli: istemci, sonra CDN ya da yük dengeleyici, sonra nginx, en son uygulama. nginx'in
proxy_read_timeoutayarı, uygulamadan yapılan iki okuma arasındaki bekleme süresidir, yanıtın tamamı için bir sınır değildir ve varsayılanı 60 saniyedir (nginx proxy modülü). proxy_ignore_client_abortayarını yalnız bir gerekçeyle açın. Varsayılanı kapalı olan bu ayar, istemci ayrıldığında nginx'in uygulamaya giden bağlantıyı kapatıp kapatmayacağını belirler. Açıldığında önbelleği doldurmak gibi mutlaka bitmesi gereken işler tamamlanır, ama yarıda bırakılan her istek sunucuya tam maliyet çıkarır.- İzlemede 499'u görünür ama ayrı tutun. Yoğun her sitede birkaç 499 normaldir; tek bir adreste ani artış, o sayfanın yavaşladığının erken işaretidir.
Cloudflare'de ve yük dengeleyicilerde 499 ne anlama gelir?
Cloudflare'de de 499 aynı anlama gelir: istemci, istek bitmeden bağlantıyı kapatmıştır. Cloudflare'in 499 hata dokümanı, istemciye hiçbir 499 yanıtı gönderilmediğini ve kodun yalnız kayıtlarda göründüğünü belirtir. Nedenler arasında kısa istemci süre sınırlarını, yavaş asıl sunucuları ve önbellek isabet oranındaki düşüşleri sayar; 499 oranını aynı endpoint'e gelen bütün isteklerle karşılaştırmayı önerir. 19 Ocak 2026'dan beri Cloudflare iptal edilen HTTP/3 isteklerini de 499 olarak kaydediyor; bu yüzden siteler HTTP/3 trafiğinde daha çok 499 görebilir.
Başka yük dengeleyiciler aynı olay için kendi numaralarını kullanır. AWS'nin Application Load Balancer'ı, istemci bağlantıyı dengeleyicinin boşta bekleme süresi (idle timeout) dolmadan kapattığında HTTP 460 kaydeder ve sorun giderme kılavuzu aynı öneriyi verir: istemcinin zaman aşımından önce yanıt verin ya da istemcinin zaman aşımını buna göre yükseltin.
İstemci sizseniz: kendi betiğinizden gelen 499
Bir sitenin işletmecisi isteklerinizin 499 olarak göründüğünü söylüyorsa, betiğiniz sunucu yanıt vermeden bağlantıyı kapatmıştır. Çözüm sizin kodunuzdadır.
HTTP kütüphaneleri zaman aşımını genellikle ikiye ayırır: bağlantı zaman aşımı (connect timeout) betiğin bağlantıyı açmak için ne kadar bekleyeceğini, okuma zaman aşımı (read timeout) ise istek gittikten sonra veri için ne kadar bekleyeceğini sınırlar. Python'un Requests kütüphanesi siz ayarlamadıkça ikisini de koymaz; zaman aşımı olmayan bir betik dakikalarca takılı kalabilir, çok kısa bir okuma zaman aşımı ise her yavaş sayfada bir 499 bırakır.
Aşağıdaki örnek, aynı noktada yeniden kapatmak yerine her denemede daha uzun bekler. Betiği aynı yerel test sunucusuna karşı çalıştırdık (Python 3.13, Requests 2.34):
import time
import requests
URL = "http://127.0.0.1:18499/report" # yerel test sunucumuz; 5 saniye sonra yanıt verir
PROXIES = None # ya da {"http": "http://user:pass@pr.proxynet.io:8000", "https": "http://user:pass@pr.proxynet.io:8000"}
CONNECT = 5 # bağlantıyı açmak için saniye
READ_TIMEOUTS = (2, 4, 8) # her deneme, aynı noktada kapatmak yerine daha uzun bekler
def fetch(url):
for attempt, read in enumerate(READ_TIMEOUTS, start=1):
started = time.monotonic()
try:
r = requests.get(url, proxies=PROXIES, timeout=(CONNECT, read))
print(f"attempt {attempt}: HTTP {r.status_code} after {time.monotonic() - started:.1f} s")
return r
except requests.exceptions.ReadTimeout:
# Bağlantıyı burada biz kapatıyoruz; nginx çalışan bir sunucu bu isteği 499 olarak kaydeder.
print(f"attempt {attempt}: no answer within {read} s, closed the connection")
except requests.exceptions.ConnectTimeout:
print(f"attempt {attempt}: could not connect within {CONNECT} s")
time.sleep(1)
raise RuntimeError(f"{url}: no answer within {READ_TIMEOUTS[-1]} s, check the server side")
fetch(URL)Çıktı:
attempt 1: no answer within 2 s, closed the connection
attempt 2: no answer within 4 s, closed the connection
attempt 3: HTTP 200 after 5.0 sSunucu ilk iki denemeyi 2,0 ve 4,0 saniye sonra istemci tarafından kapatılmış, üçüncüsünü normal bir 200 olarak kaydetti. Bu şekilde yalnız hiçbir şeyi değiştirmeyen istekleri, örneğin GET'i yeniden deneyin: zaman aşımına uğrayan bir POST yine de işlenmiş olabilir. Sayfa herkes için yavaşsa istek hızınızı düşürün. Bir crawler'ın karşılaştığı diğer kodlara nasıl davranması gerektiğini Scraping'de HTTP Hata Kodları: 403, 407, 429 ve 503 yazısında bulabilirsiniz.
Proxy 499 hatasına sebep olur mu?
Proxy 499 üretmez, ama zaman aşımınızın karşılaması gereken süreye ekleme yapar: her istek önce proxy'ye, oradan hedefe gider ve hedeften uzak bir çıkış noktası her gidiş-dönüşü uzatır. Doğrudan istekler için ayarlanmış bir okuma zaman aşımı yetmeyebilir; bu durumda hedef, isteğinizi 499 olarak kaydeder ve istemci adresi olarak proxy'nin çıkış adresini yazar.
Bir şeyi değiştirmeden önce ölçün: curl -w ile %{time_connect} ve %{time_starttransfer}, bağlantının ve ilk baytın proxy'li ve proxy'siz ne kadar sürdüğünü gösterir. Zaman aşımını bu sayılara, yavaş sayfalar için pay bırakarak ayarlayın. Bilinen birkaç siteye karşı çalışan uzun işlerde Datacenter Proxy, hedefe yakın bir veri merkezinde sabit bir çıkış adresi verir; eklenen süre kısa ve düzenli kalır.
Büyük taramalar için web crawler kurulumumuz, istekler arasında ayarlanabilir bir bekleme süresi de içerir; böylece hedefe bindirdiğiniz yük, sayfalarının yavaşlamasına yol açmayacak kadar düşük kalır.
HTTP 499 ile nerede karşılaşırsınız?
- Tek bir istek süresinde toplanan 499 satırları olan bir nginx erişim kaydında.
- Yavaş bir asıl sunucunun yanında 499'lar gösteren bir Cloudflare kayıt dışa aktarımında.
- Mobil istemcileri işe gidiş geliş saatlerinde 499 üreten bir API'de.
- Okuma zaman aşımı, hedefin yanıt süresinden kısa olan bir crawler ya da veri işinde.
Sık yapılan hatalar
- 499'u sunucu hatası saymak. 499'ları 5xx hatalarıyla birlikte saymak, var olmayan çökmeleri aramanıza yol açar.
- Her zaman aşımını birkaç dakikaya çıkarmak. 499'lar kaybolur, ama yavaş istekler bağlantıları ve işçi süreçleri dakikalarca tutar; kullanıcı da yine bekler.
proxy_ignore_client_abortayarını her yerde açmak. Sabırsız istemcilerden gelen bir dalga, tam maliyetli bir iş dalgasına dönüşür.- Zaman aşımına uğrayan bir POST'u körü körüne yeniden göndermek. İlk deneme başarılı olmuş olabilir; tekrar, çift sipariş ya da çift kayıt yaratır.
- Proxy üzerinden aynı kısa zaman aşımını kullanmak. Ek adım pay ister; önce ölçün.
Karar rehberi
| Durum | Ne yapmalı? |
|---|---|
| 499'lar tek bir istek süresinde toplanıyor | O zaman aşımına sahip istemciyi ya da dengeleyiciyi bulup hizalayın |
| Yavaş bir sayfada dağınık 499'lar | Endpoint'i hızlandırın ya da arka plan işine çevirin |
| 499'lar yük dengeleyicinizin IP'sinden | Zaman aşımını nginx'inkinden yükseğe alın, iletilen IP'yi kaydedin |
| Betiğiniz bir sitede 499'a yol açıyor | Daha uzun okuma zaman aşımı, yalnız GET'i yeniden deneyin, eşzamanlılığı düşürün |
| İş, istemci ayrılsa da bitmeli | Arka plan işi ya da yalnız o yolda proxy_ignore_client_abort |
| Cloudflare'de ani 499 artışı | Bütün isteklerle karşılaştırın, asıl sunucu süresine ve önbelleğe bakın |
Sıkça sorulan sorular
HTTP 499 istemci hatası mı, sunucu hatası mı?
İstemci tarafında bir olay olarak kaydedilir: istemci, yanıttan önce bağlantıyı kapatmıştır. Neden yine de sunucuda olabilir, çünkü istemcinin vazgeçmesine yol açan çoğu zaman yavaş bir yanıttır.
Kullanıcı 499 hata sayfası görebilir mi?
Hayır. İstemciye hiçbir şey gönderilmediği için tarayıcı hiçbir zaman "499" göstermez. Kullanıcı yüklemesi duran bir sayfa ya da tarayıcının kendi zaman aşımı mesajını görür.
nginx'te 499 ne demek?
nginx'in "client closed request" için kullandığı kendi kodudur: istemci, nginx yanıt başlığını göndermeden bağlantıyı kapatmıştır. HTTP standardında bu durum için bir kod olmadığından nginx onu kendisi tanımlar.
Cloudflare'de HTTP 499 ne anlama gelir?
Aynı anlama gelir: istemci, Cloudflare isteği bitirmeden bağlantıyı kapatmıştır. Yalnız kayıtlarda ve analizlerde görünür; en sık nedenleri istemci zaman aşımları, yavaş asıl sunucular ve önbellekte karşılığı bulunmayan isteklerdir.
499, sunucunun isteği işlemeyi bıraktığı anlamına mı gelir?
Her zaman değil. nginx varsayılan ayarla uygulamaya giden bağlantısını kapatır, ama uygulama yanıtı göndermeye çalışana kadar çalışmaya devam edebilir; bu yüzden zaman aşımına uğrayan bir POST tamamlanmış olabilir.
499 zaman aşımı hatası nasıl düzeltilir?
Bağlantıyı kimin kapattığını kayıttaki istek süresinden ve istemci adresinden bulun, yavaş işi hızlandırın ya da arka plan işine taşıyın, sonra her zaman aşımını arkasındakinden uzun yapın.
Özet
HTTP 499, nginx'in sunucu yanıt vermeden bağlantıyı kapatan bir istemci için yazdığı kayıt satırıdır; resmî bir durum kodu değildir ve istemciye hiç ulaşmaz. Toplanan istek süreleri zincirin bir yerindeki zaman aşımını, dağınık süreler yavaş sayfaları ve sabırsız kullanıcıları gösterir. Yavaş endpoint'i düzeltin, uzun işi istekten çıkarın ve zaman aşımlarını istemciden içeri doğru sıralayın. İstemci kendi betiğinizse ona hedefi ve proxy adımını karşılayan bir okuma zaman aşımı verin, yalnız güvenli istekleri yeniden deneyin ve daha düzenli bir çıkış gerekiyorsa proxy türlerimizi karşılaştırın.




