res.write与res.send联用报错原因及替代方案咨询

为什么res.write()后调用res.send()会报错？ #

当你调用res.write("Hello")时，如果响应头还未发送，Express会自动发送默认响应头（如Content-Type: text/plain），随后把"Hello"作为响应体的一部分发送给客户端。

而res.send()的工作流程是：

1. 检查响应头是否已发送，若未发送则根据数据自动设置Content-Type（比如发送对象时设为application/json）、状态码等头信息；
2. 将数据转换为合适格式（如JSON序列化）；
3. 发送响应体并调用res.end()结束请求。

但在你先调用res.write()的场景下，响应头已经被发送，res.send()再尝试修改头信息时，就会触发ERR_HTTP_HEADERS_SENT错误——HTTP协议要求响应头必须在响应体之前发送，一旦响应体开始传输，就无法再修改头信息。

res.send()和res.write()+res.end()的差异 #

网上说res.send()等效于res.write()+res.end()是不完全准确的：

• res.write()+res.end()仅单纯发送响应体并结束请求，不会自动处理头信息（除非手动设置）；
• res.send()包含头信息自动处理、数据格式转换、状态码设置等额外逻辑，这些逻辑必须在响应头发送前完成。

替代res.write()的方案 #

如果你想分步积累响应内容，同时保留res.send()的自动功能，可以用以下几种方式：

1. 用res.locals存储基础内容 #

在中间件中把基础数据存在res.locals（Express专门用于传递请求级数据的对象），路由中拼接后统一用res.send()发送：

app.use((req, res, next) => {
  res.locals.baseContent = "Base data";
  next();
})

app.get("/", (req, res) => {
  const fullContent = res.locals.baseContent + "Route specific data";
  res.send(fullContent);
})

2. 自定义响应内容积累方法 #

扩展res对象，添加用于积累内容的数组和方法，最后统一发送：

app.use((req, res, next) => {
  res.contentFragments = [];
  res.appendContent = (content) => {
    res.contentFragments.push(content);
  };
  next();
})

app.use((req, res, next) => {
  res.appendContent("Base data");
  next();
})

app.get("/", (req, res) => {
  res.appendContent("Route specific data");
  res.send(res.contentFragments.join(""));
})

3. 使用模板引擎（适合HTML场景） #

如果是构建HTML响应，可以用EJS、Pug等模板引擎，把基础内容做成布局文件，路由中渲染具体内容时继承布局：
比如EJS布局文件views/layouts/base.ejs：

<!DOCTYPE html>
<html>
<head>
  <title><%= title %></title>
</head>
<body>
  <div class="base-content">Base data</div>
  <%- body %>
</body>
</html>

路由中渲染：

app.set("view engine", "ejs");
app.set("views", "./views");

app.get("/", (req, res) => {
  res.render("index", {
    title: "Home",
    body: "<div>Route specific data</div>"
  });
})

这种方式既实现了内容拆分，又通过res.render()自动处理Content-Type等头信息。

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