TR EN

Laravel 419 Page Expired: Form, Fetch ve Oturum Kontrolü

Laravel’de 419 Page Expired çoğunlukla CSRF tokenı ile oturumun uyuşmamasını belirtir. Hata kodu tek başına hangi ayarın yanlış olduğunu göstermez.

Önce sürümü ve başarısız isteği belirleyin

php artisan --version ile sürümü öğrenin; tarayıcının Ağ panelinden hatalı isteğin yöntemini ve adresini kontrol edin. 419, IANA’da standart bir HTTP durumuna atanmış değildir.

Laravel 13 farkı: varsayılan istek sahteciliği koruması önce Sec-Fetch-Site ile aynı kaynağı kontrol eder, gerekirse token doğrulamasına geçer. Yalnız kaynak doğrulaması modunda ret 403 olabilir. 13.x belgesindeki davranışı kullandığınız ayarlarla karşılaştırın.

1. Normal Blade formu

Korunan formda @csrf bulunmalı; bu direktif gizli token alanını üretir. Aşağıdaki örneği kendi POST rotanıza ve alanlarınıza uyarlayın:

<form method="POST" action="/profile">
    @csrf
    <button type="submit">Save</button>
</form>

Sayfayı yeni açınca çalışan, uzun süre açık kalınca hata veren form için oturum yenilenmesini araştırın. Kaybolabilecek yazıyı koruyup tekrar giriş yapın. Süreyi gelişigüzel uzatmak yerine hatanın ne zaman başladığını kaydedin.

2. Aynı kaynakta Fetch / AJAX

Blade meta etiketindeki tokenı X-CSRF-TOKEN başlığına koyabilirsiniz. X-XSRF-TOKEN farklı, çereze dayalı yöntemdir; ikisinin değerlerini karıştırmayın. Laravel 12 başlık açıklaması.

<!-- In a Blade view served by your own application -->
<meta name="csrf-token" content="{{ csrf_token() }}">
<script>
async function saveProfile(displayName) {
    const response = await fetch('/profile', {
        method: 'POST',
        credentials: 'same-origin',
        headers: {
            'Accept': 'application/json',
            'Content-Type': 'application/json',
            'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content
        },
        body: JSON.stringify({ display_name: displayName })
    });
    return response.status;
}
</script>

Örnek yalnız aynı kaynak içindir; rotayı oluşturmaz ve fonksiyonu kendiliğinden çağırmaz. Doğru token başlığıyla birlikte oturum çerezinin de gönderildiğini kendi tarayıcınızda inceleyin. Token, çerez veya gerçek form içeriğini dış test servislerine yapıştırmayın.

3. Çerez ve oturumun sürekliliği

  • Çerez gönderilmiyorsa: tarayıcının engelleme gerekçesine, Domain, Path, Secure ve SameSite alanlarına bakın. HTTPS ile beklenen alan adının kullanıldığını doğrulayın.
  • Hata aralıklıysa: aynı istek akışını sunucu düğümü ve zamanla eşleştirin. Çok sunuculu kurulumda her düğümün aynı oturumu okuyabildiğini kontrol edin.
  • Oturum kayboluyorsa: config/session.php içindeki mevcut sürücüyü ve depolama erişimini inceleyin. Sürücüyü rastgele file olarak değiştirmeyin. Oturum yapılandırması.

4. SPA / Sanctum veya harici webhook

Sanctum SPA akışında izinli birinci taraf alanları, çerez kapsamı ve istemcinin credentials ayarı birlikte ele alınır. Ayrı alt alan adı kullanıyorsanız Sanctum SPA rehberini ve CORS rehberini izleyin.

Harici webhook gönderen servis sizin tarayıcı oturumunuzu taşımaz. İlgili rotanın middleware tasarımını sürüm belgesine göre ayırın ve sağlayıcının imza doğrulamasını uygulayın. Bütün uygulamanın CSRF korumasını kaldırmayın. Webhook aracı yalnız sentetik test isteklerini incelemek içindir; uygulamanızın oturumunu doğrulamaz.

Değişikliği nasıl doğrularsınız?

Aynı yöntem ve adresle yeni oturumda tekrar deneyin; ardından sorunu başlatan bekleme veya alt alan adı koşulunu sınayın. Yapılandırmayı değiştirdiyseniz üretim yayın akışındaki yapılandırma önbelleğini yenileyin. Toplu önbellek silmeyi genel çözüm olarak uygulamayın. Laravel yayın belgesi.

Sonuç hâlâ başarısızsa istek kimliği, zaman ve maskelenmiş hata türünü eşleştirin. Oturum reddi için 401, uygulama istisnası için 500 rehberine geçin. İnceleme tarihi: .

Sık Sorulan Sorular

Sadece SESSION_LIFETIME değerini artırmak 419’u çözer mi?
Yalnızca süre dolumu doğrulanmışsa süre politikası ilgili olabilir. Eksik token, gönderilmeyen çerez veya erişilemeyen oturum deposu ayrı nedenlerdir.
Yerel testler geçerken üretimde neden 419 görülebilir?
Önce test ortamında koruma middleware’inin gerçekten çalışıp çalışmadığını kontrol edin. Üretimdeki HTTPS, çerez kapsamı, alt alan adı ve oturum deposu farklılıklarını aynı istek üzerinden karşılaştırın.
SSL kontrol aracı CSRF tokenımı doğrular mı?
Hayır. TLS kontrolü bağlantının sertifika durumunu inceler. CSRF ve oturum eşleşmesini kendi uygulamanızda ve tarayıcınızda incelemeniz gerekir.