Express.js "Cannot Set Headers After They Are Sent to the Client" Hatası ve Çözümü

Geliştiricilerin karşılaştığı en sinir bozucu hatalardan biri, "Cannot set headers after they are sent to the client" hatasıdır. Eğer sen de Express.js kullanarak backend geliştiren biriysen, bu hata karşına çıkabilir. Peki, bu hata ne anlama geliyor? Neden ortaya çıkıyor ve nasıl çözülür? Hadi, bu yazıda adım adım bu hatanın nedenlerini ve çözüm yollarını keşfedelim.

"Cannot set headers after they are sent to the client" hatası, genellikle bir HTTP cevabını birden fazla kez göndermeye çalıştığınızda ortaya çıkar. Express.js'de, bir response (yanıt) objesinin başlıkları (headers), yanıt gönderilmeden önce ayarlanmalıdır. Yanıt bir kere gönderildiğinde (örneğin `res.send()`, `res.json()` gibi bir yöntemle), bu başlıklar artık değiştirilemez.

Ancak, bazen kodun içinde istemeden birden fazla kez yanıt göndermeye çalışırsınız. Bu da "Cannot set headers after they are sent to the client" hatasını tetikler.

Örneğin, şöyle bir kodu düşün:

app.get('/api', (req, res) => {
    res.send('Hello, world!');
    res.send('This will cause an error');
});

Yukarıdaki kodda, bir istek alındığında ilk olarak "Hello, world!" yanıtı gönderiliyor. Ancak hemen ardından, ikinci bir `res.send()` çağrısı yapılıyor. Bu ikinci çağrı hataya neden olacaktır çünkü bir yanıt zaten gönderildiği için başlıklar bir kez daha gönderilemez.

Bu hatayı önlemek için, yanıtı yalnızca bir kez göndermeye dikkat etmelisiniz. Yanıt gönderildikten sonra başka bir işlem yapmaktan kaçının. Peki, bunu nasıl yapabilirsiniz?

Birinci ve en önemli adım, her yanıt gönderme işleminden sonra kodun başka bir yerde yanıt göndermemesini sağlamaktır. Bunu nasıl kontrol edebilirsiniz? Basit bir örnek üzerinden görelim:

app.get('/api', (req, res) => {
    if (someCondition) {
        res.send('Condition met!');
        return; // return ile işlem sonlandırılır
    }
    res.send('No condition met.');
});

Bu örnekte, `someCondition` doğruysa, ilk `res.send()` çağrısı yapılır ve ardından `return` ile işlem sonlandırılır. Bu şekilde, ikinci bir yanıt gönderilmesi engellenir. Eğer `someCondition` yanlışsa, diğer yanıt gönderilecektir.

Bir başka yaygın senaryo, asenkron işlemlerde meydana gelir. Asenkron bir fonksiyon çalıştırıyorsanız ve yanıtı göndermeden önce işlemin bitmesini beklemeniz gerektiğini unutabilirsiniz.

Örneğin:

app.get('/api', async (req, res) => {
    setTimeout(() => {
        res.send('This should be the last response!');
    }, 1000);
    res.send('This will cause an error');
});

Yukarıdaki kodda, `res.send()` işlemleri sırasıyla yapılır. İlk `res.send()` hemen çalıştırılırken, `setTimeout` içinde bekleyen ikinci `res.send()` bir süre sonra çalıştırılır. Ancak bu işlemde, ilk `res.send()` yanıtı gönderildikten sonra başka bir `res.send()` çağrısı yapılacağı için hata alırsınız.

Bu sorunu çözmek için asenkron işlemleri doğru şekilde yönetmek gerekir. Örneğin:

app.get('/api', async (req, res) => {
    await new Promise(resolve => setTimeout(resolve, 1000));
    res.send('This should be the last response!');
});

Bu şekilde, ikinci `res.send()` çağrısı yalnızca ilk işlem tamamlandıktan sonra yapılır. Asenkron işlemlerin yönetimi, hataların önlenmesine yardımcı olur.

1. Bir Yanıt Gönderildikten Sonra Diğer Yanıtı Göndermeyin: `res.send()` veya `res.json()` çağrısını yalnızca bir kez kullanmaya özen gösterin.
2. Asenkron İşlemleri İyi Yönetin: Asenkron işleme tabi olan kodlarınızda, yanıt gönderme işlemlerini doğru sırayla yapmalısınız.
3. `return` Anahtar Kelimesini Kullanın: Yanıt gönderildikten sonra fonksiyonu sonlandırmak için `return` kullanın.
4. Hataları Kontrol Edin: Hata durumunda bile, bir yanıt göndermeyi engellemek için kontrol yapmayı unutmayın.

###