Ürün aktarımı yaparken zaman aşımı hataları nasıl azaltılır?

Ürün aktarımı sırasında zaman aşımı hataları genellikle tek bir nedenden kaynaklanmaz; dosya boyutu, veritabanı sorguları, PHP limitleri, eklenti davranışları ve hosting kaynakları birlikte değerlendirilmelidir. Özellikle WooCommerce, pazaryeri entegrasyonları veya toplu CSV/XML içe aktarımlarında işlem birkaç dakikayı aştığında sunucu yanıt vermeyi kesebilir, aktarım yarıda kalabilir ya da bazı ürünler eksik oluşabilir. Bu riski azaltmak için aktarımı yalnızca tekrar denemek yerine, süreci daha küçük, kontrollü ve izlenebilir hale getirmek gerekir.

Zaman aşımı hataları neden oluşur?

Bir ürün aktarımı başladığında sistem yalnızca ürün adlarını kopyalamaz. Varyasyonlar, görseller, kategoriler, stok bilgileri, fiyat kuralları, özel alanlar ve meta veriler de işlenir. Her ürün için veritabanına yazma, görsel indirme, küçük resim oluşturma ve eklenti tetikleme işlemleri çalışabilir.

Bu işlemler sunucunun izin verdiği maksimum çalışma süresini aşarsa zaman aşımı oluşur. Hata bazen ekranda “timeout”, “504 gateway timeout” veya “maximum execution time exceeded” olarak görünür. Bazen de aktarım sessizce durur ve kullanıcı yalnızca eksik ürünleri fark eder.

Aktarımı parçalara bölerek riski azaltın

En pratik yöntem, büyük dosyayı tek seferde aktarmak yerine parçalara ayırmaktır. 10.000 ürün içeren bir dosya yerine 500 veya 1.000 ürünlük paketlerle ilerlemek, hem sunucu yükünü azaltır hem de hata olduğunda hangi bölümde sorun yaşandığını görmeyi kolaylaştırır.

Dosya bölme sırasında dikkat edilmesi gerekenler

• Her parçanın aynı sütun başlıklarını içerdiğinden emin olun.
• Varyasyonlu ürünleri ana ürünlerinden ayrı düşürmeyin.
• SKU veya benzersiz ürün kodlarını değiştirmeyin.
• Görsel URL’leri çalışmıyorsa önce bu alanları temizleyerek test aktarımı yapın.

Parçalı aktarım özellikle görsel sayısı yüksek kataloglarda fark yaratır. Çünkü görsellerin uzak sunucudan indirilmesi ve WordPress ortamında işlenmesi, ürün verisinin kaydedilmesinden daha uzun sürebilir.

Sunucu ve PHP limitlerini kontrol edin

Aktarım başlamadan önce PHP yapılandırmasını kontrol etmek gerekir. max_execution_time, memory_limit, upload_max_filesize ve post_max_size değerleri düşükse büyük ürün dosyalarında hata ihtimali artar. Paylaşımlı hosting paketlerinde bu limitler belirli sınırlar içinde değiştirilebilir; daha yoğun kataloglarda VPS veya bulut tabanlı bir yapı daha uygun olabilir.

Genel olarak ürün aktarımı için memory_limit değerinin en az 256M, yoğun işlemlerde 512M seviyesinde olması daha sağlıklı çalışır. max_execution_time için 120 veya 300 saniye çoğu orta ölçekli aktarımda yeterlidir. Ancak yalnızca limit artırmak kalıcı çözüm değildir; verimsiz eklentiler veya çok büyük dosyalar aynı hatayı tekrar oluşturabilir.

Gereksiz eklenti yükünü azaltın

Aktarım sırasında bazı eklentiler her ürün kaydında ek işlem yapar. SEO eklentileri meta üretimi, stok bildirim eklentileri tetikleme, önbellek eklentileri sayfa temizleme, entegrasyon eklentileri ise dış servise istek gönderme davranışı gösterebilir. Bu durum aktarımı yavaşlatır ve zaman aşımı riskini artırır.

İşleme başlamadan önce kritik olmayan eklentileri geçici olarak devre dışı bırakmak faydalı olabilir. Ancak ödeme, güvenlik veya lisans kontrolü yapan eklentiler kapatılmadan önce test ortamında denenmelidir. Canlı sitede işlem yapılacaksa düşük trafik saatleri tercih edilmelidir.

Görsel aktarımını ayrı planlayın

Ürün aktarımında en sık gözden kaçan konu görsellerdir. Uzak sunucudaki görseller yavaş yanıt veriyorsa, dosya adlarında özel karakter varsa veya bazı URL’ler 404 hatası veriyorsa içe aktarma süreci ciddi şekilde uzar. Bu nedenle önce yalnızca ürün metinleri, fiyat ve stok alanlarıyla test yapmak daha güvenlidir.

Görselleri mümkünse önceden medya kütüphanesine yükleyin veya hızlı erişilebilen bir kaynakta tutun. Büyük görselleri aktarımdan önce optimize etmek, küçük resim oluşturma süresini azaltır. Çok sayıda görsel varsa işlemi ürün verisinden ayrı bir aşama olarak planlamak daha kontrollü ilerleme sağlar.

Veritabanı performansını ihmal etmeyin

Ürün sayısı arttıkça veritabanı tabloları da büyür. wp_posts, wp_postmeta ve WooCommerce tablolarında gereksiz taslaklar, eski revizyonlar veya geçici kayıtlar birikmişse içe aktarma yavaşlayabilir. Aktarım öncesinde yedek alarak veritabanı temizliği yapmak, sorgu sürelerini iyileştirebilir.

İşlem sırasında yönetim panelinde başka yoğun görevler çalıştırmamak önemlidir. Aynı anda rapor alma, toplu fiyat güncelleme veya indeksleme işlemleri yapılırsa sunucu kaynakları bölünür ve zaman aşımı olasılığı artar.

Test aktarımı ile hatayı önceden yakalayın

Büyük aktarım öncesinde 20-50 ürünlük küçük bir test dosyası hazırlayın. Bu test, sütun eşleşmelerini, kategori yapısını, varyasyon bağlantılarını ve görsel erişimini kontrol etmenizi sağlar. Testte hata alınırsa büyük dosyada işlem yapmak yalnızca sorunu büyütür.

Test aktarımından sonra birkaç ürünü ön yüzde kontrol edin. Fiyat, stok, varyasyon, açıklama ve görsel alanları doğruysa ana aktarıma geçilebilir. Sorun varsa dosya formatını düzeltmek, sunucu ayarı değiştirmekten daha hızlı çözüm sağlayabilir.

CLI ve arka plan işlemlerini değerlendirin

Tarayıcı üzerinden yapılan aktarımlar bağlantı kopması veya panel oturum süresi nedeniyle daha kırılgan olabilir. Teknik ekibiniz varsa WP-CLI, kuyruk sistemi veya arka plan görevleriyle aktarım yapmak daha kararlı sonuç verir. Bu yöntemlerde işlem tarayıcıya bağımlı kalmaz ve hata kayıtları daha net incelenebilir.

Kurumsal kataloglarda aktarım planı hazırlanırken dosya boyutu, ürün adedi, varyasyon yoğunluğu ve görsel hacmi birlikte değerlendirilmelidir. Uygun sunucu kaynağı, temiz veri yapısı ve parçalara bölünmüş aktarım modeli birlikte kullanıldığında zaman aşımı hataları belirgin şekilde azalır; işlem ekibi de hangi aşamada neyi kontrol edeceğini daha net görür.