响应状态码|HTTP协议篇

• 状态码在响应报文里表示了服务器对请求的处理结果；
• 状态码后的原因短语是简单的文字描述，可以自定义；
• 状态码是十进制的三位数，分为五类，从 100 到 599；
• 2××类状态码表示成功，常用的有 200、204、206；
• 3××类状态码表示重定向，常用的有 301、302、304；
• 4××类状态码表示客户端错误，常用的有 400、403、404；
• 5××类状态码表示服务器错误，常用的有 500、501、502、503

原理拆解： 状态码位于响应起始行，是服务器对本次 HTTP 处理结果的协议级分类。1xx 表示中间状态，2xx 表示请求已成功处理，3xx 涉及后续定位或缓存复用，4xx 表示当前请求存在客户端侧问题，5xx 表示服务器未能正常完成处理。客户端应以数字状态码及响应语义为准，不能依赖可被修改、甚至在 HTTP/2 和 HTTP/3 中不再以传统原因短语形式传输的说明文字。

最小验证： 输入四个本地路径，验证客户端能够收到 200、204、404 和 500，同时观察 204 没有响应体。以下 JavaScript 可直接由 Node.js 运行。

const http = require('node:http');

const server = http.createServer((req, res) => {
  if (req.url === '/ok') {
    res.writeHead(200, { 'Content-Type': 'text/plain' });
    res.end('saved');
  } else if (req.url === '/empty') {
    res.writeHead(204);
    res.end();
  } else if (req.url === '/error') {
    res.writeHead(500, { 'Content-Type': 'text/plain' });
    res.end('internal error');
  } else {
    res.writeHead(404, { 'Content-Type': 'text/plain' });
    res.end('not found');
  }
});

server.listen(0, async () => {
  const { port } = server.address();
  for (const path of ['/ok', '/empty', '/missing', '/error']) {
    const response = await fetch(`http://127.0.0.1:${port}${path}`);
    console.log(path, response.status, JSON.stringify(await response.text()));
  }
  server.close();
});

关键行是 writeHead，它确定响应状态；预期依次打印 200 "saved"、204 ""、404 "not found" 和 500 "internal error"。fetch 对 404、500 不会自动抛出异常，调用方必须检查 response.ok 或 response.status。

边界与排查： 204 成功但不携带正文，206 只表示部分内容；304 主要用于条件请求的缓存复用，不应简单理解为页面跳转。401、403 和 404 的含义也不同，分别偏向认证、拒绝访问和资源不存在。业务接口即使返回 200，正文仍可能表达业务失败，因此协议状态与业务状态需要分层判断；排查时应同时核对状态码、响应头、正文及重定向链。