Express.js “Cannot set headers after they are sent to the client” Hatası: Neden Olur ve Nasıl Çözülür?

Express.js ile çalışırken karşınıza çıkabilecek en yaygın ve sinir bozucu hatalardan biri de “Cannot set headers after they are sent to the client” hatasıdır. Eğer bir web uygulaması geliştiriyorsanız, bu hatayı büyük ihtimalle bir noktada görmüşsünüzdür. Peki, bu hata ne anlama geliyor? Neden meydana gelir ve nasıl çözülür?

Her HTTP isteği, bir "request" ve "response" sürecinden geçer. Bu süreçte sunucu, istemciye bir yanıt göndermeye karar verir ve yanıtın başlıkları (headers) ile içerikleri (body) belirlenir.

Bu hatanın nedeni, yanıt başlıklarını (headers) istemciye göndermenin ardından tekrar bir başlık değiştirme işlemi yapmaya çalışmaktır. Eğer bir yanıtı bir kez göndermişseniz ve sonrasında başka başlıklar eklemeye çalışırsanız, Express.js size “Cannot set headers after they are sent to the client” şeklinde bir hata verir.

Bunun nedeni, yanıtı iki kez göndermeye çalışmanız olabilir. Peki, bunu nasıl çözeceksiniz?

1. Çift Yanıt Gönderme (Double Response)
Bir endpoint içerisinde hem `res.send()` hem de `res.json()` gibi yanıt metotlarını ardışık olarak çağırmak bu hataya yol açabilir.

2. Asenkron Kod ve Yanıt Zamanlaması
Eğer asenkron bir işlem sonrasında yanıt gönderiyorsanız, bu işlem tamamlanmadan önce bir yanıt göndermeye çalışmak da bu hatayı tetikleyebilir.

2. Asenkron işlemleri düzgün yönetin.
Asenkron işlemler yapıyorsanız, `await` ve `async` kullanarak işlemlerin sırasını düzgün bir şekilde kontrol edin. Böylece her şeyin sırası doğru olacak ve yanıtınızı yalnızca bir kez göndereceksiniz.

Örnek olarak:

kopyala
app.get('/test', async (req, res) => {
  try {
    // Asenkron bir işlem yapıyoruz
    const result = await someAsyncFunction();

    // Yanıtı bir kez gönderiyoruz
    res.json({ message: result });
  } catch (error) {
    // Hata durumunda yanıtı bir kez gönderiyoruz
    res.status(500).json({ error: 'Bir hata oluştu' });
  }
});
JavaScript

kopyala
app.get('/data', (req, res) => {
  if (someCondition) {
    res.status(400).send('Geçersiz işlem');
    return;  // Başka bir işlem yapılmasını engelliyoruz
  }

  res.json({ data: 'Başka veriler' });
});
JavaScript

Bu gibi çözümler, yalnızca bir yanıt gönderilmesini sağlayarak hatayı engelleyecektir.

Unutmayın, hata mesajları bize çoğu zaman nereye dikkat etmemiz gerektiğini gösterir. Bu yüzden hata mesajını dikkatlice okuyun ve çözümü bulmak için bir adım geriye çekilip kodunuzu gözden geçirin. Sorunları çözmek, geliştirme sürecinin keyifli bir parçasıdır!