Express.js "Cannot set headers after they are sent to the client" Hatası ile Baş Etmek

Bir web uygulaması geliştiricisiyseniz, muhtemelen Express.js ile çalışırken karşılaştığınız "Cannot set headers after they are sent to the client" hatasıyla başınız dertte olmuştur. Bu hata, özellikle asenkron işlemlerle uğraşırken sıklıkla karşımıza çıkar ve başta korkutucu olabilir. Ama korkmayın! Bu yazıda, hatayı anlamanızı sağlayacak, nasıl ortaya çıktığını keşfedecek ve sonunda nasıl çözüleceğini göstereceğim. Hadi, bu hatanın ardındaki sırrı birlikte çözelim.

Express.js, gelen istekleri işlerken yanıtı (response) döndürmeden önce bazı başlıklar (headers) ayarlamanıza olanak tanır. Ancak, her istek için sadece bir kere yanıt gönderilebilir. Eğer yanıtı birden fazla kez göndermeye çalışırsanız, Express.js size "Cannot set headers after they are sent to the client" hatasını verir.

Bu hatanın en yaygın sebeplerinden biri, asenkron kod yazarken bir yanıtı birden fazla defa göndermeye çalışmanızdır. Örneğin, bir route handler’ında hem `res.send()` hem de `res.json()` gibi yöntemleri kullanmaya çalışırsanız, Express.js bir kere yanıtı gönderdikten sonra bir başlık değişikliği yapmak isterken bu hatayı fırlatır.

Diyelim ki, aşağıdaki gibi bir Express.js uygulamanız var:

app.get('/test', (req, res) => {
  res.send('İlk Yanıt'); // İlk yanıt gönderildi
  res.send('İkinci Yanıt'); // Bu satır hata verecek
});

Bu örnekte, ilk `res.send()` çağrısı yanıtı gönderecektir. Fakat ikinci `res.send()` çağrısı yapılmaya çalışıldığında, Express.js bu hatayı verecektir: "Cannot set headers after they are sent to the client."

Şimdi, hatayı çözmek için doğru yaklaşımı inceleyelim. Yapmamız gereken, yanıtı yalnızca bir kez göndermemizdir. Bunu sağlamak için, yanıt gönderme işleminden önce her şeyin düzgün şekilde tamamlandığından emin olmamız gerekiyor.

İşte doğru çözüm:

app.get('/test', (req, res) => {
  if (someCondition) {
    res.send('İlk Yanıt');
  } else {
    res.send('İkinci Yanıt');
  }
});

Burada, `someCondition` koşuluna göre sadece bir yanıt gönderildiği için hata oluşmaz.

Birçok zaman bu hata, asenkron işlevlerden dolayı ortaya çıkar. Örneğin, veritabanı sorguları veya dış API çağrıları gibi zaman alan işlemlerden sonra yanıt gönderilmeye çalışıldığında bu hata sıkça görülür. Aşağıdaki gibi bir örnek hayal edin:

app.get('/async-test', async (req, res) => {
  await someAsyncOperation();
  res.send('Veri alındı');
  await someOtherAsyncOperation(); // Hata verecek
  res.send('İkinci Yanıt'); // Bu satır da hata verecek
});

Asenkron işlemde bir şeyler ters giderse veya birden fazla `res.send()` çağrısı yapılırsa, aynı hatayı alırsınız. Bunu önlemek için, tüm asenkron işlemleri düzgün şekilde sıralamanız gerekecek. Şu şekilde düzeltebilirsiniz:

app.get('/async-test', async (req, res) => {
  await someAsyncOperation();
  res.send('Veri alındı'); // Yanıt burada gönderiliyor
});

Burada, yanıtı yalnızca asenkron işlem tamamlandıktan sonra bir kere gönderdik.

1. Yanıtı Kontrol Edin: Hangi noktada yanıt gönderildiğine dikkat edin. Herhangi bir koşul altında yanıtı birden fazla kez göndermemeye özen gösterin.
2. Asenkron İşlemleri Düzgün Yönetmek: `await` veya `.then()` kullanarak asenkron işlemleri sıraladığınızdan emin olun. Bu, yanıtın zamanında ve yalnızca bir kez gönderilmesini sağlar.
3. Hata Durumlarını Ele Alın: Eğer bir hata durumunda yanıt göndermeniz gerekiyorsa, hata mesajı ve yanıtı düzgün bir şekilde yapılandırmak için `res.status(500).send()` gibi yöntemleri kullanabilirsiniz.

"Cannot set headers after they are sent to the client" hatası, birden fazla yanıt gönderilmek istendiğinde karşılaşılan yaygın bir hata türüdür. Bu hatayı çözmek için yanıt gönderme işlemlerini dikkatlice kontrol etmelisiniz. Özellikle asenkron kodlarda, işlemler sırasına dikkat ederek yalnızca bir kez yanıt göndermeniz gerekecek. Artık bu hatayı gördüğünüzde ne yapmanız gerektiğini biliyorsunuz. Unutmayın, her şey sırasıyla ve doğru bir şekilde!