
WordPress yazıyı kaydederken “Güncelleme başarısız. Yanıt geçerli bir JSON yanıtı değil” uyarısı veriyorsa editör sunucudan beklediği biçimde cevap alamamıştır. Mesaj tek başına hatalı eklentiyi göstermez. Aynı uyarının arkasında yönlendirilmiş bir HTML sayfası, güvenlik engeli veya sunucu hatası bulunabilir.
En yararlı başlangıç, başarısız kaydetme isteğinin durum kodunu ve yanıtını görmektir. İçeriğinizi koruyup bu bilgiyi topladıktan sonra ilgili ayarı değiştirebilirsiniz. Kayıt düğmesine art arda basmak ya da tüm eklentileri canlı sitede kapatmak, teşhisi kolaylaştırmadan başka işlemleri etkileyebilir.
Kaydedilmemiş içeriği ve mevcut siteyi koruyun
Hata veren sekmeyi kapatmadan yazdığınız metni yerel bir belgeye kopyalayın. Gerekirse editörün kod görünümündeki blok içeriğini de ayrı kaydedin. Otomatik kayıt veya revizyon bulunduğunu varsaymayın; başarısız istek bunların oluşmasını da engellemiş olabilir. Yazıyı başka sekmede açıp son kayıt zamanını kontrol edin, ancak ilk sekmedeki içeriğin üzerine yazmayın.
Yapılandırma, eklenti veya sunucu dosyası değiştirmeden veritabanı ve dosyaları kapsayan güncel yedek alın. Sadece içerik dışa aktarımı tam site geri dönüşü sağlamaz. Henüz bir yönteminiz yoksa WordPress yedekleme planını kullanarak geri dönüş noktasını hazırlayın. Deneme ortamı varsa sonraki çakışma testlerini orada yapın. Notunuza hatanın zamanı, kullanılan hesap ve hangi yazıda oluştuğunu ekleyin.
Site Sağlığı ve REST kök adresini kontrol edin
Araçlar → Site Sağlığı ekranını açın. REST API veya geri döngü isteğiyle ilgili uyarının ayrıntısını kaydedin. Bu ekran başlangıç ipucu verir; bir uyarı tek başına editördeki belirli isteğin neden başarısız olduğunu kanıtlamaz. WordPress Site Sağlığı belgesi bu testleri ve hata gösterimi gibi ilgili yapılandırmaları açıklar.
Normal bir kalıcı bağlantı kurulumunda alan adınızın sonuna /wp-json/ ekleyerek REST kökünü açabilirsiniz. WordPress alt dizindeyse adres de o dizini içermelidir. Düz kalıcı bağlantı kullanan kurulumlarda /?rest_route=/ biçimi kullanılabilir. WordPress’in REST API el kitabı veri alışverişinin JSON yapısını açıklar.
Kökte JSON görmek yalnızca bu isteğin çalıştığını gösterir. Yazı kaydetme yetki gerektiren başka bir uç noktaya ve farklı HTTP yöntemine gider. Kök açılıyor diye güvenlik veya oturum sorununu elemiş olmazsınız. Tarayıcıda yetkili bir uç noktayı doğrudan açmanın da editörün oturum ve doğrulama bilgilerini taşıyan isteğiyle birebir aynı olmadığını aklınızda tutun.
Başarısız kaydetme isteğinin yanıtını okuyun
Masaüstü tarayıcıda geliştirici araçlarını açıp Network/Ağ sekmesine geçin. İstek listesini temizleyin, ardından yazıyı bir kez kaydetmeyi deneyin. Fetch/XHR filtresinde wp-json veya rest_route içeren, kaydetme anında gönderilmiş isteği bulun. Sitenizde farklı bir düzen varsa istek adresi değişebilir; yalnızca dosya adını değil zamanını da eşleştirin.
İsteğin URL adresini, HTTP yöntemini ve durum kodunu not edin. Response/Yanıt bölümünde gövdeyi inceleyin: Süslü parantezli JSON mu, giriş sayfası mı, güvenlik uyarısı mı, PHP hata metni mi? Başlıklardaki içerik türü de ipucudur. 200 koduyla dönen bir HTML sayfası editör için yine yanlış biçim olabilir; kırmızı görünen istekleri aramak tek başına yeterli değildir.
403 erişim reddi, 500 sunucu hatası yönünde araştırma gerektirir. JSON içinde code ve message alanları varsa onları da kaydedin; geçerli JSON taşıyan bir yetki hatası, HTML engel sayfasından farklıdır. Destek ekibine göndereceğiniz ekran görüntülerinde çerezleri, nonce değerlerini, Authorization başlıklarını ve kişisel içeriği gizleyin. Tam Ağ kaydını herkese açık paylaşmayın.
Adres ve kalıcı bağlantı uyuşmazlığını giderin
Ayarlar → Genel bölümünde WordPress adresi ile site adresinin beklenen kurulumunu kontrol edin. HTTP/HTTPS veya www farkı yanlış yönlendirmeye neden olabilir. Alt dizinde kurulu WordPress’te iki adresin farklı olması bazen bilinçli bir yapılandırmadır; sırf farklı görünüyor diye eşitlemeyin. Taşıma veya HTTPS geçişi sonrası başladıysa başarısız isteğin hangi adrese yönlendiğini Ağ ekranından takip edin.
Kalıcı bağlantı yönlendirmesinden şüpheleniyorsanız mevcut yapıyı not alın ve Ayarlar → Kalıcı bağlantılar ekranında yapıyı değiştirmeden kaydedin. Sonra REST isteğini yeniden deneyin. Bu işlem bazı yeniden yazma kurallarını tazeleyebilir; Nginx veya hosting yapılandırmasındaki eksik kuralı her ortamda düzeltmez. Sonuç değişmiyorsa aynı işlemi tekrar tekrar yapmayın.
Bir yönlendirme veya bakım eklentisi REST isteğini giriş sayfasına götürüyorsa yalnızca ilgili kuralı inceleyin. Sunucu yapılandırmasını bilmeden .htaccess dosyasını bütünüyle silmek doğru bir ilk adım değildir. Adres değişikliklerini uygulamadan önce yönetim paneline yeniden erişebileceğinizden ve geri dönüş yolundan emin olun.
403 yanıtında güvenlik kuralını dar kapsamda inceleyin
Yanıt bir güvenlik engel sayfasıysa hosting WAF kaydını veya güvenlik eklentisinin olay günlüğünü hatanın zamanı ile karşılaştırın. İstek yolu, HTTP yöntemi ve engelleyen kural kimliği, hosting ekibinin somut bir inceleme yapmasını sağlar. “WordPress kaydetmiyor” yerine belirli isteğin 403 döndüğünü bildirin. İlgili kontrolleri WordPress 403 hatası rehberinden takip edebilirsiniz.
WAF korumasını tamamen kapatmayın ve bütün /wp-json/ yolunu kontrolsüz biçimde muaf tutmayın. Yanlış pozitif doğrulanırsa yalnızca gerekli istek veya kurala yönelik istisna planlanmalıdır. WordPress.org üzerindeki bir destek konusu, WAF’ın REST isteğine HTML/403 döndürmesinin geçersiz JSON mesajına yol açabildiği bir örnektir; bu örnek her sitede aynı kuralın sorumlu olduğunu göstermez.
Yanıt oturum veya nonce hatasına işaret ediyorsa yerel içeriği koruduktan sonra yeniden giriş yapıp editörü yenileyin. Resmi REST kimlik doğrulama belgesi, WordPress içindeki çerez tabanlı isteklerin nonce doğrulamasını anlatır. Bunun için yeni API anahtarı üretmek veya editöre yönetici şifresi yazmak gerekmez.
500 ve PHP çıktısında sunucu günlüklerine bakın
Yanıt 500 ise hosting PHP hata günlüğünde aynı saniyeye yakın kaydı bulun. Bellek sınırı, eksik dosya veya bir eklentinin ölümcül hatası gibi ayrıntı orada görülebilir; yalnızca durum kodundan neden çıkarmayın. Yanıt gövdesinde Warning veya Notice metni JSON’un önüne eklenmişse hatayı tarayıcıya basan yapılandırma da incelenmelidir.
Hata bilgisi kullanıcıya veya API yanıtına basılmak yerine kontrollü biçimde sunucu günlüğüne yazılmalıdır. Hosting panelinin mevcut kayıtları çoğu durumda ilk bakılacak yerdir. WordPress hata ayıklamasını açmak gerekiyorsa geliştiriciyle birlikte günlük erişimini, görünürlüğü ve işlem sonrası kapatmayı planlayın. Günlüklerin herkese açık kalmasına izin vermeyin; yalnızca hata metnini gizlemek de asıl PHP sorununu onarmaz.
Çakışmayı kontrollü test edin ve kaydı doğrulayın
Hata son güncellemeden sonra başladıysa önce ilgili eklenti veya tema değişikliğini deneme ortamında sınayın. Eklentileri sırayla devre dışı bırakıp aynı kayıt işlemini tekrar ederek sonucu kaydedin. Eklenti çakışması rehberi bu testi düzenli yürütmenize yardımcı olur. Ürün, üyelik veya ödeme işlemlerini etkileyen eklentileri canlı sitede topluca kapatmayın.
Düzeltmeden sonra küçük bir deneme yazısını kaydedin ve editörden çıkıp yeniden açın. Son değişikliğin gerçekten sunucuda bulunduğunu doğrulayın; yalnızca uyarının kaybolması yeterli değildir. Ardından ilk hata veren içeriği tekrar deneyin. Sadece o içerik başarısız oluyorsa belirli blok, gömülü içerik veya istek içeriğine uygulanan güvenlik kuralı gibi daha dar bir farkı araştırın.
Hosting ekibine başvurmanız gerekirse istek yolu, zaman, durum kodu, yanıt türü ve yaptığınız testleri kısa bir notta birleştirin. Bu bilgiler aynı kontrollerin tekrarlanmasını azaltır. İçeriğiniz güvenli kopyada kaldığı için teşhis boyunca yazıyı yeniden oluşturmaya çalışmak yerine başarısız isteğe odaklanabilirsiniz.
REST isteğinin yanıtını yorumlamak veya güvenlik ve sunucu kayıtlarını eşleştirmek için yardım gerekiyorsa WordPress destek hizmeti üzerinden hata zamanı ve kişisel bilgileri temizlenmiş test sonuçlarıyla başvurabilirsiniz.