WordPress admin-ajax.php 400 Hatası: 8 Teknik Kontrol

WordPress admin-ajax.php 400 Hatası Nasıl Çözülür?

WordPress admin-ajax.php Nedir ve Ne İşe Yarar?

admin-ajax.php, WordPress’in klasik AJAX isteklerini işlemek için kullandığı çekirdek dosyadır.

AJAX, web sayfası tamamen yenilenmeden tarayıcı ile sunucu arasında veri alışverişi yapılmasına olanak sağlar.

WordPress yönetim panelinde ve ön yüzde çeşitli dinamik işlemler bu sistemden yararlanabilir.

admin-ajax.php hangi işlemlerde kullanılır?

admin-ajax.php dosyası nerede bulunur?

/wp-admin/admin-ajax.php

Dosyanın genel WordPress kurulumu içindeki yolu budur.

Ancak alt dizinde kurulu veya özel URL yapılandırması kullanan sitelerde gerçek adres farklı olabilir.

Bu nedenle AJAX URL’si kod içinde sabit yazılmak yerine WordPress’in admin_url() işleviyle oluşturulmalıdır.

WordPress AJAX isteğini nasıl yönlendirir?

Tarayıcı, isteğin içinde action adlı bir parametre gönderir.

WordPress bu değere göre hangi PHP işleyicisinin çağrılacağını belirler.

AJAX URL:
https://example.com/wp-admin/admin-ajax.php

İstek:
action=zm_example_search

WordPress hook:
wp_ajax_zm_example_search

Giriş yapmamış ziyaretçi:
wp_ajax_nopriv_zm_example_search

WordPress AJAX Hatalarında Belirtiye Göre İlk Teşhis

WordPress admin-ajax.php 400 Hatası İçin 8 Teknik Kontrol

Eksik action:

POST /wp-admin/admin-ajax.php

Form Data:
keyword=seo

Boş action:

action=
keyword=seo

POST /wp-admin/admin-ajax.php

Form Data:

action=zm_example_search
keyword=seo

WordPress admin-ajax.php 400, 403, 404 ve 500 Hataları Arasındaki Fark Nedir?

AJAX isteklerinde görülen HTTP durum kodları ilk teşhis için önemli ipuçları sunar.

Ancak bu kodlar tek başına kesin kök nedeni belirlemez.

HTTP 200 ama işlem başarısızsa?

HTTP 200 her zaman uygulamanın işlemi başarıyla tamamladığını göstermez.

Örneğin bir AJAX işleyicisi aşağıdaki yanıtı HTTP 200 ile döndürebilir.

{
  "success": false,
  "data": {
    "message": "İşlem doğrulanamadı."
  }
}

Bu durumda ağ isteği tamamlanmıştır ancak uygulama işlemi başarısız kabul etmiştir.

WordPress wp_send_json_error() işlevi, geliştirici ayrıca durum kodu belirtmedikçe otomatik olarak HTTP 400 üretmek zorunda değildir.

Chrome DevTools ile admin-ajax.php 400 Hatası Nasıl Tespit Edilir?

Tarayıcı geliştirici araçları, AJAX hatasının gerçek istek ve yanıtını görmeyi sağlar.

12 adımda Network analizi

1. Hata veren sayfayı açın. Form veya AJAX işleminin bulunduğu sayfaya gidin.
2. Geliştirici araçlarını açın. Chrome’da F12 veya Inspect kullanın.
3. Network sekmesine geçin. Ağ isteklerini görüntüleyin.
4. Fetch/XHR filtresini seçin. Dinamik istekleri ayırın.
5. Gerekirse Preserve log etkinleştirin. Sayfa yönlendirmesinde kayıtların kaybolmasını önleyin.
6. Hata veren işlemi yeniden oluşturun. Örneğin formu test verisiyle gönderin.
7. admin-ajax.php isteğini seçin. İstek listesinden açın.
8. Headers bölümünü kontrol edin. URL, HTTP metodu ve durum kodunu kaydedin.
9. Payload bölümünü açın. Action, nonce ve gereken alanların bulunup bulunmadığını kontrol edin.
10. Response bölümünü inceleyin. 0, -1, JSON veya HTML güvenlik sayfası mı?
11. Initiator bilgisini kontrol edin. Hangi JavaScript dosyası isteği başlatmış?
12. Sonuçları zaman ve oturumla eşleştirin. Gerekirse sunucu loguyla karşılaştırın.

Örnek teşhis kaydı

WordPress’te Doğru AJAX İşleyicisi Nasıl Yazılır?

Aşağıdaki örnekler, WordPress AJAX sisteminin doğru kullanımını açıklamak için hazırlanmıştır.

Makale içindeki kodlar otomatik olarak çalışmaz. Canlı sitede uygulamadan önce geliştirici tarafından uyarlanmalıdır.

1. AJAX işleyicisinin kaydedilmesi

add_action(
  'wp_ajax_zm_example_search',
  'zm_example_search_handler'
);

add_action(
  'wp_ajax_nopriv_zm_example_search',
  'zm_example_search_handler'
);

function zm_example_search_handler() {

  check_ajax_referer(
    'zm_example_search_nonce',
    '_ajax_nonce'
  );

  $keyword = isset( $_POST['keyword'] )
    ? sanitize_text_field(
        wp_unslash( $_POST['keyword'] )
      )
    : '';

  if ( '' === $keyword ) {
    wp_send_json_error(
      array(
        'message' => 'Arama metni boş.'
      ),
      400
    );
  }

  wp_send_json_success(
    array(
      'keyword' => $keyword
    )
  );
}

Bu örnekte boş anahtar kelime için geliştirici tarafından bilinçli olarak HTTP 400 döndürülmektedir.

Dolayısıyla bu tür bir yanıt çekirdek action hatasından farklıdır.

2. AJAX URL ve nonce değerinin JavaScript’e iletilmesi

wp_localize_script(
  'zm-example-script',
  'zmAjaxData',
  array(
    'ajaxUrl' => admin_url(
      'admin-ajax.php'
    ),
    'nonce' => wp_create_nonce(
      'zm_example_search_nonce'
    )
  )
);

Burada zm-example-script adlı JavaScript dosyasının önceden WordPress’e kaydedilmiş ve sayfaya eklenmiş olması gerekir.

3. JavaScript fetch örneği

const body = new URLSearchParams({
  action: 'zm_example_search',
  _ajax_nonce: zmAjaxData.nonce,
  keyword: 'wordpress seo'
});

fetch(zmAjaxData.ajaxUrl, {
  method: 'POST',
  credentials: 'same-origin',
  body
})
.then(async response => {
  const result = await response.json();

  if (!response.ok || !result.success) {
    throw new Error('AJAX işlemi başarısız');
  }

  return result.data;
})
.then(data => {
  console.log(data);
})
.catch(error => {
  console.error(error.message);
});

Bu örnekte URLSearchParams form kodlamasına uygun istek gövdesi oluşturur.

WordPress böylece action parametresini standart istek alanından okuyabilir.

4. Yetkili işlemlerde ek kontrol

if ( ! current_user_can( 'manage_options' ) ) {
  wp_send_json_error(
    array(
      'message' => 'Yetkisiz işlem.'
    ),
    403
  );
}

Bu tür yetki kontrolleri yalnızca ilgili işlemin gerçekten gerektirdiği yetkiyle eşleştirilmelidir.

Her kullanıcıya açık sorgu işlemi için yönetici yetkisi istemek doğru değildir.

admin-ajax.php Hatası Giderilirken Hangi Güvenlik Önlemleri Alınmalı?

WordPress AJAX sorunlarını çözmeye çalışırken güvenlik önlemlerinin devre dışı bırakılması yeni riskler oluşturabilir.

Özellikle yönetici işlemlerini herkese açık hâle getirmek veya nonce kontrolünü kaldırmak güvenli değildir.

Kaçınılması gereken yöntemler

• admin-ajax.php dosyasını tamamen değiştirmek
• Bütün AJAX işlemlerini nopriv yapmak
• Nonce doğrulamasını rastgele kaldırmak
• Tüm WAF kurallarını kalıcı kapatmak
• Canlı sitede debug bilgilerini herkese göstermek
• Çerez ve oturum verilerini herkese açık paylaşmak
• PHP veya eklenti dosyalarını yedeksiz değiştirmek
• Canlı ödeme ve müşteri formlarında kontrolsüz test yapmak

Önerilen güvenli yöntem

1. Güncel yedek alın. Dosyalar ve veritabanı korunmalıdır.
2. Staging ortamında hata oluşturun. Mümkünse canlı trafiği etkilemeyin.
3. Gerçek action değerini belirleyin. Hatalı işlemin sahibini bulun.
4. HTTP kodunu ve yanıtı doğrulayın. Tahmine göre işlem yapmayın.
5. Tek değişkenli test uygulayın. Her adımın etkisini ölçün.
6. Çözümü en dar kapsamda uygulayın. Güvenlik önlemlerini koruyun.
7. Hem giriş yapan hem ziyaretçi testini tamamlayın. Uygun erişim modelini doğrulayın.

WordPress admin-ajax.php 400 Hatası: 8 Neden ve Çözüm Tablosu

WordPress admin-ajax.php 400 Hatası İçin 12 Adımlık Test Planı

WordPress AJAX hatalarında ilk hedef, hatayı üreten gerçek isteğin belirlenmesidir.

Aynı anda çok sayıda eklenti, cache ve sunucu ayarı değiştirmek teşhisi zorlaştırır.

1. Hatanın görüldüğü işlemi belirleyin. Form, arama, yönetim veya eklenti işlemi mi?
2. DevTools Network panelini açın. Gerçek AJAX isteğini yakalayın.
3. Status Code ve Response Body kaydedin. 400 + 0 mu, başka yanıt mı?
4. Action parametresini kontrol edin. Var, geçerli ve doğru mu?
5. Action için kayıtlı hook’u doğrulayın. PHP işleyici gerçekten yükleniyor mu?
6. Giriş yapan ve ziyaretçi durumlarını karşılaştırın. nopriv eksik olabilir mi?
7. Nonce doğrulamasını inceleyin. 403 ve -1 yanıtını ayırın.
8. Request URL ve veri formatını doğrulayın. GET, POST, JSON veya form verisi.
9. İsteği başlatan JavaScript’i bulun. Eklenti veya tema ilişkisini belirleyin.
10. Cache ve WAF katmanlarını inceleyin. Kaynak doğrulanmadan kapatmayın.
11. PHP ve sunucu günlüklerini kontrol edin. Aynı zamanlı hata kayıtlarını eşleştirin.
12. Düzeltmeden sonra güvenli test yapın. Yetkili ve ziyaretçi senaryolarını doğrulayın.

WordPress admin-ajax.php 400 Hatası İçin 20 Maddelik Kontrol Listesi

• Hata veren gerçek AJAX isteği bulundu mu?
• HTTP durum kodu doğrulandı mı?
• Response Body incelendi mi?
• action parametresi mevcut mu?
• action değeri doğru mu?
• İlgili PHP AJAX işleyicisi kayıtlı mı?
• Giriş yapan kullanıcı için wp_ajax kaydı var mı?
• Gerekliyse wp_ajax_nopriv kaydı var mı?
• Nonce alanı ve aksiyon adı kontrol edildi mi?
• HTTP 400 ile 403 ayrımı yapıldı mı?
• Request URL doğru mu?
• GET/POST ve veri formatı doğru mu?
• İsteği başlatan JavaScript dosyası belirlendi mi?
• Console hataları incelendi mi?
• Özel kod ve eklenti güncellemeleri değerlendirildi mi?
• WAF ve ModSecurity logları kontrol edildi mi?
• LiteSpeed Cache ve CDN kaynaklı eski veri araştırıldı mı?
• PHP debug.log ve sunucu error log karşılaştırıldı mı?
• Staging üzerinde kontrollü test gerçekleştirildi mi?
• Çözüm sonrası güvenlik ve işlevsellik doğrulandı mı?

WordPress AJAX ve Teknik Hatalar İçin İlgili Zeymedya Rehberleri

WordPress web sitelerinin tasarımı, teknik yapılandırması ve yönetimi hakkında WordPress Web Tasarım Hizmetleri sayfamızı inceleyebilirsiniz.

Web sitesi kullanıcı deneyimi ve form dönüşümlerinin geliştirilmesi için Dönüşüm Optimizasyonu hizmet sayfamıza göz atabilirsiniz.

WordPress admin-ajax.php 400 Hatası Hakkında Sık Sorulan Sorular

Sonuç: WordPress admin-ajax.php 400 Hatasında Önce Action ve Hook Kontrol Edilmelidir

WordPress admin-ajax.php 400 hatası, farklı teknik katmanlardan kaynaklanabilen bir AJAX sorunudur.

WordPress çekirdek kodunda, eksik veya geçersiz action değeri HTTP 400 yanıtı oluşturabilir.

Kayıtlı olmayan AJAX işleyicileri ve giriş yapan kullanıcı ile ziyaretçi arasındaki hook farklılıkları da benzer sonuçlar verebilir.

Nonce doğrulama hataları ise standart WordPress uygulamasında HTTP 403 ve -1 yanıtıyla ayırt edilebilir.

Bu nedenle doğru teşhis için tarayıcı Network panelindeki gerçek istek, durum kodu, payload ve response bilgileri birlikte incelenmelidir.

Eklenti, tema, WAF, LiteSpeed Cache ve sunucu günlükleri ancak somut bulgularla ilişkilendirildikten sonra değiştirilmelidir.

Doğru action, doğru AJAX hook, güvenli nonce ve yetki doğrulaması, uygun istek formatı ve kontrollü sunucu teşhisi, WordPress AJAX işlemlerinin güvenilir şekilde çalışmasına yardımcı olur.

WordPress admin-ajax.php Sorunları İçin Resmî Teknik Kaynaklar