Express应用报错Cannot set headers after they are sent to the client排查

这个错误的核心是同一个HTTP请求被多次发送响应——Node.js/Express规定每个请求只能输出一次响应头和响应体，重复调用res.send()/res.json()这类方法就会触发「Cannot set headers after they are sent to the client」。

结合你用Prisma事务的场景，问题出在事务的异步流程控制上，具体可能的情况：

• 事务内部发送响应后未终止流程：当userExists为true时，你在Prisma事务的回调函数里发送了一次响应（比如200），但没有立即通过return终止整个事务回调和后续的请求处理逻辑。事务会继续执行剩余的异步操作，当事务完成后，代码走到事务外部的另一个响应发送分支（比如500），导致两次响应。

  举个典型的错误代码示例：

  async function STORE_USER(req, res) {
    const userExists = true;
    try {
      await prisma.$transaction(async (tx) => {
        if (userExists) {
          res.status(200).json({ msg: "用户已存在" });
          // 这里没有return，事务继续执行后续逻辑
        }
        // 其他事务操作
      });
      // 事务完成后，错误地再次发送响应
      res.status(500).json({ msg: "操作失败" });
    } catch (err) {
      res.status(500).json({ msg: err.message });
    }
  }
  

• 事务错误处理与外部处理重复发送响应：如果在事务内部检测到userExists为true时发送了响应，同时后续事务操作抛出错误，外部的catch块又再次发送500响应，也会触发该错误。而移除事务后，你的代码可能避免了这种双重响应的分支（比如同步逻辑下发送响应后直接return，不会走到错误处理分支）。

Prisma事务的异步回调会包裹整个事务生命周期，如果你在回调内发送响应但未终止流程，事务的后续异步步骤（提交/回滚）完成后，代码会继续执行回调外的逻辑，从而导致重复响应。而没有事务时，代码的执行路径更线性，发送响应后就能终止后续逻辑，不会触发重复发送。

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