Proxy ile 502 Bad Gateway hatası: nasıl düzeltilir

502 Bad Gateway hatası, aracı görevi gören bir proxy sunucusunun, erişmeye çalıştığı upstream sunucudan (hedef siteden) geçersiz ya da beklenmedik bir yanıt alması durumunda ortaya çıkar. Bu sorunu çözmek için iletişim zincirinin hangi halkasının koptuğunu belirlemek amacıyla proxy kimlik doğrulamanızı, hedef sunucunun güncel durumunu ve yerel ağ yapılandırmanızı sistematik biçimde kontrol etmeniz gerekir.

Proxy ortamlarında 502 hatasının işleyişini anlamak

HTTP 502 durum kodu, 5xx sunucu hatası yanıtları sınıfının bir parçasıdır. Eksik kaynağı belirten 404 hatasından ya da izin reddini belirten 403 hatasından farklı olarak 502 hatası, doğrudan iki sunucu arasındaki iletişim başarısızlığıyla ilgilidir. GProxy gibi bir hizmet kullanırken proxy sunucusu "ağ geçidi" rolünü üstlenir. Bir istek gönderdiğinizde istemciniz proxy ile, proxy de hedef site ile konuşur. Hedef site hatalı biçimlendirilmiş bir başlık döndürürse, bağlantıyı erken keserse veya boş bir yanıt gönderirse, proxy istemcinize 502 Bad Gateway bildirir.

Bu hata özellikle web scraping, otomatik testler ve yüksek frekanslı veri toplamada sık görülür. Proxy katmanı ile nihai hedef arasındaki devir tesliminin kesintiye uğradığını gösterir. Sorunu gidermek için istek mimarisinin üç temel bileşenini incelemeliyiz:

• İstemci: İlk isteği yapan tarayıcınız, betiğiniz veya yazılımınız.
• Proxy (ağ geçidi): IP'nizi gizleyen ve trafiği yönlendiren GProxy sunucusu.
• Upstream (hedef): Ulaşmak istediğiniz veriyi veya siteyi barındıran hedef sunucu.

Proxy kaynaklı 502 hatalarının yaygın nedenleri

Kalıcı çözüm için ilk adım kök nedeni belirlemektir. Hata mesajı genel olsa da altta yatan tetikleyiciler genellikle belirli ve tekrarlanabilirdir. Proxy kullanırken alınan 502 hatalarının çoğu şu kategorilerden birine girer:

1. Upstream sunucunun aşırı yüklenmesi veya kapalı olması

502 hatasının en sık nedeninin proxy ile ilgisi yoktur. Hedef site trafik patlaması yaşıyorsa veya arka uç veritabanı yavaşlamışsa, proxy'nin isteğine belirlenen zaman aşımı süresi içinde yanıt veremeyebilir. Proxy yanıtı bekler, hiçbir şey ya da kısmi bir paket alır ve sonunda vazgeçerek 502 döner.

2. Web uygulama güvenlik duvarları (WAF) ve anti-bot sistemleri

Gelişmiş siteler Cloudflare, Akamai veya DataDome gibi WAF'ler kullanır. Bu sistemler otomatik trafiği tespit etmek için tasarlanmıştır. İstek deseniniz şüpheli görünüyorsa (örneğin yüksek istek frekansıyla bir veri merkezi proxy'si kullanıyorsanız) WAF bağlantıyı ortada kesebilir. Bağlantı güvenlik duvarı tarafından aniden sonlandırıldığı için GProxy sunucusu bunu "geçersiz yanıt" olarak algılar ve size 502 hatası iletir.

3. Protokol uyumsuzlukları

Proxy protokolü (HTTP, HTTPS, SOCKS5) ile hedef sunucunun beklentisi çakışırsa 502 hatası oluşabilir. Örneğin şifrelenmemiş bir HTTP isteğini yalnızca şifreli SSL/TLS trafiği bekleyen bir porttan zorlamak handshake hatasına yol açarak ağ geçidi hatasını tetikleyebilir.

4. DNS çözümleme sorunları

Proxy sunucusu hedef sitenin alan adını IP adresine çözemiyorsa ya da DNS kayıtları henüz yayılıyorsa proxy bağlantı kuramaz. Bu bazen 504 (Gateway Timeout) ile sonuçlansa da, DNS sunucusu "NXDOMAIN" veya SERVFAIL yanıtı döndürdüğünde birçok proxy yapılandırması varsayılan olarak 502 verir.

Teknik sorun giderme adımları

502 hatasıyla karşılaştığınızda sorunu yalıtmak ve çözmek için bu yapılandırılmış sırayı izleyin.

1. Hedef URL'yi doğrulayın: URL'yi proxy olmadan standart bir tarayıcıda test edin. Site herkes için kapalıysa 502 gerçektir ve sitenin kendi altyapısından kaynaklanır.
2. Proxy kimlik doğrulamasını kontrol edin: GProxy bilgilerinizin (kullanıcı adı ve parola) veya beyaz listeye alınmış IP'nizin doğru olduğundan emin olun. Hatalı kimlik doğrulama, proxy sunucusunun bağlantıyı upstream'e ulaşmadan reddetmesine yol açabilir; ancak bu genellikle 401 veya 407 hatasıyla sonuçlanır.
3. Proxy türünü değiştirin: Veri merkezi proxy'si kullanırken 502 alıyorsanız GProxy residential proxy'ye geçmeyi deneyin. Residential IP'lerin, geçersiz yanıtlara yol açan agresif WAF bağlantı kesmelerini tetikleme olasılığı daha düşüktür.
4. Zaman aşımı ayarlarını düzenleyin: Scraping betiğinizdeki zaman aşımı süresini artırın. 502 çoğu zaman proxy'nin yavaş bir upstream sunucudan çok erken vazgeçmesi nedeniyle oluşur.

502 hatalarını kodda çözmek (Python örnekleri)

Otomasyon için Python kullanan bir geliştiriciyseniz 502 hatalarını yeniden deneme mantığıyla düzgün biçimde ele alabilirsiniz. requests kütüphanesini urllib3 ile birlikte kullanmak, geçici ağ geçidi hatalarıyla başa çıkmanın sektör standardı olan üstel geri çekilme (exponential backoff) stratejisini uygulamanıza olanak tanır.

import requests
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry

def fetch_with_retry(url, proxy_url):
    session = requests.Session()

    # Yeniden deneme mantığı: 502, 503, 504 hatalarında tekrar dene
    retries = Retry(
        total=5,
        backoff_factor=1,
        status_forcelist=[502, 503, 504],
        raise_on_status=False
    )

    proxies = {
        "http": proxy_url,
        "https": proxy_url
    }

    session.mount("http://", HTTPAdapter(max_retries=retries))
    session.mount("https://", HTTPAdapter(max_retries=retries))

    try:
        response = session.get(url, proxies=proxies, timeout=30)
        if response.status_code == 200:
            return response.text
        else:
            return f"Failed with status: {response.status_code}"
    except Exception as e:
        return f"Request Error: {e}"

# GProxy residential endpoint ile örnek kullanım
GPROXY_URL = "http://username:[email protected]:8000"
TARGET = "https://example-target-website.com"
print(fetch_with_retry(TARGET, GPROXY_URL))

Yukarıdaki örnekte status_forcelist=[502, 503, 504] argümanı, betiğin Bad Gateway gördüğünde çökmemesini sağlar. Bunun yerine bekleyip yeniden dener; bu da 502'nin geçici bir ağ dalgalanmasından ya da hız sınırlamalı bir "yumuşak engelden" kaynaklandığı durumlarda sorunu çözer.

502 nedenlerinin karşılaştırılması: proxy mı, upstream mi?

Proxy hizmetinizdeki bir arıza ile hedefteki bir arızayı ayırt etmek çok önemlidir. Aşağıdaki tablo belirtiler ve çözümler arasındaki farkları özetler.

Büyük ölçekli operasyonlar için ileri düzey çözümler

Büyük ölçekli veri çıkarma veya SEO izleme yapan kullanıcılar için 502 hataları başarı oranını ciddi biçimde düşürebilir. Ölçekte sorun giderirken şu ileri düzey yapılandırmaları değerlendirin:

Başlık optimizasyonu

İstek başlıklarınız tutarsızsa upstream sunucu 502 dönebilir. Örneğin modern bir Chrome User-Agent kullanıp buna karşılık gelen Sec-Ch-Ua client hints başlıklarını eklemezseniz, WAF isteği "hatalı biçimlendirilmiş" sayarak bağlantıyı kesebilir. Başlıklarınızın eksiksiz olduğundan ve gerçek bir tarayıcının parmak iziyle örtüştüğünden emin olun.

Oturum kalıcılığı mı, rotasyon mu?

Sticky oturum kullanıyorsanız (birden çok istek için aynı proxy IP'si), 502 o IP'nin hedefin güvenlik duvarı tarafından işaretlendiğini gösterebilir. GProxy kolay rotasyon sunar. 502 oluştuğunda mantığınız, residential havuzundan yeni bir IP almak için oturum değişimini tetiklemelidir. Bu, bağlantı yolunu sıfırlar ve çoğu zaman ağ geçidi hatasını anında aşar.

MTU ve paket parçalanması

Nadir teknik senaryolarda 502 hatası MTU (Maximum Transmission Unit) uyumsuzluğundan kaynaklanır. Proxy'nin gönderdiği paketler, proxy ile upstream sunucu arasındaki bir ağ düğümü için fazla büyükse ve parçalanmaya izin verilmiyorsa paket düşürülür. Bu durum genellikle karmaşık VPN-üzerinden-proxy kurulumlarında görülür. MTU değerini 1400 veya 1450'ye düşürmek bu bağlantıları bazen stabilize eder.

GProxy 502 hatalarını neden azaltır

GProxy gibi yüksek kaliteli bir sağlayıcı kullanmak, 502 hatalarını en aza indirmenin proaktif bir yoludur. Düşük kaliteli veya ücretsiz proxy'lerin Nginx ya da Squid arka uçları çoğu zaman hatalı yapılandırılmıştır ve yüksek kaynak çekişmesi nedeniyle kendi içlerinde 502 üretir. GProxy, milyonlarca eşzamanlı bağlantıyı karşılamak üzere tasarlanmış sağlam ve yüksek erişilebilirlikli bir mimari kullanır.

Ayrıca GProxy'nin devasa residential IP havuzu sayesinde, upstream sunucu IP tabanlı hız sınırlaması nedeniyle 502 döndürdüğünde veriye ulaşmak için neredeyse sınırsız alternatif yolunuz olur. İstekleri farklı coğrafi konumlara ve ISP'lere dağıtarak, genellikle ağ geçidi hatalarına yol açan "darboğaz" etkisinden kaçınırsınız.

Önemli noktalar

• Kaynağı belirleyin: 502 hatası, proxy ile site arasındaki bir iletişim kopukluğudur; mutlaka proxy'nin arızası anlamına gelmez.
• Hedefi kontrol edin: Genel kesintiyi elemek için sitenin proxy olmadan erişilebilir olup olmadığını her zaman doğrulayın.
• Residential IP kullanın: GProxy residential proxy'ler, veri merkezi IP'lerinde 502 hatası tetikleyen WAF'leri aşmanın en etkili yoludur.
• Yeniden deneme uygulayın: Geçici hataları otomatik ele almak için kodunuzda üstel geri çekilme kullanın.

Pratik ipucu 1: 502 hatası alırsanız yanıt başlıklarındaki "Server" değerine bakın. "cloudflare" yazıyorsa engelleme hedef sitenin edge katmanında gerçekleşiyordur; proxy IP'nizi değiştirmeniz veya User-Agent'ınızı güncellemeniz gerekir.

Pratik ipucu 2: Kodunuzda her zaman açık bir zaman aşımı tanımlayın (örneğin timeout=60). Bazı kütüphanelerdeki kısa varsayılan zaman aşımları, proxy hâlâ upstream yanıtını beklerken bağlantıyı kapatarak 502 benzeri davranışa yol açabilir.