NodeJS重定向报错Cannot set headers after they are sent问题

这个报错的核心原因是同一次HTTP请求中多次向客户端发送响应：Express在第一次把响应头发送到客户端后，请求响应流程就已经结束，后续再调用res.send/res.redirect/res.write/res.sendFile等响应方法，就会触发这个报错。

• 路由逻辑第一行就执行了res.sendFile(path.join(__dirname + '/public/html/index.html'))，这行代码会立刻把首页文件返回给客户端、结束响应，但你后续的数据库查询、重定向逻辑都是异步执行的，等数据库操作完成要执行重定向时，响应早就发出去了，必然报错。你提到IF分支偶尔能正常执行，只是因为嵌套了一层插入操作的异步延迟，碰巧在响应头完全发送前触发了跳转，属于偶现的正常，本质逻辑是错的。
• IF分支逻辑顺序错误：你在插入用户数据的数据库异步回调里写了res.write(...)，但回调外部立刻就执行了res.redirect('/succes')，等于插入操作还没执行完成就先触发跳转，后续插入完成后又要执行res.write，会触发第二次响应报错。
• 路径拼写错误：成功页重定向路径/succes少写了一个s，和常规的/success路径不匹配，就算不报错也会跳404。

调整逻辑执行顺序，确保一次请求只会触发一个响应操作：

1. 不要一进路由就返回首页，先判断请求是否带了email参数，没带参数再返回首页
2. 所有响应操作（重定向、返回内容）都放到数据库异步操作的回调里执行，不要在异步操作外层提前写响应逻辑
3. 数据库操作要做错误兜底，不要直接throw err导致进程崩溃
4. 所有响应语句前加return强制终止后续逻辑执行，避免漏判导致多次响应

修复后的代码参考：

const express = require('express');
const path = require('path');
const app = express();
const router = express.Router();

// 静态资源托管保持原有逻辑，修正路径拼接写法
app.use(express.static(path.join(__dirname, 'public')));

router.get('/', function(req, res) {
    const email = req.query.email;
    // 没有传email参数时才返回首页，不提前发送响应
    if (!email) {
        return res.sendFile(path.join(__dirname, 'public/html/index.html'));
    }

    conn.query("SELECT * FROM users WHERE email = ?", [email], function(err, result) {
        if (err) {
            console.error('查询用户失败:', err);
            return res.redirect('/error');
        }
        const resultLength = result.length;
        if (resultLength === 0) {
            // 插入操作完成后再执行响应，不要在回调外提前写跳转
            conn.query('INSERT INTO users (email) VALUES (?)', [email], function(insertErr, insertResult) {
                if (insertErr) {
                    console.error('插入用户失败:', insertErr);
                    return res.redirect('/error');
                }
                console.log('1 record inserted');
                // 注意：返回文案和重定向二选一，不要两个都写
                // res.end('<p>You are now subscribed to our newsletter!</p>');
                return res.redirect('/success'); // 修正路径拼写错误
            })
        } else {
            console.log("You are already subscribed to our newsletter!")
            return res.redirect('/error');
        }
    })
});

app.use('/', router);
app.listen(3000);

内容的提问来源于stack exchange，提问作者Daniel Dinca