无法定位「Cannot remove headers after they are sent to the client」错误原因

错误根源 #

「Cannot remove headers after they are sent」错误是因为重复发送HTTP响应：

• 当service2执行出错进入catch分支时，已经通过res.status(403).send('Error')发送了一次响应，但主路由的代码仍会继续执行res.status(200).send('Thank you')，尝试第二次发送响应。HTTP协议要求每个请求只能有一次响应，第二次发送时会因试图修改已发送的响应头而报错。
• 代码中使用两个独立if分支，虽然参数service不会同时匹配两个分支，但结构不够严谨，也可能埋下逻辑重叠的隐患。

修复方案 #

方案一：终止主路由的后续执行（适合保留service内的响应发送） #

修改主路由代码，在调用service后添加return，阻止后续的res.send执行：

app.get('/category/:service', auth, async (req, res, next) => {
    if (req.params.service === 'service1') {
        await service1(req, res, next);
        return; // 阻止后续代码执行
    }
    if (req.params.service === 'service2') {
        await service2(req, res, next);
        return; // 阻止后续代码执行
    }
    // 仅当无匹配service时发送默认响应
    res.status(200).send('Thank you'); 
});

这样，无论service2是成功调用next()还是出错发送响应，主路由都不会再重复发送响应。

方案二：用错误中间件统一处理异常（更符合Express最佳实践） #

1. 修改service2，不直接在catch里发送响应，而是将错误传递给Express的错误处理中间件：

export const service2 = async (req, res, next) => {
    try {
        const example = await googleapi.create();
        next();
    } catch (err) {
        console.error('Error:', err);
        next(err); // 传递错误到错误中间件
    }
};

2. 主路由改用else if优化分支逻辑：

app.get('/category/:service', auth, async (req, res, next) => {
    if (req.params.service === 'service1') {
        await service1(req, res, next);
    } else if (req.params.service === 'service2') {
        await service2(req, res, next);
    }
    res.status(200).send('Thank you'); 
});

3. 添加全局错误处理中间件（放在所有路由之后）：

app.use((err, req, res, next) => {
    res.status(403).send('Error');
});

这种方式让错误处理更集中，避免在业务代码里重复编写响应逻辑，也彻底杜绝了重复发送响应的问题。

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