Express.js中调用res.status()后如何终止后续代码执行？

你遇到的ERR_HTTP_HEADERS_SENT错误，核心原因是调用checkPostExists后，不管验证是否通过，路由里的res.json()都会继续执行——res.status().json()只是向客户端发送了一次响应，但不会终止整个路由处理函数的流程，导致重复发送响应，触发错误。

下面是几种正确的实现方式：

方式一：改用Express中间件（推荐） #

Express的中间件机制天生适合这种前置验证场景，通过next()控制流程是否继续：

function checkPostExists(req, res, next) {
    const post = posts.find((post) => post.id === parseInt(req.params.id));

    if (!post) {
        return res.status(404).json({
            msg: `No post with the id of ${req.params.id}`,
        });
    }
    // 验证通过，调用next()让后续逻辑执行
    next();
}

// 将checkPostExists作为路由的第一个中间件
router.get("/:id", checkPostExists, (req, res) => {
    res.json(posts.filter((post) => post.id === parseInt(req.params.id)));
});

原理：当验证不通过时，直接返回响应且不调用next()，后续的路由处理函数就不会执行；验证通过时调用next()，流程才会进入下一个处理环节。

方式二：让验证函数返回状态标识，在路由中判断 #

修改checkPostExists返回布尔值，在路由处理函数中根据返回结果决定是否终止流程：

function checkPostExists(req, res) {
    const post = posts.find((post) => post.id === parseInt(req.params.id));

    if (!post) {
        res.status(404).json({
            msg: `No post with the id of ${req.params.id}`,
        });
        return false; // 验证失败，返回false
    }
    return true; // 验证成功，返回true
}

router.get("/:id", (req, res) => {
    const isPostExist = checkPostExists(req, res);
    if (!isPostExist) return; // 验证失败，直接终止后续代码执行

    res.json(posts.filter((post) => post.id === parseInt(req.params.id)));
});

方式三：异步场景下用Promise控制（如果涉及数据库等异步操作） #

如果你的验证逻辑是异步的（比如查询数据库），可以用Promise配合async/await来控制流程：

function checkPostExists(req, res) {
    return new Promise((resolve, reject) => {
        // 模拟异步数据库查询
        setTimeout(() => {
            const post = posts.find((post) => post.id === parseInt(req.params.id));
            if (!post) {
                res.status(404).json({
                    msg: `No post with the id of ${req.params.id}`,
                });
                reject();
            } else {
                resolve();
            }
        }, 100);
    });
}

router.get("/:id", async (req, res) => {
    try {
        await checkPostExists(req, res);
    } catch {
        return; // 验证失败，终止流程
    }

    res.json(posts.filter((post) => post.id === parseInt(req.params.id)));
});

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