Node.js原生环境销毁Cookie后重定向报错的解决方法

问题根源 #

你遇到的错误是因为重复发送响应头：先通过res.setHeader设置Set-Cookie，再调用res.writeHead发送状态码和Location头，虽然原生Node.js理论上允许分步骤设置头，但这种写法容易触发头已发送的冲突。另外你的代码还存在逻辑错误：用Object.values(cookies)获取的是Cookie的值而非名称，导致销毁的是固定名称的Cookie，而非实际会话使用的Cookie。

修复方案 #

将所有响应头（包括Set-Cookie和重定向的Location）整合到res.writeHead中一次性发送，同时正确获取并销毁实际的会话Cookie。

修正后的代码 #

function userLogout(cookies, res) {
    // 获取所有会话Cookie的名称（而非值）
    const cookieNames = Object.keys(cookies);
    // 生成每个Cookie的销毁指令：设置max-age=0让浏览器立即删除
    const deleteCookieHeaders = cookieNames.map(name => `${name}=; max-age=0; path=/`);

    // 一次性设置所有响应头并完成重定向
    res.writeHead(301, {
        Location: './index.html',
        'Set-Cookie': deleteCookieHeaders
    }).end();
}

额外说明（如果Cookie是原始字符串） #

如果传入的cookies是未解析的原始Cookie字符串（比如直接从req.headers.cookie获取的），需要先解析成键值对：

// 简易Cookie解析函数
function parseCookies(cookieStr) {
    return cookieStr?.split(';').reduce((acc, cookie) => {
        const [name, value] = cookie.trim().split('=');
        acc[name] = value;
        return acc;
    }, {}) || {};
}

// 使用示例
const cookies = parseCookies(req.headers.cookie);
userLogout(cookies, res);

为什么这样能解决问题 #

1. 避免头重复发送：res.writeHead会一次性发送所有指定的响应头，包括状态码、Location和Set-Cookie，彻底消除"头已发送"的冲突。
2. 正确销毁会话Cookie：通过Object.keys(cookies)获取实际的Cookie名称，确保销毁的是登录时设置的会话Cookie，而非固定名称的无效Cookie。

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