Business Central 504 Gateway Timeout: Uzayan API İşlemlerini Düzeltme

Business Central üzerinde 504 Gateway Timeout görülmesi, isteğin işlem süresi sınırına ulaşmasıyla ilişkili olabilir. Microsoft, belirli web servis çağrılarında süre sınırını ve uzun süren işlemleri daha küçük parçalara ayırma yaklaşımını açıklıyor.

İlk teşhis

Hatanın hangi işlemde oluştuğunu bulun: tüm stokları çekmek mi, büyük sipariş aktarımı mı, yoksa çok sayıda kayıt güncellemesi mi? Hata belli bir kayıt veya filtreyle mi tekrarlanıyor? Çağrının süresini ve ilgili filtreleri loglayın.

Düzeltme yaklaşımı

1. Kapsamı daraltın: Gereksiz sütun ve kayıtları istemeyin; gerektiğinde sayfalama kullanın.
2. Parçalara bölün: Büyük veri gruplarını küçük ve izlenebilir işlere ayırın.
3. İleri devam işareti kullanın: Son başarıyla işlenen kaydı hatırlayın ki kesinti sonrası en başa dönmeyin.
4. Yeniden denemeyi kontrollü yapın: Çok parçaya bölme çağrı sayısını artırır; bu kez 429 sınırına takılabilirsiniz.
5. İş durumunu görünür kılın: Kullanıcıya “tamamlandı” demek yerine tamamlanan/bekleyen kayıtları raporlayın.

429 ile 504 arasındaki fark

429 istek sınırına ulaşılmasına, 504 ise zaman aşımı senaryosuna işaret eder. İkisini aynı yeniden deneme kuralıyla çözmeye çalışmak doğru değildir. 504'te asıl işlem yapısının yeniden tasarlanması gerekebilir.

Entegrasyon testi

Örnek veriyle hızlı çalışan bir istek üretim veri hacminde yavaşlayabilir. Pilot testte gerçekçi veri miktarı, iş yoğunluğu ve aynı anda çalışan kullanıcı sayısını temsil edin.

Yanıt gelmediyse yazma işlemi gerçekleşmiş olabilir mi?

Evet; aradaki ağ geçidinden gelen zaman aşımı, ERP'de hiçbir işlem yapılmadığının kanıtı değildir. Önce hatayı üreten katmanı ve işlem referansını belirleyin. Yazma isteğini yeniden göndermeden önce kaydın varlığını kontrol edin; sonuç doğrulanamıyorsa incelemeye alın.

Örnek senaryo: Toplu aktarımın ilk bölümü tamamlanmış, ikinci bölümün yanıtı kaybolmuştur. Son doğrulanmış bölümden devam etmek ve ikinci bölümün kayıtlarını karşılaştırmak gerekir. Bütün dosyayı yeniden göndermek mükerrer kayıt riski yaratır.

Ölçüm kaydında süre, sayfa/bölüm numarası ve işlem referansı yeterlidir; müşteri verisini ve kimlik bilgilerini gereksiz kaydetmeyin.

Kaynaklar ve doğrulama

• learn.microsoft.com — resmî doküman

Örnek akışlar mimari öneridir; tamamlanmış müşteri projesi veya üretici iş ortaklığı iddiası değildir. Teknik kaynak kontrolü: 17 Ekim 2026. Kurulumun sürümü, lisansı ve izinleri ayrıca doğrulanır.

İşletmenizdeki akışa uyarlayın

ERP entegrasyonu planlama rehberi. Özel yazılım geliştirme kapsamını inceleyebilir, mevcut sürecinizi birlikte değerlendirebiliriz.

İhtiyacınızı konuşalım →